From b66a840396083ea7338a9e1f752df89991b4b837 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Bot Date: Sat, 6 Aug 2022 07:15:03 +0000 Subject: [PATCH] feat(all): auto-regenerate discovery clients --- artifactregistry/v1/artifactregistry-api.json | 4 +- artifactregistry/v1/artifactregistry-gen.go | 22 +- .../v1beta1/artifactregistry-api.json | 4 +- .../v1beta1/artifactregistry-gen.go | 22 +- .../v1beta2/artifactregistry-api.json | 4 +- .../v1beta2/artifactregistry-gen.go | 22 +- drivelabels/v2/drivelabels-api.json | 234 +++++----- drivelabels/v2/drivelabels-gen.go | 414 +++++++++-------- drivelabels/v2beta/drivelabels-api.json | 246 +++++----- drivelabels/v2beta/drivelabels-gen.go | 439 +++++++++--------- 10 files changed, 713 insertions(+), 698 deletions(-) diff --git a/artifactregistry/v1/artifactregistry-api.json b/artifactregistry/v1/artifactregistry-api.json index 1c667605339..a534800086f 100644 --- a/artifactregistry/v1/artifactregistry-api.json +++ b/artifactregistry/v1/artifactregistry-api.json @@ -1408,7 +1408,7 @@ } } }, - "revision": "20220621", + "revision": "20220803", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { @@ -1482,7 +1482,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, diff --git a/artifactregistry/v1/artifactregistry-gen.go b/artifactregistry/v1/artifactregistry-gen.go index bd3fbc18ab9..8636f300482 100644 --- a/artifactregistry/v1/artifactregistry-gen.go +++ b/artifactregistry/v1/artifactregistry-gen.go @@ -414,16 +414,20 @@ type Binding struct { // who is authenticated with a Google account or a service account. * // `user:{emailid}`: An email address that represents a specific Google // account. For example, `alice@example.com` . * - // `serviceAccount:{emailid}`: An email address that represents a + // `serviceAccount:{emailid}`: An email address that represents a Google // service account. For example, - // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An - // email address that represents a Google group. For example, - // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An - // email address (plus unique identifier) representing a user that has - // been recently deleted. For example, - // `alice@example.com?uid=123456789012345678901`. If the user is - // recovered, this value reverts to `user:{emailid}` and the recovered - // user retains the role in the binding. * + // `my-other-app@appspot.gserviceaccount.com`. * + // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: + // An identifier for a Kubernetes service account + // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + // * `group:{emailid}`: An email address that represents a Google group. + // For example, `admins@example.com`. * + // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus + // unique identifier) representing a user that has been recently + // deleted. For example, `alice@example.com?uid=123456789012345678901`. + // If the user is recovered, this value reverts to `user:{emailid}` and + // the recovered user retains the role in the binding. * // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address // (plus unique identifier) representing a service account that has been // recently deleted. For example, diff --git a/artifactregistry/v1beta1/artifactregistry-api.json b/artifactregistry/v1beta1/artifactregistry-api.json index 5a9de5ca518..cd4f1e9b0ae 100644 --- a/artifactregistry/v1beta1/artifactregistry-api.json +++ b/artifactregistry/v1beta1/artifactregistry-api.json @@ -929,7 +929,7 @@ } } }, - "revision": "20220506", + "revision": "20220803", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "Binding": { @@ -941,7 +941,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, diff --git a/artifactregistry/v1beta1/artifactregistry-gen.go b/artifactregistry/v1beta1/artifactregistry-gen.go index 6a6d2863da7..da879a7dac4 100644 --- a/artifactregistry/v1beta1/artifactregistry-gen.go +++ b/artifactregistry/v1beta1/artifactregistry-gen.go @@ -259,16 +259,20 @@ type Binding struct { // who is authenticated with a Google account or a service account. * // `user:{emailid}`: An email address that represents a specific Google // account. For example, `alice@example.com` . * - // `serviceAccount:{emailid}`: An email address that represents a + // `serviceAccount:{emailid}`: An email address that represents a Google // service account. For example, - // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An - // email address that represents a Google group. For example, - // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An - // email address (plus unique identifier) representing a user that has - // been recently deleted. For example, - // `alice@example.com?uid=123456789012345678901`. If the user is - // recovered, this value reverts to `user:{emailid}` and the recovered - // user retains the role in the binding. * + // `my-other-app@appspot.gserviceaccount.com`. * + // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: + // An identifier for a Kubernetes service account + // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + // * `group:{emailid}`: An email address that represents a Google group. + // For example, `admins@example.com`. * + // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus + // unique identifier) representing a user that has been recently + // deleted. For example, `alice@example.com?uid=123456789012345678901`. + // If the user is recovered, this value reverts to `user:{emailid}` and + // the recovered user retains the role in the binding. * // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address // (plus unique identifier) representing a service account that has been // recently deleted. For example, diff --git a/artifactregistry/v1beta2/artifactregistry-api.json b/artifactregistry/v1beta2/artifactregistry-api.json index 139b153d9dd..cff0b746919 100644 --- a/artifactregistry/v1beta2/artifactregistry-api.json +++ b/artifactregistry/v1beta2/artifactregistry-api.json @@ -1135,7 +1135,7 @@ } } }, - "revision": "20220506", + "revision": "20220803", "rootUrl": "https://artifactregistry.googleapis.com/", "schemas": { "AptArtifact": { @@ -1195,7 +1195,7 @@ "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." }, "members": { - "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. ", "items": { "type": "string" }, diff --git a/artifactregistry/v1beta2/artifactregistry-gen.go b/artifactregistry/v1beta2/artifactregistry-gen.go index b2876959bc5..238631533e1 100644 --- a/artifactregistry/v1beta2/artifactregistry-gen.go +++ b/artifactregistry/v1beta2/artifactregistry-gen.go @@ -336,16 +336,20 @@ type Binding struct { // who is authenticated with a Google account or a service account. * // `user:{emailid}`: An email address that represents a specific Google // account. For example, `alice@example.com` . * - // `serviceAccount:{emailid}`: An email address that represents a + // `serviceAccount:{emailid}`: An email address that represents a Google // service account. For example, - // `my-other-app@appspot.gserviceaccount.com`. * `group:{emailid}`: An - // email address that represents a Google group. For example, - // `admins@example.com`. * `deleted:user:{emailid}?uid={uniqueid}`: An - // email address (plus unique identifier) representing a user that has - // been recently deleted. For example, - // `alice@example.com?uid=123456789012345678901`. If the user is - // recovered, this value reverts to `user:{emailid}` and the recovered - // user retains the role in the binding. * + // `my-other-app@appspot.gserviceaccount.com`. * + // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: + // An identifier for a Kubernetes service account + // (https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. + // * `group:{emailid}`: An email address that represents a Google group. + // For example, `admins@example.com`. * + // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus + // unique identifier) representing a user that has been recently + // deleted. For example, `alice@example.com?uid=123456789012345678901`. + // If the user is recovered, this value reverts to `user:{emailid}` and + // the recovered user retains the role in the binding. * // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address // (plus unique identifier) representing a service account that has been // recently deleted. For example, diff --git a/drivelabels/v2/drivelabels-api.json b/drivelabels/v2/drivelabels-api.json index ce628a5cde8..8b76cdc5bfb 100644 --- a/drivelabels/v2/drivelabels-api.json +++ b/drivelabels/v2/drivelabels-api.json @@ -99,7 +99,7 @@ "labels": { "methods": { "get": { - "description": "Get a Label by its resource name. Resource name may be any of: * `labels/{id}` - See to `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the Label. * `labels/{id}@published` - Gets the current published revision of the Label. * `labels/{id}@{revision_id}` - Gets the Label at the specified revision ID.", + "description": "Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.", "flatPath": "v2/labels/{labelsId}", "httpMethod": "GET", "id": "drivelabels.labels.get", @@ -108,7 +108,7 @@ ], "parameters": { "languageCode": { - "description": "The BCP-47 language code to use for evaluating localized Field labels. When not specified, values in the default configured language will be used.", + "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", "location": "query", "type": "string" }, @@ -120,12 +120,12 @@ "type": "string" }, "useAdminAccess": { - "description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.", + "description": "Set to `true` in order to use the user's admin credentials. The server verifies that the user is an admin for the label before allowing access.", "location": "query", "type": "boolean" }, "view": { - "description": "When specified, only certain Fields belonging to the indicated view will be returned.", + "description": "When specified, only certain fields belonging to the indicated view are returned.", "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" @@ -144,14 +144,14 @@ } }, "list": { - "description": "-------------------------------------------------------------------------- ## Label APIs --------------------------------------------------------------- List Labels.", + "description": "List labels.", "flatPath": "v2/labels", "httpMethod": "GET", "id": "drivelabels.labels.list", "parameterOrder": [], "parameters": { "languageCode": { - "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.", + "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", "location": "query", "type": "string" }, @@ -166,16 +166,16 @@ ], "enumDescriptions": [ "Unknown role.", - "A reader can read the Label and associated metadata applied to Drive items.", + "A reader can read the label and associated metadata applied to Drive items.", "An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`.", - "An organizer is allowed to pin this label in shared drives they manage and add new appliers to the label.", - "Editors may make any updates including deleting the Label which will also delete associated Drive item metadata. Implies `APPLIER`." + "An organizer can pin this label in shared drives they manage and add new appliers to the label.", + "Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`." ], "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of Labels to return per page. Default: 50. Max: 200.", + "description": "Maximum number of labels to return per page. Default: 50. Max: 200.", "format": "int32", "location": "query", "type": "integer" @@ -186,7 +186,7 @@ "type": "string" }, "publishedOnly": { - "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions will be returned. Disabled labels will be included. Returned Label resource names will reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions will be returned, which may not by published. Returned Label resource names will not reference a specific revision (`labels/{id}`).", + "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (`labels/{id}`).", "location": "query", "type": "boolean" }, @@ -196,7 +196,7 @@ "type": "boolean" }, "view": { - "description": "When specified, only certain fields belonging to the indicated view will be returned.", + "description": "When specified, only certain fields belonging to the indicated view are returned.", "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" @@ -217,26 +217,26 @@ } } }, - "revision": "20220721", + "revision": "20220802", "rootUrl": "https://drivelabels.googleapis.com/", "schemas": { "GoogleAppsDriveLabelsV2BadgeColors": { - "description": "The color derived from BadgeConfig and coerced to the nearest supported color.", + "description": "The color derived from BadgeConfig and changed to the closest recommended supported color.", "id": "GoogleAppsDriveLabelsV2BadgeColors", "properties": { "backgroundColor": { "$ref": "GoogleTypeColor", - "description": "Output only. Badge background which pairs with the foreground", + "description": "Output only. Badge background that pairs with the foreground.", "readOnly": true }, "foregroundColor": { "$ref": "GoogleTypeColor", - "description": "Output only. Badge foreground which pairs with the background", + "description": "Output only. Badge foreground that pairs with the background.", "readOnly": true }, "soloColor": { "$ref": "GoogleTypeColor", - "description": "Output only. Color that can be used for text without a background", + "description": "Output only. Color that can be used for text without a background.", "readOnly": true } }, @@ -248,10 +248,10 @@ "properties": { "color": { "$ref": "GoogleTypeColor", - "description": "The color of the badge. When not specified, no badge will be rendered. This color will be coerced into the closest recommended supported color." + "description": "The color of the badge. When not specified, no badge is rendered. The background, foreground, and solo (light and dark mode) colors set here are changed in the Drive UI into the closest recommended supported color." }, "priorityOverride": { - "description": "Override the default global priority of this badge. When set to 0, the default priority heuristic will be used.", + "description": "Override the default global priority of this badge. When set to 0, the default priority heuristic is used.", "format": "int64", "type": "string" } @@ -259,12 +259,12 @@ "type": "object" }, "GoogleAppsDriveLabelsV2Field": { - "description": "Defines a field which has a display name, data type, and other configuration options. This field defines the kind of metadata that may be set on a Drive item.", + "description": "Defines a field that has a display name, data type, and other configuration options. This field defines the kind of metadata that may be set on a Drive item.", "id": "GoogleAppsDriveLabelsV2Field", "properties": { "appliedCapabilities": { "$ref": "GoogleAppsDriveLabelsV2FieldAppliedCapabilities", - "description": "Output only. The capabilities this user has on this Field and its value when the Label is applied on Drive items.", + "description": "Output only. The capabilities this user has on this field and its value when the label is applied on Drive items.", "readOnly": true }, "createTime": { @@ -295,11 +295,11 @@ }, "displayHints": { "$ref": "GoogleAppsDriveLabelsV2FieldDisplayHints", - "description": "Output only. UI Display hints for rendering a Field.", + "description": "Output only. UI display hints for rendering a field.", "readOnly": true }, "id": { - "description": "Output only. The key of a field, unique within a Label or Library. This value is autogenerated, and will match the form `([a-zA-Z0-9_])+", + "description": "Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`", "readOnly": true, "type": "string" }, @@ -309,7 +309,7 @@ }, "lifecycle": { "$ref": "GoogleAppsDriveLabelsV2Lifecycle", - "description": "Output only. The lifecycle of this Field.", + "description": "Output only. The lifecycle of this field.", "readOnly": true }, "lockStatus": { @@ -327,13 +327,13 @@ "readOnly": true }, "queryKey": { - "description": "Output only. The key to use when constructing Drive search queries to find files based on values defined for this Field on files. For example: \"`{query_key}` \u003e 2001-01-01\"", + "description": "Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, \"`{query_key}` \u003e 2001-01-01\".", "readOnly": true, "type": "string" }, "schemaCapabilities": { "$ref": "GoogleAppsDriveLabelsV2FieldSchemaCapabilities", - "description": "Output only. The capabilities this user has when editing this Field", + "description": "Output only. The capabilities this user has when editing this field.", "readOnly": true }, "selectionOptions": { @@ -371,11 +371,11 @@ "type": "boolean" }, "canSearch": { - "description": "Whether the user can search for drive items referencing this field.", + "description": "Whether the user can search for Drive items referencing this field.", "type": "boolean" }, "canWrite": { - "description": "Whether the user can set this field on drive items.", + "description": "Whether the user can set this field on Drive items.", "type": "boolean" } }, @@ -386,12 +386,12 @@ "id": "GoogleAppsDriveLabelsV2FieldDateOptions", "properties": { "dateFormat": { - "description": "Output only. ICU Date format.", + "description": "Output only. ICU date format.", "readOnly": true, "type": "string" }, "dateFormatType": { - "description": "Localized date formatting option. Field values will be rendered in this format according to their locale.", + "description": "Localized date formatting option. Field values are rendered in this format according to their locale.", "enum": [ "DATE_FORMAT_UNSPECIFIED", "LONG_DATE", @@ -399,8 +399,8 @@ ], "enumDescriptions": [ "Date format unspecified.", - "Includes full month name. e.g. January 12, 1999 MMMM d, y", - "Short, numeric, representation. e.g. 12/13/99 M/d/yy" + "Includes full month name. For example, January 12, 1999 (MMMM d, y)", + "Short, numeric, representation. For example, 12/13/99 (M/d/yy)" ], "type": "string" }, @@ -418,7 +418,7 @@ "type": "object" }, "GoogleAppsDriveLabelsV2FieldDisplayHints": { - "description": "UI Display hints for rendering a Field.", + "description": "UI display hints for rendering a field.", "id": "GoogleAppsDriveLabelsV2FieldDisplayHints", "properties": { "disabled": { @@ -426,15 +426,15 @@ "type": "boolean" }, "hiddenInSearch": { - "description": "This Field should be hidden in the search menu.", + "description": "This field should be hidden in the search menu when searching for Drive items.", "type": "boolean" }, "required": { - "description": "Whether the Field should be shown as required in the UI.", + "description": "Whether the field should be shown as required in the UI.", "type": "boolean" }, "shownInApply": { - "description": "This Field should be shown when applying values to a Drive item.", + "description": "This field should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" } }, @@ -480,7 +480,7 @@ "type": "string" }, "insertBeforeField": { - "description": "Input only. Insert or move this Field to be ordered before the indicated Field. If empty, the Field will be placed at the end of the list.", + "description": "Input only. Insert or move this field before the indicated field. If empty, the field is placed at the end of the list.", "type": "string" }, "required": { @@ -491,19 +491,19 @@ "type": "object" }, "GoogleAppsDriveLabelsV2FieldSchemaCapabilities": { - "description": "The capabilities related to this Field when editing the Field.", + "description": "The capabilities related to this field when editing the field.", "id": "GoogleAppsDriveLabelsV2FieldSchemaCapabilities", "properties": { "canDelete": { - "description": "Whether the user can delete this Field. The user must have permissions and the Field must be deprecated.", + "description": "Whether the user can delete this field. The user must have permission and the field must be deprecated.", "type": "boolean" }, "canDisable": { - "description": "Whether the user can disable this Field. The user must have permissions and this Field must not already be disabled.", + "description": "Whether the user can disable this field. The user must have permission and this field must not already be disabled.", "type": "boolean" }, "canEnable": { - "description": "Whether the user can enable this Field. The user must have permissions and this Field must be disabled.", + "description": "Whether the user can enable this field. The user must have permission and this field must be disabled.", "type": "boolean" }, "canUpdate": { @@ -526,74 +526,74 @@ }, "listOptions": { "$ref": "GoogleAppsDriveLabelsV2FieldListOptions", - "description": "When specified, indicates that this field support a list of values. Once the field is published, this cannot be changed." + "description": "When specified, indicates this field supports a list of values. Once the field is published, this cannot be changed." } }, "type": "object" }, "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice": { - "description": "Selection field Choice.", + "description": "Selection field choice.", "id": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice", "properties": { "appliedCapabilities": { "$ref": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities", - "description": "Output only. The capabilities related to this Choice on applied metadata.", + "description": "Output only. The capabilities related to this choice on applied metadata.", "readOnly": true }, "createTime": { - "description": "Output only. The time this Choice was created.", + "description": "Output only. The time this choice was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "creator": { "$ref": "GoogleAppsDriveLabelsV2UserInfo", - "description": "Output only. The user who created this Choice.", + "description": "Output only. The user who created this choice.", "readOnly": true }, "disableTime": { - "description": "Output only. The time this Choice was disabled. This value has no meaning when the Choice is not disabled.", + "description": "Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.", "format": "google-datetime", "readOnly": true, "type": "string" }, "disabler": { "$ref": "GoogleAppsDriveLabelsV2UserInfo", - "description": "Output only. The user who disabled this Choice. This value has no meaning when the option is not disabled.", + "description": "Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.", "readOnly": true }, "displayHints": { "$ref": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints", - "description": "Output only. UI Display hints for rendering a Choice.", + "description": "Output only. UI display hints for rendering a choice.", "readOnly": true }, "id": { - "description": "The unique value of the Choice. This ID will be autogenerated, and will match the form `([a-zA-Z0-9_])+`.", + "description": "The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.", "type": "string" }, "lifecycle": { "$ref": "GoogleAppsDriveLabelsV2Lifecycle", - "description": "Output only. Lifecycle of the Choice.", + "description": "Output only. Lifecycle of the choice.", "readOnly": true }, "lockStatus": { "$ref": "GoogleAppsDriveLabelsV2LockStatus", - "description": "Output only. The LockStatus of this Choice.", + "description": "Output only. The LockStatus of this choice.", "readOnly": true }, "properties": { "$ref": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties", - "description": "Basic properties of the Choice." + "description": "Basic properties of the choice." }, "publishTime": { - "description": "Output only. The time this Choice was published. This value has no meaning when the Choice is not published.", + "description": "Output only. The time this choice was published. This value has no meaning when the choice is not published.", "format": "google-datetime", "readOnly": true, "type": "string" }, "publisher": { "$ref": "GoogleAppsDriveLabelsV2UserInfo", - "description": "Output only. The user who published this Choice. This value has no meaning when the Choice is not published.", + "description": "Output only. The user who published this choice. This value has no meaning when the choice is not published.", "readOnly": true }, "schemaCapabilities": { @@ -602,21 +602,21 @@ "readOnly": true }, "updateTime": { - "description": "Output only. The time this Choice was updated last.", + "description": "Output only. The time this choice was updated last.", "format": "google-datetime", "readOnly": true, "type": "string" }, "updater": { "$ref": "GoogleAppsDriveLabelsV2UserInfo", - "description": "Output only. The user who updated this Choice last.", + "description": "Output only. The user who updated this choice last.", "readOnly": true } }, "type": "object" }, "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities": { - "description": "The capabilities related to this Choice on applied metadata.", + "description": "The capabilities related to this choice on applied metadata.", "id": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities", "properties": { "canRead": { @@ -624,58 +624,58 @@ "type": "boolean" }, "canSearch": { - "description": "Whether the user can use this Choice in search queries.", + "description": "Whether the user can use this choice in search queries.", "type": "boolean" }, "canSelect": { - "description": "Whether the user can select this Choice on an item.", + "description": "Whether the user can select this choice on an item.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints": { - "description": "UI Display hints for rendering a Option.", + "description": "UI display hints for rendering an option.", "id": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints", "properties": { "badgeColors": { "$ref": "GoogleAppsDriveLabelsV2BadgeColors", - "description": "The colors to use for the badge. Coerced to Google Material colors based on the chosen `properties.badge_config.color`." + "description": "The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`." }, "badgePriority": { - "description": "The priority of this badge, used to compare and sort between multiple badges. A lower number means that the badge should be shown first. When a badging configuration is not present, this will be 0. Otherwise, this will be set to `BadgeConfig.priority_override` or the default heuristic which prefers creation date of the Label, and field and option priority.", + "description": "The priority of this badge. Used to compare and sort between multiple badges. A lower number means the badge should be shown first. When a badging configuration is not present, this will be 0. Otherwise, this will be set to `BadgeConfig.priority_override` or the default heuristic which prefers creation date of the label, and field and option priority.", "format": "int64", "type": "string" }, "darkBadgeColors": { "$ref": "GoogleAppsDriveLabelsV2BadgeColors", - "description": "The dark-mode color to use for the badge. Coerced to Google Material colors based on the chosen `properties.badge_config.color`." + "description": "The dark-mode color to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`." }, "disabled": { "description": "Whether the option should be shown in the UI as disabled.", "type": "boolean" }, "hiddenInSearch": { - "description": "This option should be hidden in the search menu.", + "description": "This option should be hidden in the search menu when searching for Drive items.", "type": "boolean" }, "shownInApply": { - "description": "This option should be shown in the menu when applying values to a Drive item.", + "description": "This option should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties": { - "description": "Basic properties of the Choice.", + "description": "Basic properties of the choice.", "id": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties", "properties": { "badgeConfig": { "$ref": "GoogleAppsDriveLabelsV2BadgeConfig", - "description": "The badge configuration for this Choice. When set, the Label that owns this Choice will be considered a \"badged label\"." + "description": "The badge configuration for this choice. When set, the label that owns this choice is considered a \"badged label\"." }, "description": { - "description": "The description of this Label.", + "description": "The description of this label.", "type": "string" }, "displayName": { @@ -683,30 +683,30 @@ "type": "string" }, "insertBeforeChoice": { - "description": "Input only. Insert or move this Choice to be ordered before the indicated Choice. If empty, the Choice will be placed at the end of the list.", + "description": "Input only. Insert or move this choice before the indicated choice. If empty, the choice is placed at the end of the list.", "type": "string" } }, "type": "object" }, "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceSchemaCapabilities": { - "description": "The capabilities related to this Choice when editing the Choice.", + "description": "The capabilities related to this choice when editing the choice.", "id": "GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceSchemaCapabilities", "properties": { "canDelete": { - "description": "Whether the user can delete this Choice.", + "description": "Whether the user can delete this choice.", "type": "boolean" }, "canDisable": { - "description": "Whether the user can disable this Chioce.", + "description": "Whether the user can disable this choice.", "type": "boolean" }, "canEnable": { - "description": "Whether the user can enable this Choice.", + "description": "Whether the user can enable this choice.", "type": "boolean" }, "canUpdate": { - "description": "Whether the user can update this Choice.", + "description": "Whether the user can update this choice.", "type": "boolean" } }, @@ -737,13 +737,13 @@ "properties": { "listOptions": { "$ref": "GoogleAppsDriveLabelsV2FieldListOptions", - "description": "When specified, indicates that this field support a list of values. Once the field is published, this cannot be changed." + "description": "When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed." } }, "type": "object" }, "GoogleAppsDriveLabelsV2Label": { - "description": "A Label defines a taxonomy which may be applied to a Drive items in order to organize and search across Items. Labels may be simple strings, or may contain Fields that describe additional metadata which can be further used to organize and search Drive items.", + "description": "A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items.", "id": "GoogleAppsDriveLabelsV2Label", "properties": { "appliedCapabilities": { @@ -753,7 +753,7 @@ }, "appliedLabelPolicy": { "$ref": "GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy", - "description": "Output only. Behavior of this Label when its applied to Drive items.", + "description": "Output only. Behavior of this label when it's applied to Drive items.", "readOnly": true }, "createTime": { @@ -780,23 +780,23 @@ }, "displayHints": { "$ref": "GoogleAppsDriveLabelsV2LabelDisplayHints", - "description": "Output only. UI Display hints for rendering the Label.", + "description": "Output only. UI display hints for rendering the label.", "readOnly": true }, "fields": { - "description": "List of Fields in descending priority order.", + "description": "List of fields in descending priority order.", "items": { "$ref": "GoogleAppsDriveLabelsV2Field" }, "type": "array" }, "id": { - "description": "Output only. Globally unique identifier of this Label. ID makes up part of the Label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`", + "description": "Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`", "readOnly": true, "type": "string" }, "labelType": { - "description": "Required. The type of this label.", + "description": "Required. The type of label.", "enum": [ "LABEL_TYPE_UNSPECIFIED", "SHARED", @@ -805,7 +805,7 @@ "enumDescriptions": [ "Unknown label type.", "Shared labels may be shared with users to apply to Drive items.", - "Admin owned label. Only creatable and editable by admins, supports some additional admin-only features." + "Admin-owned label. Only creatable and editable by admins. Supports some additional admin-only features." ], "type": "string" }, @@ -824,13 +824,13 @@ "readOnly": true }, "name": { - "description": "Output only. Resource name of the Label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.", + "description": "Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.", "readOnly": true, "type": "string" }, "properties": { "$ref": "GoogleAppsDriveLabelsV2LabelProperties", - "description": "Required. The basic properties of the Label." + "description": "Required. The basic properties of the label." }, "publishTime": { "description": "Output only. The time this label was published. This value has no meaning when the label is not published.", @@ -855,24 +855,24 @@ "readOnly": true }, "revisionId": { - "description": "Output only. Revision ID of the Label. Revision ID may be part of the Label `name` depending on the request issued. A new revision is created whenever revisioned properties of a Label are changed. Matches the regex: `([a-zA-Z0-9])+`", + "description": "Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`", "readOnly": true, "type": "string" }, "schemaCapabilities": { "$ref": "GoogleAppsDriveLabelsV2LabelSchemaCapabilities", - "description": "Output only. The capabilities the user has on this Label.", + "description": "Output only. The capabilities the user has on this label.", "readOnly": true } }, "type": "object" }, "GoogleAppsDriveLabelsV2LabelAppliedCapabilities": { - "description": "The capabilities a user has on this Label's applied metadata.", + "description": "The capabilities a user has on this label's applied metadata.", "id": "GoogleAppsDriveLabelsV2LabelAppliedCapabilities", "properties": { "canApply": { - "description": "Whether the user can apply this Label to items.", + "description": "Whether the user can apply this label to items.", "type": "boolean" }, "canRead": { @@ -880,18 +880,18 @@ "type": "boolean" }, "canRemove": { - "description": "Whether the user can remove this Label from items.", + "description": "Whether the user can remove this label from items.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy": { - "description": "Behavior of this Label when its applied to Drive items.", + "description": "Behavior of this label when it's applied to Drive items.", "id": "GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy", "properties": { "copyMode": { - "description": "Indicates how the applied Label, and Field values should be copied when a Drive item is copied.", + "description": "Indicates how the applied label and field values should be copied when a Drive item is copied.", "enum": [ "COPY_MODE_UNSPECIFIED", "DO_NOT_COPY", @@ -900,9 +900,9 @@ ], "enumDescriptions": [ "Copy mode unspecified.", - "The applied Label and Field values will not be copied by default when the Drive item it is applied to is copied.", - "The applied Label and Field values will always be copied when the Drive item it is applied to is copied. Only admins may use this mode.", - "The applied Label and Field values will be copied if and only if the label is appliable by the user making the copy." + "The applied label and field values are not copied by default when the Drive item it's applied to is copied.", + "The applied label and field values are always copied when the Drive item it's applied to is copied. Only admins can use this mode.", + "The applied label and field values are copied if the label is appliable by the user making the copy." ], "type": "string" } @@ -910,69 +910,69 @@ "type": "object" }, "GoogleAppsDriveLabelsV2LabelDisplayHints": { - "description": "UI Display hints for rendering the Label.", + "description": "UI display hints for rendering the label.", "id": "GoogleAppsDriveLabelsV2LabelDisplayHints", "properties": { "disabled": { - "description": "Whether the Label should be shown in the UI as disabled.", + "description": "Whether the label should be shown in the UI as disabled.", "type": "boolean" }, "hiddenInSearch": { - "description": "This Label should be hidden in the search menu when searching for Drive items.", + "description": "This label should be hidden in the search menu when searching for Drive items.", "type": "boolean" }, "priority": { - "description": "Order to display label in a list", + "description": "Order to display label in a list.", "format": "int64", "type": "string" }, "shownInApply": { - "description": "This Label should be shown in the apply menu.", + "description": "This label should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2LabelProperties": { - "description": "Basic properties of the Label.", + "description": "Basic properties of the label.", "id": "GoogleAppsDriveLabelsV2LabelProperties", "properties": { "description": { - "description": "The description of this Label.", + "description": "The description of the label.", "type": "string" }, "title": { - "description": "Required. Title of the Label.", + "description": "Required. Title of the label.", "type": "string" } }, "type": "object" }, "GoogleAppsDriveLabelsV2LabelSchemaCapabilities": { - "description": "The capabilities related to this Label when editing the Label.", + "description": "The capabilities related to this label when editing the label.", "id": "GoogleAppsDriveLabelsV2LabelSchemaCapabilities", "properties": { "canDelete": { - "description": "Whether the user can delete this Label. The user must have permission and the Label must be disabled.", + "description": "Whether the user can delete this label. The user must have permission and the label must be disabled.", "type": "boolean" }, "canDisable": { - "description": "Whether the user can disable this Label. The user must have permission and this Label must not already be disabled.", + "description": "Whether the user can disable this label. The user must have permission and this label must not already be disabled.", "type": "boolean" }, "canEnable": { - "description": "Whether the user can enable this Label. The user must have permission and this Label must be disabled.", + "description": "Whether the user can enable this label. The user must have permission and this label must be disabled.", "type": "boolean" }, "canUpdate": { - "description": "Whether the user can change this Label.", + "description": "Whether the user can change this label.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2Lifecycle": { - "description": "The lifecycle state of an object, e.g. Label, Field, or Choice. The Lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -\u003e `PUBLISHED` * `UNPUBLISHED_DRAFT` -\u003e (Deleted) * `PUBLISHED` -\u003e `DISABLED` * `DISABLED` -\u003e `PUBLISHED` * `DISABLED` -\u003e (Deleted) The published and disabled states have some distinct characteristics: * Published - Some kinds of changes may be made to an object in this state, in which case `has_unpublished_changes` will be true. Some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. * Disabled - When disabled, the configured `DisabledPolicy` will take effect.", + "description": "The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -\u003e `PUBLISHED` * `UNPUBLISHED_DRAFT` -\u003e (Deleted) * `PUBLISHED` -\u003e `DISABLED` * `DISABLED` -\u003e `PUBLISHED` * `DISABLED` -\u003e (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect.", "id": "GoogleAppsDriveLabelsV2Lifecycle", "properties": { "disabledPolicy": { @@ -995,10 +995,10 @@ ], "enumDescriptions": [ "Unknown State.", - "The initial state of an object. Once published, the object may never return to this state. Once an object is published, certain kinds of changes are no longer permitted.", - "The object has been published. The object may have unpublished draft changes as indicated by `has_unpublished_changes`.", - "The object has been published, and has since been disabled. The object may have unpublished draft changes as indicated by `has_unpublished_changes`.", - "The object has been deleted" + "The initial state of an object. Once published, the object can never return to this state. Once an object is published, certain kinds of changes are no longer permitted.", + "The object has been published. The object might have unpublished draft changes as indicated by `has_unpublished_changes`.", + "The object has been published and has since been disabled. The object might have unpublished draft changes as indicated by `has_unpublished_changes`.", + "The object has been deleted." ], "readOnly": true, "type": "string" @@ -1011,11 +1011,11 @@ "id": "GoogleAppsDriveLabelsV2LifecycleDisabledPolicy", "properties": { "hideInSearch": { - "description": "Whether to hide this disabled object in the search menu for Drive items. * When `false` the object will generally be shown in the UI as disabled (but still permit searching) when searching for Drive items. * When `true` the object will generally be hidden in the UI when searching for Drive items.", + "description": "Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.", "type": "boolean" }, "showInApply": { - "description": "Whether to show this disabled object in the apply menu on Drive items. * When `true` the object will generally be shown in the UI as disabled and is unselectable. * When `false` the object will generally be hidden in the UI.", + "description": "Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.", "type": "boolean" } }, @@ -1044,7 +1044,7 @@ "id": "GoogleAppsDriveLabelsV2LockStatus", "properties": { "locked": { - "description": "Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component may be implicitly locked even if it is not the direct target of a LabelLock, in which case this field will be false.", + "description": "Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.", "readOnly": true, "type": "boolean" } @@ -1056,7 +1056,7 @@ "id": "GoogleAppsDriveLabelsV2UserInfo", "properties": { "person": { - "description": "The identifier for this user who can be used with the People API to get more information. e.g. people/12345678", + "description": "The identifier for this user that can be used with the People API to get more information. For example, people/12345678.", "type": "string" } }, diff --git a/drivelabels/v2/drivelabels-gen.go b/drivelabels/v2/drivelabels-gen.go index e72dfe8718a..2e313f909cd 100644 --- a/drivelabels/v2/drivelabels-gen.go +++ b/drivelabels/v2/drivelabels-gen.go @@ -135,18 +135,18 @@ type LabelsService struct { } // GoogleAppsDriveLabelsV2BadgeColors: The color derived from -// BadgeConfig and coerced to the nearest supported color. +// BadgeConfig and changed to the closest recommended supported color. type GoogleAppsDriveLabelsV2BadgeColors struct { - // BackgroundColor: Output only. Badge background which pairs with the - // foreground + // BackgroundColor: Output only. Badge background that pairs with the + // foreground. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // ForegroundColor: Output only. Badge foreground which pairs with the - // background + // ForegroundColor: Output only. Badge foreground that pairs with the + // background. ForegroundColor *GoogleTypeColor `json:"foregroundColor,omitempty"` // SoloColor: Output only. Color that can be used for text without a - // background + // background. SoloColor *GoogleTypeColor `json:"soloColor,omitempty"` // ForceSendFields is a list of field names (e.g. "BackgroundColor") to @@ -175,13 +175,14 @@ func (s *GoogleAppsDriveLabelsV2BadgeColors) MarshalJSON() ([]byte, error) { // GoogleAppsDriveLabelsV2BadgeConfig: Badge status of the label. type GoogleAppsDriveLabelsV2BadgeConfig struct { - // Color: The color of the badge. When not specified, no badge will be - // rendered. This color will be coerced into the closest recommended - // supported color. + // Color: The color of the badge. When not specified, no badge is + // rendered. The background, foreground, and solo (light and dark mode) + // colors set here are changed in the Drive UI into the closest + // recommended supported color. Color *GoogleTypeColor `json:"color,omitempty"` // PriorityOverride: Override the default global priority of this badge. - // When set to 0, the default priority heuristic will be used. + // When set to 0, the default priority heuristic is used. PriorityOverride int64 `json:"priorityOverride,omitempty,string"` // ForceSendFields is a list of field names (e.g. "Color") to @@ -207,12 +208,12 @@ func (s *GoogleAppsDriveLabelsV2BadgeConfig) MarshalJSON() ([]byte, error) { return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2Field: Defines a field which has a display +// GoogleAppsDriveLabelsV2Field: Defines a field that has a display // name, data type, and other configuration options. This field defines // the kind of metadata that may be set on a Drive item. type GoogleAppsDriveLabelsV2Field struct { // AppliedCapabilities: Output only. The capabilities this user has on - // this Field and its value when the Label is applied on Drive items. + // this field and its value when the label is applied on Drive items. AppliedCapabilities *GoogleAppsDriveLabelsV2FieldAppliedCapabilities `json:"appliedCapabilities,omitempty"` // CreateTime: Output only. The time this field was created. @@ -232,18 +233,18 @@ type GoogleAppsDriveLabelsV2Field struct { // has no meaning when the field is not disabled. Disabler *GoogleAppsDriveLabelsV2UserInfo `json:"disabler,omitempty"` - // DisplayHints: Output only. UI Display hints for rendering a Field. + // DisplayHints: Output only. UI display hints for rendering a field. DisplayHints *GoogleAppsDriveLabelsV2FieldDisplayHints `json:"displayHints,omitempty"` - // Id: Output only. The key of a field, unique within a Label or - // Library. This value is autogenerated, and will match the form - // `([a-zA-Z0-9_])+ + // Id: Output only. The key of a field, unique within a label or + // library. This value is autogenerated. Matches the regex: + // `([a-zA-Z0-9])+` Id string `json:"id,omitempty"` // IntegerOptions: Integer field options. IntegerOptions *GoogleAppsDriveLabelsV2FieldIntegerOptions `json:"integerOptions,omitempty"` - // Lifecycle: Output only. The lifecycle of this Field. + // Lifecycle: Output only. The lifecycle of this field. Lifecycle *GoogleAppsDriveLabelsV2Lifecycle `json:"lifecycle,omitempty"` // LockStatus: Output only. The LockStatus of this field. @@ -257,12 +258,12 @@ type GoogleAppsDriveLabelsV2Field struct { Publisher *GoogleAppsDriveLabelsV2UserInfo `json:"publisher,omitempty"` // QueryKey: Output only. The key to use when constructing Drive search - // queries to find files based on values defined for this Field on - // files. For example: "{query_key}` > 2001-01-01" + // queries to find files based on values defined for this field on + // files. For example, "{query_key}` > 2001-01-01". QueryKey string `json:"queryKey,omitempty"` // SchemaCapabilities: Output only. The capabilities this user has when - // editing this Field + // editing this field. SchemaCapabilities *GoogleAppsDriveLabelsV2FieldSchemaCapabilities `json:"schemaCapabilities,omitempty"` // SelectionOptions: Selection field options. @@ -310,11 +311,11 @@ type GoogleAppsDriveLabelsV2FieldAppliedCapabilities struct { // CanRead: Whether the user can read related applied metadata on items. CanRead bool `json:"canRead,omitempty"` - // CanSearch: Whether the user can search for drive items referencing + // CanSearch: Whether the user can search for Drive items referencing // this field. CanSearch bool `json:"canSearch,omitempty"` - // CanWrite: Whether the user can set this field on drive items. + // CanWrite: Whether the user can set this field on Drive items. CanWrite bool `json:"canWrite,omitempty"` // ForceSendFields is a list of field names (e.g. "CanRead") to @@ -343,17 +344,18 @@ func (s *GoogleAppsDriveLabelsV2FieldAppliedCapabilities) MarshalJSON() ([]byte, // GoogleAppsDriveLabelsV2FieldDateOptions: Options for the date field // type. type GoogleAppsDriveLabelsV2FieldDateOptions struct { - // DateFormat: Output only. ICU Date format. + // DateFormat: Output only. ICU date format. DateFormat string `json:"dateFormat,omitempty"` - // DateFormatType: Localized date formatting option. Field values will - // be rendered in this format according to their locale. + // DateFormatType: Localized date formatting option. Field values are + // rendered in this format according to their locale. // // Possible values: // "DATE_FORMAT_UNSPECIFIED" - Date format unspecified. - // "LONG_DATE" - Includes full month name. e.g. January 12, 1999 MMMM - // d, y - // "SHORT_DATE" - Short, numeric, representation. e.g. 12/13/99 M/d/yy + // "LONG_DATE" - Includes full month name. For example, January 12, + // 1999 (MMMM d, y) + // "SHORT_DATE" - Short, numeric, representation. For example, + // 12/13/99 (M/d/yy) DateFormatType string `json:"dateFormatType,omitempty"` // MaxValue: Output only. Maximum valid value (year, month, day). @@ -385,20 +387,21 @@ func (s *GoogleAppsDriveLabelsV2FieldDateOptions) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2FieldDisplayHints: UI Display hints for -// rendering a Field. +// GoogleAppsDriveLabelsV2FieldDisplayHints: UI display hints for +// rendering a field. type GoogleAppsDriveLabelsV2FieldDisplayHints struct { // Disabled: Whether the field should be shown in the UI as disabled. Disabled bool `json:"disabled,omitempty"` - // HiddenInSearch: This Field should be hidden in the search menu. + // HiddenInSearch: This field should be hidden in the search menu when + // searching for Drive items. HiddenInSearch bool `json:"hiddenInSearch,omitempty"` - // Required: Whether the Field should be shown as required in the UI. + // Required: Whether the field should be shown as required in the UI. Required bool `json:"required,omitempty"` - // ShownInApply: This Field should be shown when applying values to a - // Drive item. + // ShownInApply: This field should be shown in the apply menu when + // applying values to a Drive item. ShownInApply bool `json:"shownInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "Disabled") to @@ -492,9 +495,9 @@ type GoogleAppsDriveLabelsV2FieldProperties struct { // this field. DisplayName string `json:"displayName,omitempty"` - // InsertBeforeField: Input only. Insert or move this Field to be - // ordered before the indicated Field. If empty, the Field will be - // placed at the end of the list. + // InsertBeforeField: Input only. Insert or move this field before the + // indicated field. If empty, the field is placed at the end of the + // list. InsertBeforeField string `json:"insertBeforeField,omitempty"` // Required: Whether the field should be marked as required. @@ -524,18 +527,18 @@ func (s *GoogleAppsDriveLabelsV2FieldProperties) MarshalJSON() ([]byte, error) { } // GoogleAppsDriveLabelsV2FieldSchemaCapabilities: The capabilities -// related to this Field when editing the Field. +// related to this field when editing the field. type GoogleAppsDriveLabelsV2FieldSchemaCapabilities struct { - // CanDelete: Whether the user can delete this Field. The user must have - // permissions and the Field must be deprecated. + // CanDelete: Whether the user can delete this field. The user must have + // permission and the field must be deprecated. CanDelete bool `json:"canDelete,omitempty"` - // CanDisable: Whether the user can disable this Field. The user must - // have permissions and this Field must not already be disabled. + // CanDisable: Whether the user can disable this field. The user must + // have permission and this field must not already be disabled. CanDisable bool `json:"canDisable,omitempty"` - // CanEnable: Whether the user can enable this Field. The user must have - // permissions and this Field must be disabled. + // CanEnable: Whether the user can enable this field. The user must have + // permission and this field must be disabled. CanEnable bool `json:"canEnable,omitempty"` // CanUpdate: Whether the user can change this field. @@ -571,8 +574,8 @@ type GoogleAppsDriveLabelsV2FieldSelectionOptions struct { // order is consistent, and modified with `insert_before_choice`. Choices []*GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice `json:"choices,omitempty"` - // ListOptions: When specified, indicates that this field support a list - // of values. Once the field is published, this cannot be changed. + // ListOptions: When specified, indicates this field supports a list of + // values. Once the field is published, this cannot be changed. ListOptions *GoogleAppsDriveLabelsV2FieldListOptions `json:"listOptions,omitempty"` // ForceSendFields is a list of field names (e.g. "Choices") to @@ -599,58 +602,58 @@ func (s *GoogleAppsDriveLabelsV2FieldSelectionOptions) MarshalJSON() ([]byte, er } // GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice: Selection field -// Choice. +// choice. type GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice struct { // AppliedCapabilities: Output only. The capabilities related to this - // Choice on applied metadata. + // choice on applied metadata. AppliedCapabilities *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities `json:"appliedCapabilities,omitempty"` - // CreateTime: Output only. The time this Choice was created. + // CreateTime: Output only. The time this choice was created. CreateTime string `json:"createTime,omitempty"` - // Creator: Output only. The user who created this Choice. + // Creator: Output only. The user who created this choice. Creator *GoogleAppsDriveLabelsV2UserInfo `json:"creator,omitempty"` - // DisableTime: Output only. The time this Choice was disabled. This - // value has no meaning when the Choice is not disabled. + // DisableTime: Output only. The time this choice was disabled. This + // value has no meaning when the choice is not disabled. DisableTime string `json:"disableTime,omitempty"` - // Disabler: Output only. The user who disabled this Choice. This value + // Disabler: Output only. The user who disabled this choice. This value // has no meaning when the option is not disabled. Disabler *GoogleAppsDriveLabelsV2UserInfo `json:"disabler,omitempty"` - // DisplayHints: Output only. UI Display hints for rendering a Choice. + // DisplayHints: Output only. UI display hints for rendering a choice. DisplayHints *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints `json:"displayHints,omitempty"` - // Id: The unique value of the Choice. This ID will be autogenerated, - // and will match the form `([a-zA-Z0-9_])+`. + // Id: The unique value of the choice. This ID is autogenerated. Matches + // the regex: `([a-zA-Z0-9_])+`. Id string `json:"id,omitempty"` - // Lifecycle: Output only. Lifecycle of the Choice. + // Lifecycle: Output only. Lifecycle of the choice. Lifecycle *GoogleAppsDriveLabelsV2Lifecycle `json:"lifecycle,omitempty"` - // LockStatus: Output only. The LockStatus of this Choice. + // LockStatus: Output only. The LockStatus of this choice. LockStatus *GoogleAppsDriveLabelsV2LockStatus `json:"lockStatus,omitempty"` - // Properties: Basic properties of the Choice. + // Properties: Basic properties of the choice. Properties *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties `json:"properties,omitempty"` - // PublishTime: Output only. The time this Choice was published. This - // value has no meaning when the Choice is not published. + // PublishTime: Output only. The time this choice was published. This + // value has no meaning when the choice is not published. PublishTime string `json:"publishTime,omitempty"` - // Publisher: Output only. The user who published this Choice. This - // value has no meaning when the Choice is not published. + // Publisher: Output only. The user who published this choice. This + // value has no meaning when the choice is not published. Publisher *GoogleAppsDriveLabelsV2UserInfo `json:"publisher,omitempty"` // SchemaCapabilities: Output only. The capabilities related to this // option when editing the option. SchemaCapabilities *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceSchemaCapabilities `json:"schemaCapabilities,omitempty"` - // UpdateTime: Output only. The time this Choice was updated last. + // UpdateTime: Output only. The time this choice was updated last. UpdateTime string `json:"updateTime,omitempty"` - // Updater: Output only. The user who updated this Choice last. + // Updater: Output only. The user who updated this choice last. Updater *GoogleAppsDriveLabelsV2UserInfo `json:"updater,omitempty"` // ForceSendFields is a list of field names (e.g. "AppliedCapabilities") @@ -678,15 +681,15 @@ func (s *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoice) MarshalJSON() ([]by } // GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities: -// The capabilities related to this Choice on applied metadata. +// The capabilities related to this choice on applied metadata. type GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities struct { // CanRead: Whether the user can read related applied metadata on items. CanRead bool `json:"canRead,omitempty"` - // CanSearch: Whether the user can use this Choice in search queries. + // CanSearch: Whether the user can use this choice in search queries. CanSearch bool `json:"canSearch,omitempty"` - // CanSelect: Whether the user can select this Choice on an item. + // CanSelect: Whether the user can select this choice on an item. CanSelect bool `json:"canSelect,omitempty"` // ForceSendFields is a list of field names (e.g. "CanRead") to @@ -713,21 +716,21 @@ func (s *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceAppliedCapabilities) } // GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints: UI -// Display hints for rendering a Option. +// display hints for rendering an option. type GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints struct { - // BadgeColors: The colors to use for the badge. Coerced to Google + // BadgeColors: The colors to use for the badge. Changed to Google // Material colors based on the chosen `properties.badge_config.color`. BadgeColors *GoogleAppsDriveLabelsV2BadgeColors `json:"badgeColors,omitempty"` - // BadgePriority: The priority of this badge, used to compare and sort - // between multiple badges. A lower number means that the badge should - // be shown first. When a badging configuration is not present, this - // will be 0. Otherwise, this will be set to - // `BadgeConfig.priority_override` or the default heuristic which - // prefers creation date of the Label, and field and option priority. + // BadgePriority: The priority of this badge. Used to compare and sort + // between multiple badges. A lower number means the badge should be + // shown first. When a badging configuration is not present, this will + // be 0. Otherwise, this will be set to `BadgeConfig.priority_override` + // or the default heuristic which prefers creation date of the label, + // and field and option priority. BadgePriority int64 `json:"badgePriority,omitempty,string"` - // DarkBadgeColors: The dark-mode color to use for the badge. Coerced to + // DarkBadgeColors: The dark-mode color to use for the badge. Changed to // Google Material colors based on the chosen // `properties.badge_config.color`. DarkBadgeColors *GoogleAppsDriveLabelsV2BadgeColors `json:"darkBadgeColors,omitempty"` @@ -735,11 +738,12 @@ type GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints struct { // Disabled: Whether the option should be shown in the UI as disabled. Disabled bool `json:"disabled,omitempty"` - // HiddenInSearch: This option should be hidden in the search menu. + // HiddenInSearch: This option should be hidden in the search menu when + // searching for Drive items. HiddenInSearch bool `json:"hiddenInSearch,omitempty"` - // ShownInApply: This option should be shown in the menu when applying - // values to a Drive item. + // ShownInApply: This option should be shown in the apply menu when + // applying values to a Drive item. ShownInApply bool `json:"shownInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "BadgeColors") to @@ -766,22 +770,22 @@ func (s *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceDisplayHints) Marshal } // GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties: Basic -// properties of the Choice. +// properties of the choice. type GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties struct { - // BadgeConfig: The badge configuration for this Choice. When set, the - // Label that owns this Choice will be considered a "badged label". + // BadgeConfig: The badge configuration for this choice. When set, the + // label that owns this choice is considered a "badged label". BadgeConfig *GoogleAppsDriveLabelsV2BadgeConfig `json:"badgeConfig,omitempty"` - // Description: The description of this Label. + // Description: The description of this label. Description string `json:"description,omitempty"` // DisplayName: Required. The display text to show in the UI identifying // this field. DisplayName string `json:"displayName,omitempty"` - // InsertBeforeChoice: Input only. Insert or move this Choice to be - // ordered before the indicated Choice. If empty, the Choice will be - // placed at the end of the list. + // InsertBeforeChoice: Input only. Insert or move this choice before the + // indicated choice. If empty, the choice is placed at the end of the + // list. InsertBeforeChoice string `json:"insertBeforeChoice,omitempty"` // ForceSendFields is a list of field names (e.g. "BadgeConfig") to @@ -808,18 +812,18 @@ func (s *GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceProperties) MarshalJS } // GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceSchemaCapabilities: -// The capabilities related to this Choice when editing the Choice. +// The capabilities related to this choice when editing the choice. type GoogleAppsDriveLabelsV2FieldSelectionOptionsChoiceSchemaCapabilities struct { - // CanDelete: Whether the user can delete this Choice. + // CanDelete: Whether the user can delete this choice. CanDelete bool `json:"canDelete,omitempty"` - // CanDisable: Whether the user can disable this Chioce. + // CanDisable: Whether the user can disable this choice. CanDisable bool `json:"canDisable,omitempty"` - // CanEnable: Whether the user can enable this Choice. + // CanEnable: Whether the user can enable this choice. CanEnable bool `json:"canEnable,omitempty"` - // CanUpdate: Whether the user can update this Choice. + // CanUpdate: Whether the user can update this choice. CanUpdate bool `json:"canUpdate,omitempty"` // ForceSendFields is a list of field names (e.g. "CanDelete") to @@ -882,8 +886,8 @@ func (s *GoogleAppsDriveLabelsV2FieldTextOptions) MarshalJSON() ([]byte, error) // GoogleAppsDriveLabelsV2FieldUserOptions: Options for the user field // type. type GoogleAppsDriveLabelsV2FieldUserOptions struct { - // ListOptions: When specified, indicates that this field support a list - // of values. Once the field is published, this cannot be changed. + // ListOptions: When specified, indicates that this field supports a + // list of values. Once the field is published, this cannot be changed. ListOptions *GoogleAppsDriveLabelsV2FieldListOptions `json:"listOptions,omitempty"` // ForceSendFields is a list of field names (e.g. "ListOptions") to @@ -909,17 +913,17 @@ func (s *GoogleAppsDriveLabelsV2FieldUserOptions) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2Label: A Label defines a taxonomy which may be -// applied to a Drive items in order to organize and search across -// Items. Labels may be simple strings, or may contain Fields that -// describe additional metadata which can be further used to organize -// and search Drive items. +// GoogleAppsDriveLabelsV2Label: A label defines a taxonomy that can be +// applied to Drive items in order to organize and search across items. +// Labels can be simple strings, or can contain fields that describe +// additional metadata that can be further used to organize and search +// Drive items. type GoogleAppsDriveLabelsV2Label struct { // AppliedCapabilities: Output only. The capabilities related to this // label on applied metadata. AppliedCapabilities *GoogleAppsDriveLabelsV2LabelAppliedCapabilities `json:"appliedCapabilities,omitempty"` - // AppliedLabelPolicy: Output only. Behavior of this Label when its + // AppliedLabelPolicy: Output only. Behavior of this label when it's // applied to Drive items. AppliedLabelPolicy *GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy `json:"appliedLabelPolicy,omitempty"` @@ -937,25 +941,25 @@ type GoogleAppsDriveLabelsV2Label struct { // has no meaning when the label is not disabled. Disabler *GoogleAppsDriveLabelsV2UserInfo `json:"disabler,omitempty"` - // DisplayHints: Output only. UI Display hints for rendering the Label. + // DisplayHints: Output only. UI display hints for rendering the label. DisplayHints *GoogleAppsDriveLabelsV2LabelDisplayHints `json:"displayHints,omitempty"` - // Fields: List of Fields in descending priority order. + // Fields: List of fields in descending priority order. Fields []*GoogleAppsDriveLabelsV2Field `json:"fields,omitempty"` - // Id: Output only. Globally unique identifier of this Label. ID makes - // up part of the Label `name`, but unlike `name`, ID is consistent + // Id: Output only. Globally unique identifier of this label. ID makes + // up part of the label `name`, but unlike `name`, ID is consistent // between revisions. Matches the regex: `([a-zA-Z0-9])+` Id string `json:"id,omitempty"` - // LabelType: Required. The type of this label. + // LabelType: Required. The type of label. // // Possible values: // "LABEL_TYPE_UNSPECIFIED" - Unknown label type. // "SHARED" - Shared labels may be shared with users to apply to Drive // items. - // "ADMIN" - Admin owned label. Only creatable and editable by admins, - // supports some additional admin-only features. + // "ADMIN" - Admin-owned label. Only creatable and editable by admins. + // Supports some additional admin-only features. LabelType string `json:"labelType,omitempty"` // LearnMoreUri: Custom URL to present to users to allow them to learn @@ -969,12 +973,12 @@ type GoogleAppsDriveLabelsV2Label struct { // LockStatus: Output only. The LockStatus of this label. LockStatus *GoogleAppsDriveLabelsV2LockStatus `json:"lockStatus,omitempty"` - // Name: Output only. Resource name of the Label. Will be in the form of + // Name: Output only. Resource name of the label. Will be in the form of // either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the // request. See `id` and `revision_id` below. Name string `json:"name,omitempty"` - // Properties: Required. The basic properties of the Label. + // Properties: Required. The basic properties of the label. Properties *GoogleAppsDriveLabelsV2LabelProperties `json:"properties,omitempty"` // PublishTime: Output only. The time this label was published. This @@ -993,14 +997,14 @@ type GoogleAppsDriveLabelsV2Label struct { // revision. RevisionCreator *GoogleAppsDriveLabelsV2UserInfo `json:"revisionCreator,omitempty"` - // RevisionId: Output only. Revision ID of the Label. Revision ID may be - // part of the Label `name` depending on the request issued. A new - // revision is created whenever revisioned properties of a Label are + // RevisionId: Output only. Revision ID of the label. Revision ID might + // be part of the label `name` depending on the request issued. A new + // revision is created whenever revisioned properties of a label are // changed. Matches the regex: `([a-zA-Z0-9])+` RevisionId string `json:"revisionId,omitempty"` // SchemaCapabilities: Output only. The capabilities the user has on - // this Label. + // this label. SchemaCapabilities *GoogleAppsDriveLabelsV2LabelSchemaCapabilities `json:"schemaCapabilities,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -1032,16 +1036,16 @@ func (s *GoogleAppsDriveLabelsV2Label) MarshalJSON() ([]byte, error) { } // GoogleAppsDriveLabelsV2LabelAppliedCapabilities: The capabilities a -// user has on this Label's applied metadata. +// user has on this label's applied metadata. type GoogleAppsDriveLabelsV2LabelAppliedCapabilities struct { - // CanApply: Whether the user can apply this Label to items. + // CanApply: Whether the user can apply this label to items. CanApply bool `json:"canApply,omitempty"` // CanRead: Whether the user can read applied metadata related to this // label. CanRead bool `json:"canRead,omitempty"` - // CanRemove: Whether the user can remove this Label from items. + // CanRemove: Whether the user can remove this label from items. CanRemove bool `json:"canRemove,omitempty"` // ForceSendFields is a list of field names (e.g. "CanApply") to @@ -1068,21 +1072,20 @@ func (s *GoogleAppsDriveLabelsV2LabelAppliedCapabilities) MarshalJSON() ([]byte, } // GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy: Behavior of this -// Label when its applied to Drive items. +// label when it's applied to Drive items. type GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy struct { - // CopyMode: Indicates how the applied Label, and Field values should be + // CopyMode: Indicates how the applied label and field values should be // copied when a Drive item is copied. // // Possible values: // "COPY_MODE_UNSPECIFIED" - Copy mode unspecified. - // "DO_NOT_COPY" - The applied Label and Field values will not be - // copied by default when the Drive item it is applied to is copied. - // "ALWAYS_COPY" - The applied Label and Field values will always be - // copied when the Drive item it is applied to is copied. Only admins - // may use this mode. - // "COPY_APPLIABLE" - The applied Label and Field values will be - // copied if and only if the label is appliable by the user making the - // copy. + // "DO_NOT_COPY" - The applied label and field values are not copied + // by default when the Drive item it's applied to is copied. + // "ALWAYS_COPY" - The applied label and field values are always + // copied when the Drive item it's applied to is copied. Only admins can + // use this mode. + // "COPY_APPLIABLE" - The applied label and field values are copied if + // the label is appliable by the user making the copy. CopyMode string `json:"copyMode,omitempty"` // ForceSendFields is a list of field names (e.g. "CopyMode") to @@ -1108,20 +1111,21 @@ func (s *GoogleAppsDriveLabelsV2LabelAppliedLabelPolicy) MarshalJSON() ([]byte, return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2LabelDisplayHints: UI Display hints for -// rendering the Label. +// GoogleAppsDriveLabelsV2LabelDisplayHints: UI display hints for +// rendering the label. type GoogleAppsDriveLabelsV2LabelDisplayHints struct { - // Disabled: Whether the Label should be shown in the UI as disabled. + // Disabled: Whether the label should be shown in the UI as disabled. Disabled bool `json:"disabled,omitempty"` - // HiddenInSearch: This Label should be hidden in the search menu when + // HiddenInSearch: This label should be hidden in the search menu when // searching for Drive items. HiddenInSearch bool `json:"hiddenInSearch,omitempty"` - // Priority: Order to display label in a list + // Priority: Order to display label in a list. Priority int64 `json:"priority,omitempty,string"` - // ShownInApply: This Label should be shown in the apply menu. + // ShownInApply: This label should be shown in the apply menu when + // applying values to a Drive item. ShownInApply bool `json:"shownInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "Disabled") to @@ -1148,12 +1152,12 @@ func (s *GoogleAppsDriveLabelsV2LabelDisplayHints) MarshalJSON() ([]byte, error) } // GoogleAppsDriveLabelsV2LabelProperties: Basic properties of the -// Label. +// label. type GoogleAppsDriveLabelsV2LabelProperties struct { - // Description: The description of this Label. + // Description: The description of the label. Description string `json:"description,omitempty"` - // Title: Required. Title of the Label. + // Title: Required. Title of the label. Title string `json:"title,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -1180,21 +1184,21 @@ func (s *GoogleAppsDriveLabelsV2LabelProperties) MarshalJSON() ([]byte, error) { } // GoogleAppsDriveLabelsV2LabelSchemaCapabilities: The capabilities -// related to this Label when editing the Label. +// related to this label when editing the label. type GoogleAppsDriveLabelsV2LabelSchemaCapabilities struct { - // CanDelete: Whether the user can delete this Label. The user must have - // permission and the Label must be disabled. + // CanDelete: Whether the user can delete this label. The user must have + // permission and the label must be disabled. CanDelete bool `json:"canDelete,omitempty"` - // CanDisable: Whether the user can disable this Label. The user must - // have permission and this Label must not already be disabled. + // CanDisable: Whether the user can disable this label. The user must + // have permission and this label must not already be disabled. CanDisable bool `json:"canDisable,omitempty"` - // CanEnable: Whether the user can enable this Label. The user must have - // permission and this Label must be disabled. + // CanEnable: Whether the user can enable this label. The user must have + // permission and this label must be disabled. CanEnable bool `json:"canEnable,omitempty"` - // CanUpdate: Whether the user can change this Label. + // CanUpdate: Whether the user can change this label. CanUpdate bool `json:"canUpdate,omitempty"` // ForceSendFields is a list of field names (e.g. "CanDelete") to @@ -1221,17 +1225,18 @@ func (s *GoogleAppsDriveLabelsV2LabelSchemaCapabilities) MarshalJSON() ([]byte, } // GoogleAppsDriveLabelsV2Lifecycle: The lifecycle state of an object, -// e.g. Label, Field, or Choice. The Lifecycle enforces the following +// such as label, field, or choice. The lifecycle enforces the following // transitions: * `UNPUBLISHED_DRAFT` (starting state) * // `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) // * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` // -> (Deleted) The published and disabled states have some distinct -// characteristics: * Published - Some kinds of changes may be made to +// characteristics: * Published—Some kinds of changes might be made to // an object in this state, in which case `has_unpublished_changes` will -// be true. Some kinds of changes are not permitted. Generally, any -// change that would invalidate or cause new restrictions on existing -// metadata related to the Label will be rejected. * Disabled - When -// disabled, the configured `DisabledPolicy` will take effect. +// be true. Also, some kinds of changes are not permitted. Generally, +// any change that would invalidate or cause new restrictions on +// existing metadata related to the label are rejected. * +// Disabled—When disabled, the configured `DisabledPolicy` takes +// effect. type GoogleAppsDriveLabelsV2Lifecycle struct { // DisabledPolicy: The policy that governs how to show a disabled label, // field, or selection choice. @@ -1247,14 +1252,14 @@ type GoogleAppsDriveLabelsV2Lifecycle struct { // Possible values: // "STATE_UNSPECIFIED" - Unknown State. // "UNPUBLISHED_DRAFT" - The initial state of an object. Once - // published, the object may never return to this state. Once an object + // published, the object can never return to this state. Once an object // is published, certain kinds of changes are no longer permitted. - // "PUBLISHED" - The object has been published. The object may have + // "PUBLISHED" - The object has been published. The object might have // unpublished draft changes as indicated by `has_unpublished_changes`. - // "DISABLED" - The object has been published, and has since been - // disabled. The object may have unpublished draft changes as indicated - // by `has_unpublished_changes`. - // "DELETED" - The object has been deleted + // "DISABLED" - The object has been published and has since been + // disabled. The object might have unpublished draft changes as + // indicated by `has_unpublished_changes`. + // "DELETED" - The object has been deleted. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "DisabledPolicy") to @@ -1286,16 +1291,16 @@ func (s *GoogleAppsDriveLabelsV2Lifecycle) MarshalJSON() ([]byte, error) { // different contexts. type GoogleAppsDriveLabelsV2LifecycleDisabledPolicy struct { // HideInSearch: Whether to hide this disabled object in the search menu - // for Drive items. * When `false` the object will generally be shown in - // the UI as disabled (but still permit searching) when searching for - // Drive items. * When `true` the object will generally be hidden in the + // for Drive items. * When `false`, the object is generally shown in the + // UI as disabled but it appears in the search results when searching + // for Drive items. * When `true`, the object is generally hidden in the // UI when searching for Drive items. HideInSearch bool `json:"hideInSearch,omitempty"` // ShowInApply: Whether to show this disabled object in the apply menu - // on Drive items. * When `true` the object will generally be shown in - // the UI as disabled and is unselectable. * When `false` the object - // will generally be hidden in the UI. + // on Drive items. * When `true`, the object is generally shown in the + // UI as disabled and is unselectable. * When `false`, the object is + // generally hidden in the UI. ShowInApply bool `json:"showInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "HideInSearch") to @@ -1361,9 +1366,9 @@ func (s *GoogleAppsDriveLabelsV2ListLabelsResponse) MarshalJSON() ([]byte, error // a label component should be considered locked. type GoogleAppsDriveLabelsV2LockStatus struct { // Locked: Output only. Indicates whether this label component is the - // (direct) target of a LabelLock. A label component may be implicitly - // locked even if it is not the direct target of a LabelLock, in which - // case this field will be false. + // (direct) target of a LabelLock. A label component can be implicitly + // locked even if it's not the direct target of a LabelLock, in which + // case this field is set to false. Locked bool `json:"locked,omitempty"` // ForceSendFields is a list of field names (e.g. "Locked") to @@ -1391,8 +1396,8 @@ func (s *GoogleAppsDriveLabelsV2LockStatus) MarshalJSON() ([]byte, error) { // GoogleAppsDriveLabelsV2UserInfo: Information about a user. type GoogleAppsDriveLabelsV2UserInfo struct { - // Person: The identifier for this user who can be used with the People - // API to get more information. e.g. people/12345678 + // Person: The identifier for this user that can be used with the People + // API to get more information. For example, people/12345678. Person string `json:"person,omitempty"` // ForceSendFields is a list of field names (e.g. "Person") to @@ -1597,11 +1602,11 @@ type LabelsGetCall struct { header_ http.Header } -// Get: Get a Label by its resource name. Resource name may be any of: * -// `labels/{id}` - See to `labels/{id}@latest` * `labels/{id}@latest` - -// Gets the latest revision of the Label. * `labels/{id}@published` - -// Gets the current published revision of the Label. * -// `labels/{id}@{revision_id}` - Gets the Label at the specified +// Get: Get a label by its resource name. Resource name may be any of: * +// `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - +// Gets the latest revision of the label. * `labels/{id}@published` - +// Gets the current published revision of the label. * +// `labels/{id}@{revision_id}` - Gets the label at the specified // revision ID. // // - name: Label resource name. May be any of: * `labels/{id}` @@ -1614,23 +1619,24 @@ func (r *LabelsService) Get(name string) *LabelsGetCall { } // LanguageCode sets the optional parameter "languageCode": The BCP-47 -// language code to use for evaluating localized Field labels. When not -// specified, values in the default configured language will be used. +// language code to use for evaluating localized field labels. When not +// specified, values in the default configured language are used. func (c *LabelsGetCall) LanguageCode(languageCode string) *LabelsGetCall { c.urlParams_.Set("languageCode", languageCode) return c } // UseAdminAccess sets the optional parameter "useAdminAccess": Set to -// `true` in order to use the user's admin credentials. The server will -// verify the user is an admin for the Label before allowing access. +// `true` in order to use the user's admin credentials. The server +// verifies that the user is an admin for the label before allowing +// access. func (c *LabelsGetCall) UseAdminAccess(useAdminAccess bool) *LabelsGetCall { c.urlParams_.Set("useAdminAccess", fmt.Sprint(useAdminAccess)) return c } // View sets the optional parameter "view": When specified, only certain -// Fields belonging to the indicated view will be returned. +// fields belonging to the indicated view are returned. // // Possible values: // "LABEL_VIEW_BASIC" - Implies the field mask: @@ -1740,7 +1746,7 @@ func (c *LabelsGetCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabels } return ret, nil // { - // "description": "Get a Label by its resource name. Resource name may be any of: * `labels/{id}` - See to `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the Label. * `labels/{id}@published` - Gets the current published revision of the Label. * `labels/{id}@{revision_id}` - Gets the Label at the specified revision ID.", + // "description": "Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.", // "flatPath": "v2/labels/{labelsId}", // "httpMethod": "GET", // "id": "drivelabels.labels.get", @@ -1749,7 +1755,7 @@ func (c *LabelsGetCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabels // ], // "parameters": { // "languageCode": { - // "description": "The BCP-47 language code to use for evaluating localized Field labels. When not specified, values in the default configured language will be used.", + // "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", // "location": "query", // "type": "string" // }, @@ -1761,12 +1767,12 @@ func (c *LabelsGetCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabels // "type": "string" // }, // "useAdminAccess": { - // "description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.", + // "description": "Set to `true` in order to use the user's admin credentials. The server verifies that the user is an admin for the label before allowing access.", // "location": "query", // "type": "boolean" // }, // "view": { - // "description": "When specified, only certain Fields belonging to the indicated view will be returned.", + // "description": "When specified, only certain fields belonging to the indicated view are returned.", // "enum": [ // "LABEL_VIEW_BASIC", // "LABEL_VIEW_FULL" @@ -1797,11 +1803,7 @@ type LabelsListCall struct { header_ http.Header } -// List: -// ---------------------------------------------------------------------- -// ---- ## Label APIs -// --------------------------------------------------------------- List -// Labels. +// List: List labels. func (r *LabelsService) List() *LabelsListCall { c := &LabelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -1809,7 +1811,7 @@ func (r *LabelsService) List() *LabelsListCall { // LanguageCode sets the optional parameter "languageCode": The BCP-47 // language code to use for evaluating localized field labels. When not -// specified, values in the default configured language will be used. +// specified, values in the default configured language are used. func (c *LabelsListCall) LanguageCode(languageCode string) *LabelsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -1821,14 +1823,14 @@ func (c *LabelsListCall) LanguageCode(languageCode string) *LabelsListCall { // // Possible values: // "LABEL_ROLE_UNSPECIFIED" - Unknown role. -// "READER" - A reader can read the Label and associated metadata +// "READER" - A reader can read the label and associated metadata // applied to Drive items. // "APPLIER" - An applier can write associated metadata on Drive items // in which they also have write access to. Implies `READER`. -// "ORGANIZER" - An organizer is allowed to pin this label in shared -// drives they manage and add new appliers to the label. -// "EDITOR" - Editors may make any updates including deleting the -// Label which will also delete associated Drive item metadata. Implies +// "ORGANIZER" - An organizer can pin this label in shared drives they +// manage and add new appliers to the label. +// "EDITOR" - Editors can make any update including deleting the label +// which also deletes the associated Drive item metadata. Implies // `APPLIER`. func (c *LabelsListCall) MinimumRole(minimumRole string) *LabelsListCall { c.urlParams_.Set("minimumRole", minimumRole) @@ -1836,7 +1838,7 @@ func (c *LabelsListCall) MinimumRole(minimumRole string) *LabelsListCall { } // PageSize sets the optional parameter "pageSize": Maximum number of -// Labels to return per page. Default: 50. Max: 200. +// labels to return per page. Default: 50. Max: 200. func (c *LabelsListCall) PageSize(pageSize int64) *LabelsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -1851,11 +1853,11 @@ func (c *LabelsListCall) PageToken(pageToken string) *LabelsListCall { // PublishedOnly sets the optional parameter "publishedOnly": Whether to // include only published labels in the results. * When `true`, only the -// current published label revisions will be returned. Disabled labels -// will be included. Returned Label resource names will reference the -// published revision (`labels/{id}/{revision_id}`). * When `false`, the -// current label revisions will be returned, which may not by published. -// Returned Label resource names will not reference a specific revision +// current published label revisions are returned. Disabled labels are +// included. Returned label resource names reference the published +// revision (`labels/{id}/{revision_id}`). * When `false`, the current +// label revisions are returned, which might not be published. Returned +// label resource names don't reference a specific revision // (`labels/{id}`). func (c *LabelsListCall) PublishedOnly(publishedOnly bool) *LabelsListCall { c.urlParams_.Set("publishedOnly", fmt.Sprint(publishedOnly)) @@ -1871,7 +1873,7 @@ func (c *LabelsListCall) UseAdminAccess(useAdminAccess bool) *LabelsListCall { } // View sets the optional parameter "view": When specified, only certain -// fields belonging to the indicated view will be returned. +// fields belonging to the indicated view are returned. // // Possible values: // "LABEL_VIEW_BASIC" - Implies the field mask: @@ -1980,14 +1982,14 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel } return ret, nil // { - // "description": "-------------------------------------------------------------------------- ## Label APIs --------------------------------------------------------------- List Labels.", + // "description": "List labels.", // "flatPath": "v2/labels", // "httpMethod": "GET", // "id": "drivelabels.labels.list", // "parameterOrder": [], // "parameters": { // "languageCode": { - // "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.", + // "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", // "location": "query", // "type": "string" // }, @@ -2002,16 +2004,16 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel // ], // "enumDescriptions": [ // "Unknown role.", - // "A reader can read the Label and associated metadata applied to Drive items.", + // "A reader can read the label and associated metadata applied to Drive items.", // "An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`.", - // "An organizer is allowed to pin this label in shared drives they manage and add new appliers to the label.", - // "Editors may make any updates including deleting the Label which will also delete associated Drive item metadata. Implies `APPLIER`." + // "An organizer can pin this label in shared drives they manage and add new appliers to the label.", + // "Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`." // ], // "location": "query", // "type": "string" // }, // "pageSize": { - // "description": "Maximum number of Labels to return per page. Default: 50. Max: 200.", + // "description": "Maximum number of labels to return per page. Default: 50. Max: 200.", // "format": "int32", // "location": "query", // "type": "integer" @@ -2022,7 +2024,7 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel // "type": "string" // }, // "publishedOnly": { - // "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions will be returned. Disabled labels will be included. Returned Label resource names will reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions will be returned, which may not by published. Returned Label resource names will not reference a specific revision (`labels/{id}`).", + // "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (`labels/{id}`).", // "location": "query", // "type": "boolean" // }, @@ -2032,7 +2034,7 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel // "type": "boolean" // }, // "view": { - // "description": "When specified, only certain fields belonging to the indicated view will be returned.", + // "description": "When specified, only certain fields belonging to the indicated view are returned.", // "enum": [ // "LABEL_VIEW_BASIC", // "LABEL_VIEW_FULL" diff --git a/drivelabels/v2beta/drivelabels-api.json b/drivelabels/v2beta/drivelabels-api.json index 2cb007fdcb1..9522006fdb0 100644 --- a/drivelabels/v2beta/drivelabels-api.json +++ b/drivelabels/v2beta/drivelabels-api.json @@ -232,7 +232,7 @@ } }, "get": { - "description": "Get a Label by its resource name. Resource name may be any of: * `labels/{id}` - See to `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the Label. * `labels/{id}@published` - Gets the current published revision of the Label. * `labels/{id}@{revision_id}` - Gets the Label at the specified revision ID.", + "description": "Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.", "flatPath": "v2beta/labels/{labelsId}", "httpMethod": "GET", "id": "drivelabels.labels.get", @@ -241,7 +241,7 @@ ], "parameters": { "languageCode": { - "description": "The BCP-47 language code to use for evaluating localized Field labels. When not specified, values in the default configured language will be used.", + "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", "location": "query", "type": "string" }, @@ -253,12 +253,12 @@ "type": "string" }, "useAdminAccess": { - "description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.", + "description": "Set to `true` in order to use the user's admin credentials. The server verifies that the user is an admin for the label before allowing access.", "location": "query", "type": "boolean" }, "view": { - "description": "When specified, only certain Fields belonging to the indicated view will be returned.", + "description": "When specified, only certain fields belonging to the indicated view are returned.", "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" @@ -277,14 +277,14 @@ } }, "list": { - "description": "-------------------------------------------------------------------------- ## Label APIs --------------------------------------------------------------- List Labels.", + "description": "List labels.", "flatPath": "v2beta/labels", "httpMethod": "GET", "id": "drivelabels.labels.list", "parameterOrder": [], "parameters": { "languageCode": { - "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.", + "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", "location": "query", "type": "string" }, @@ -299,16 +299,16 @@ ], "enumDescriptions": [ "Unknown role.", - "A reader can read the Label and associated metadata applied to Drive items.", + "A reader can read the label and associated metadata applied to Drive items.", "An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`.", - "An organizer is allowed to pin this label in shared drives they manage and add new appliers to the label.", - "Editors may make any updates including deleting the Label which will also delete associated Drive item metadata. Implies `APPLIER`." + "An organizer can pin this label in shared drives they manage and add new appliers to the label.", + "Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`." ], "location": "query", "type": "string" }, "pageSize": { - "description": "Maximum number of Labels to return per page. Default: 50. Max: 200.", + "description": "Maximum number of labels to return per page. Default: 50. Max: 200.", "format": "int32", "location": "query", "type": "integer" @@ -319,7 +319,7 @@ "type": "string" }, "publishedOnly": { - "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions will be returned. Disabled labels will be included. Returned Label resource names will reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions will be returned, which may not by published. Returned Label resource names will not reference a specific revision (`labels/{id}`).", + "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (`labels/{id}`).", "location": "query", "type": "boolean" }, @@ -329,7 +329,7 @@ "type": "boolean" }, "view": { - "description": "When specified, only certain fields belonging to the indicated view will be returned.", + "description": "When specified, only certain fields belonging to the indicated view are returned.", "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" @@ -888,26 +888,26 @@ } } }, - "revision": "20220726", + "revision": "20220802", "rootUrl": "https://drivelabels.googleapis.com/", "schemas": { "GoogleAppsDriveLabelsV2betaBadgeColors": { - "description": "The color derived from BadgeConfig and coerced to the nearest supported color.", + "description": "The color derived from BadgeConfig and changed to the closest recommended supported color.", "id": "GoogleAppsDriveLabelsV2betaBadgeColors", "properties": { "backgroundColor": { "$ref": "GoogleTypeColor", - "description": "Output only. Badge background which pairs with the foreground", + "description": "Output only. Badge background that pairs with the foreground.", "readOnly": true }, "foregroundColor": { "$ref": "GoogleTypeColor", - "description": "Output only. Badge foreground which pairs with the background", + "description": "Output only. Badge foreground that pairs with the background.", "readOnly": true }, "soloColor": { "$ref": "GoogleTypeColor", - "description": "Output only. Color that can be used for text without a background", + "description": "Output only. Color that can be used for text without a background.", "readOnly": true } }, @@ -919,10 +919,10 @@ "properties": { "color": { "$ref": "GoogleTypeColor", - "description": "The color of the badge. When not specified, no badge will be rendered. This color will be coerced into the closest recommended supported color." + "description": "The color of the badge. When not specified, no badge is rendered. The background, foreground, and solo (light and dark mode) colors set here are changed in the Drive UI into the closest recommended supported color." }, "priorityOverride": { - "description": "Override the default global priority of this badge. When set to 0, the default priority heuristic will be used.", + "description": "Override the default global priority of this badge. When set to 0, the default priority heuristic is used.", "format": "int64", "type": "string" } @@ -1548,12 +1548,12 @@ "type": "object" }, "GoogleAppsDriveLabelsV2betaField": { - "description": "Defines a field which has a display name, data type, and other configuration options. This field defines the kind of metadata that may be set on a Drive item.", + "description": "Defines a field that has a display name, data type, and other configuration options. This field defines the kind of metadata that may be set on a Drive item.", "id": "GoogleAppsDriveLabelsV2betaField", "properties": { "appliedCapabilities": { "$ref": "GoogleAppsDriveLabelsV2betaFieldAppliedCapabilities", - "description": "Output only. The capabilities this user has on this Field and its value when the Label is applied on Drive items.", + "description": "Output only. The capabilities this user has on this field and its value when the label is applied on Drive items.", "readOnly": true }, "createTime": { @@ -1584,11 +1584,11 @@ }, "displayHints": { "$ref": "GoogleAppsDriveLabelsV2betaFieldDisplayHints", - "description": "Output only. UI Display hints for rendering a Field.", + "description": "Output only. UI display hints for rendering a field.", "readOnly": true }, "id": { - "description": "Output only. The key of a field, unique within a Label or Library. This value is autogenerated, and will match the form `([a-zA-Z0-9_])+", + "description": "Output only. The key of a field, unique within a label or library. This value is autogenerated. Matches the regex: `([a-zA-Z0-9])+`", "readOnly": true, "type": "string" }, @@ -1598,7 +1598,7 @@ }, "lifecycle": { "$ref": "GoogleAppsDriveLabelsV2betaLifecycle", - "description": "Output only. The lifecycle of this Field.", + "description": "Output only. The lifecycle of this field.", "readOnly": true }, "lockStatus": { @@ -1616,13 +1616,13 @@ "readOnly": true }, "queryKey": { - "description": "Output only. The key to use when constructing Drive search queries to find files based on values defined for this Field on files. For example: \"`{query_key}` \u003e 2001-01-01\"", + "description": "Output only. The key to use when constructing Drive search queries to find files based on values defined for this field on files. For example, \"`{query_key}` \u003e 2001-01-01\".", "readOnly": true, "type": "string" }, "schemaCapabilities": { "$ref": "GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities", - "description": "Output only. The capabilities this user has when editing this Field", + "description": "Output only. The capabilities this user has when editing this field.", "readOnly": true }, "selectionOptions": { @@ -1660,11 +1660,11 @@ "type": "boolean" }, "canSearch": { - "description": "Whether the user can search for drive items referencing this field.", + "description": "Whether the user can search for Drive items referencing this field.", "type": "boolean" }, "canWrite": { - "description": "Whether the user can set this field on drive items.", + "description": "Whether the user can set this field on Drive items.", "type": "boolean" } }, @@ -1675,12 +1675,12 @@ "id": "GoogleAppsDriveLabelsV2betaFieldDateOptions", "properties": { "dateFormat": { - "description": "Output only. ICU Date format.", + "description": "Output only. ICU date format.", "readOnly": true, "type": "string" }, "dateFormatType": { - "description": "Localized date formatting option. Field values will be rendered in this format according to their locale.", + "description": "Localized date formatting option. Field values are rendered in this format according to their locale.", "enum": [ "DATE_FORMAT_UNSPECIFIED", "LONG_DATE", @@ -1688,8 +1688,8 @@ ], "enumDescriptions": [ "Date format unspecified.", - "Includes full month name. e.g. January 12, 1999 MMMM d, y", - "Short, numeric, representation. e.g. 12/13/99 M/d/yy" + "Includes full month name. For example, January 12, 1999 (MMMM d, y)", + "Short, numeric, representation. For example, 12/13/99 (M/d/yy)" ], "type": "string" }, @@ -1707,7 +1707,7 @@ "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldDisplayHints": { - "description": "UI Display hints for rendering a Field.", + "description": "UI display hints for rendering a field.", "id": "GoogleAppsDriveLabelsV2betaFieldDisplayHints", "properties": { "disabled": { @@ -1715,15 +1715,15 @@ "type": "boolean" }, "hiddenInSearch": { - "description": "This Field should be hidden in the search menu.", + "description": "This field should be hidden in the search menu when searching for Drive items.", "type": "boolean" }, "required": { - "description": "Whether the Field should be shown as required in the UI.", + "description": "Whether the field should be shown as required in the UI.", "type": "boolean" }, "shownInApply": { - "description": "This Field should be shown when applying values to a Drive item.", + "description": "This field should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" } }, @@ -1834,7 +1834,7 @@ "type": "string" }, "insertBeforeField": { - "description": "Input only. Insert or move this Field to be ordered before the indicated Field. If empty, the Field will be placed at the end of the list.", + "description": "Input only. Insert or move this field before the indicated field. If empty, the field is placed at the end of the list.", "type": "string" }, "required": { @@ -1845,19 +1845,19 @@ "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities": { - "description": "The capabilities related to this Field when editing the Field.", + "description": "The capabilities related to this field when editing the field.", "id": "GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities", "properties": { "canDelete": { - "description": "Whether the user can delete this Field. The user must have permissions and the Field must be deprecated.", + "description": "Whether the user can delete this field. The user must have permission and the field must be deprecated.", "type": "boolean" }, "canDisable": { - "description": "Whether the user can disable this Field. The user must have permissions and this Field must not already be disabled.", + "description": "Whether the user can disable this field. The user must have permission and this field must not already be disabled.", "type": "boolean" }, "canEnable": { - "description": "Whether the user can enable this Field. The user must have permissions and this Field must be disabled.", + "description": "Whether the user can enable this field. The user must have permission and this field must be disabled.", "type": "boolean" }, "canUpdate": { @@ -1880,74 +1880,74 @@ }, "listOptions": { "$ref": "GoogleAppsDriveLabelsV2betaFieldListOptions", - "description": "When specified, indicates that this field support a list of values. Once the field is published, this cannot be changed." + "description": "When specified, indicates this field supports a list of values. Once the field is published, this cannot be changed." } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice": { - "description": "Selection field Choice.", + "description": "Selection field choice.", "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice", "properties": { "appliedCapabilities": { "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities", - "description": "Output only. The capabilities related to this Choice on applied metadata.", + "description": "Output only. The capabilities related to this choice on applied metadata.", "readOnly": true }, "createTime": { - "description": "Output only. The time this Choice was created.", + "description": "Output only. The time this choice was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "creator": { "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", - "description": "Output only. The user who created this Choice.", + "description": "Output only. The user who created this choice.", "readOnly": true }, "disableTime": { - "description": "Output only. The time this Choice was disabled. This value has no meaning when the Choice is not disabled.", + "description": "Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.", "format": "google-datetime", "readOnly": true, "type": "string" }, "disabler": { "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", - "description": "Output only. The user who disabled this Choice. This value has no meaning when the option is not disabled.", + "description": "Output only. The user who disabled this choice. This value has no meaning when the option is not disabled.", "readOnly": true }, "displayHints": { "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints", - "description": "Output only. UI Display hints for rendering a Choice.", + "description": "Output only. UI display hints for rendering a choice.", "readOnly": true }, "id": { - "description": "The unique value of the Choice. This ID will be autogenerated, and will match the form `([a-zA-Z0-9_])+`.", + "description": "The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.", "type": "string" }, "lifecycle": { "$ref": "GoogleAppsDriveLabelsV2betaLifecycle", - "description": "Output only. Lifecycle of the Choice.", + "description": "Output only. Lifecycle of the choice.", "readOnly": true }, "lockStatus": { "$ref": "GoogleAppsDriveLabelsV2betaLockStatus", - "description": "Output only. The LockStatus of this Choice.", + "description": "Output only. The LockStatus of this choice.", "readOnly": true }, "properties": { "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties", - "description": "Basic properties of the Choice." + "description": "Basic properties of the choice." }, "publishTime": { - "description": "Output only. The time this Choice was published. This value has no meaning when the Choice is not published.", + "description": "Output only. The time this choice was published. This value has no meaning when the choice is not published.", "format": "google-datetime", "readOnly": true, "type": "string" }, "publisher": { "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", - "description": "Output only. The user who published this Choice. This value has no meaning when the Choice is not published.", + "description": "Output only. The user who published this choice. This value has no meaning when the choice is not published.", "readOnly": true }, "schemaCapabilities": { @@ -1956,21 +1956,21 @@ "readOnly": true }, "updateTime": { - "description": "Output only. The time this Choice was updated last.", + "description": "Output only. The time this choice was updated last.", "format": "google-datetime", "readOnly": true, "type": "string" }, "updater": { "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", - "description": "Output only. The user who updated this Choice last.", + "description": "Output only. The user who updated this choice last.", "readOnly": true } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities": { - "description": "The capabilities related to this Choice on applied metadata.", + "description": "The capabilities related to this choice on applied metadata.", "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities", "properties": { "canRead": { @@ -1978,58 +1978,58 @@ "type": "boolean" }, "canSearch": { - "description": "Whether the user can use this Choice in search queries.", + "description": "Whether the user can use this choice in search queries.", "type": "boolean" }, "canSelect": { - "description": "Whether the user can select this Choice on an item.", + "description": "Whether the user can select this choice on an item.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints": { - "description": "UI Display hints for rendering a Option.", + "description": "UI display hints for rendering an option.", "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints", "properties": { "badgeColors": { "$ref": "GoogleAppsDriveLabelsV2betaBadgeColors", - "description": "The colors to use for the badge. Coerced to Google Material colors based on the chosen `properties.badge_config.color`." + "description": "The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`." }, "badgePriority": { - "description": "The priority of this badge, used to compare and sort between multiple badges. A lower number means that the badge should be shown first. When a badging configuration is not present, this will be 0. Otherwise, this will be set to `BadgeConfig.priority_override` or the default heuristic which prefers creation date of the Label, and field and option priority.", + "description": "The priority of this badge. Used to compare and sort between multiple badges. A lower number means the badge should be shown first. When a badging configuration is not present, this will be 0. Otherwise, this will be set to `BadgeConfig.priority_override` or the default heuristic which prefers creation date of the label, and field and option priority.", "format": "int64", "type": "string" }, "darkBadgeColors": { "$ref": "GoogleAppsDriveLabelsV2betaBadgeColors", - "description": "The dark-mode color to use for the badge. Coerced to Google Material colors based on the chosen `properties.badge_config.color`." + "description": "The dark-mode color to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`." }, "disabled": { "description": "Whether the option should be shown in the UI as disabled.", "type": "boolean" }, "hiddenInSearch": { - "description": "This option should be hidden in the search menu.", + "description": "This option should be hidden in the search menu when searching for Drive items.", "type": "boolean" }, "shownInApply": { - "description": "This option should be shown in the menu when applying values to a Drive item.", + "description": "This option should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties": { - "description": "Basic properties of the Choice.", + "description": "Basic properties of the choice.", "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties", "properties": { "badgeConfig": { "$ref": "GoogleAppsDriveLabelsV2betaBadgeConfig", - "description": "The badge configuration for this Choice. When set, the Label that owns this Choice will be considered a \"badged label\"." + "description": "The badge configuration for this choice. When set, the label that owns this choice is considered a \"badged label\"." }, "description": { - "description": "The description of this Label.", + "description": "The description of this label.", "type": "string" }, "displayName": { @@ -2037,30 +2037,30 @@ "type": "string" }, "insertBeforeChoice": { - "description": "Input only. Insert or move this Choice to be ordered before the indicated Choice. If empty, the Choice will be placed at the end of the list.", + "description": "Input only. Insert or move this choice before the indicated choice. If empty, the choice is placed at the end of the list.", "type": "string" } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabilities": { - "description": "The capabilities related to this Choice when editing the Choice.", + "description": "The capabilities related to this choice when editing the choice.", "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabilities", "properties": { "canDelete": { - "description": "Whether the user can delete this Choice.", + "description": "Whether the user can delete this choice.", "type": "boolean" }, "canDisable": { - "description": "Whether the user can disable this Chioce.", + "description": "Whether the user can disable this choice.", "type": "boolean" }, "canEnable": { - "description": "Whether the user can enable this Choice.", + "description": "Whether the user can enable this choice.", "type": "boolean" }, "canUpdate": { - "description": "Whether the user can update this Choice.", + "description": "Whether the user can update this choice.", "type": "boolean" } }, @@ -2091,7 +2091,7 @@ "properties": { "listOptions": { "$ref": "GoogleAppsDriveLabelsV2betaFieldListOptions", - "description": "When specified, indicates that this field support a list of values. Once the field is published, this cannot be changed." + "description": "When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed." } }, "type": "object" @@ -2114,7 +2114,7 @@ "type": "object" }, "GoogleAppsDriveLabelsV2betaLabel": { - "description": "A Label defines a taxonomy which may be applied to a Drive items in order to organize and search across Items. Labels may be simple strings, or may contain Fields that describe additional metadata which can be further used to organize and search Drive items.", + "description": "A label defines a taxonomy that can be applied to Drive items in order to organize and search across items. Labels can be simple strings, or can contain fields that describe additional metadata that can be further used to organize and search Drive items.", "id": "GoogleAppsDriveLabelsV2betaLabel", "properties": { "appliedCapabilities": { @@ -2124,7 +2124,7 @@ }, "appliedLabelPolicy": { "$ref": "GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy", - "description": "Output only. Behavior of this Label when its applied to Drive items.", + "description": "Output only. Behavior of this label when it's applied to Drive items.", "readOnly": true }, "createTime": { @@ -2151,23 +2151,23 @@ }, "displayHints": { "$ref": "GoogleAppsDriveLabelsV2betaLabelDisplayHints", - "description": "Output only. UI Display hints for rendering the Label.", + "description": "Output only. UI display hints for rendering the label.", "readOnly": true }, "fields": { - "description": "List of Fields in descending priority order.", + "description": "List of fields in descending priority order.", "items": { "$ref": "GoogleAppsDriveLabelsV2betaField" }, "type": "array" }, "id": { - "description": "Output only. Globally unique identifier of this Label. ID makes up part of the Label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`", + "description": "Output only. Globally unique identifier of this label. ID makes up part of the label `name`, but unlike `name`, ID is consistent between revisions. Matches the regex: `([a-zA-Z0-9])+`", "readOnly": true, "type": "string" }, "labelType": { - "description": "Required. The type of this label.", + "description": "Required. The type of label.", "enum": [ "LABEL_TYPE_UNSPECIFIED", "SHARED", @@ -2176,7 +2176,7 @@ "enumDescriptions": [ "Unknown label type.", "Shared labels may be shared with users to apply to Drive items.", - "Admin owned label. Only creatable and editable by admins, supports some additional admin-only features." + "Admin-owned label. Only creatable and editable by admins. Supports some additional admin-only features." ], "type": "string" }, @@ -2195,13 +2195,13 @@ "readOnly": true }, "name": { - "description": "Output only. Resource name of the Label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.", + "description": "Output only. Resource name of the label. Will be in the form of either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the request. See `id` and `revision_id` below.", "readOnly": true, "type": "string" }, "properties": { "$ref": "GoogleAppsDriveLabelsV2betaLabelProperties", - "description": "Required. The basic properties of the Label." + "description": "Required. The basic properties of the label." }, "publishTime": { "description": "Output only. The time this label was published. This value has no meaning when the label is not published.", @@ -2226,24 +2226,24 @@ "readOnly": true }, "revisionId": { - "description": "Output only. Revision ID of the Label. Revision ID may be part of the Label `name` depending on the request issued. A new revision is created whenever revisioned properties of a Label are changed. Matches the regex: `([a-zA-Z0-9])+`", + "description": "Output only. Revision ID of the label. Revision ID might be part of the label `name` depending on the request issued. A new revision is created whenever revisioned properties of a label are changed. Matches the regex: `([a-zA-Z0-9])+`", "readOnly": true, "type": "string" }, "schemaCapabilities": { "$ref": "GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities", - "description": "Output only. The capabilities the user has on this Label.", + "description": "Output only. The capabilities the user has on this label.", "readOnly": true } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities": { - "description": "The capabilities a user has on this Label's applied metadata.", + "description": "The capabilities a user has on this label's applied metadata.", "id": "GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities", "properties": { "canApply": { - "description": "Whether the user can apply this Label to items.", + "description": "Whether the user can apply this label to items.", "type": "boolean" }, "canRead": { @@ -2251,18 +2251,18 @@ "type": "boolean" }, "canRemove": { - "description": "Whether the user can remove this Label from items.", + "description": "Whether the user can remove this label from items.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy": { - "description": "Behavior of this Label when its applied to Drive items.", + "description": "Behavior of this label when it's applied to Drive items.", "id": "GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy", "properties": { "copyMode": { - "description": "Indicates how the applied Label, and Field values should be copied when a Drive item is copied.", + "description": "Indicates how the applied label and field values should be copied when a Drive item is copied.", "enum": [ "COPY_MODE_UNSPECIFIED", "DO_NOT_COPY", @@ -2271,9 +2271,9 @@ ], "enumDescriptions": [ "Copy mode unspecified.", - "The applied Label and Field values will not be copied by default when the Drive item it is applied to is copied.", - "The applied Label and Field values will always be copied when the Drive item it is applied to is copied. Only admins may use this mode.", - "The applied Label and Field values will be copied if and only if the label is appliable by the user making the copy." + "The applied label and field values are not copied by default when the Drive item it's applied to is copied.", + "The applied label and field values are always copied when the Drive item it's applied to is copied. Only admins can use this mode.", + "The applied label and field values are copied if the label is appliable by the user making the copy." ], "type": "string" } @@ -2281,24 +2281,24 @@ "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelDisplayHints": { - "description": "UI Display hints for rendering the Label.", + "description": "UI display hints for rendering the label.", "id": "GoogleAppsDriveLabelsV2betaLabelDisplayHints", "properties": { "disabled": { - "description": "Whether the Label should be shown in the UI as disabled.", + "description": "Whether the label should be shown in the UI as disabled.", "type": "boolean" }, "hiddenInSearch": { - "description": "This Label should be hidden in the search menu when searching for Drive items.", + "description": "This label should be hidden in the search menu when searching for Drive items.", "type": "boolean" }, "priority": { - "description": "Order to display label in a list", + "description": "Order to display label in a list.", "format": "int64", "type": "string" }, "shownInApply": { - "description": "This Label should be shown in the apply menu.", + "description": "This label should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" } }, @@ -2452,10 +2452,10 @@ ], "enumDescriptions": [ "Unknown role.", - "A reader can read the Label and associated metadata applied to Drive items.", + "A reader can read the label and associated metadata applied to Drive items.", "An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`.", - "An organizer is allowed to pin this label in shared drives they manage and add new appliers to the label.", - "Editors may make any updates including deleting the Label which will also delete associated Drive item metadata. Implies `APPLIER`." + "An organizer can pin this label in shared drives they manage and add new appliers to the label.", + "Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`." ], "type": "string" } @@ -2463,45 +2463,45 @@ "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelProperties": { - "description": "Basic properties of the Label.", + "description": "Basic properties of the label.", "id": "GoogleAppsDriveLabelsV2betaLabelProperties", "properties": { "description": { - "description": "The description of this Label.", + "description": "The description of the label.", "type": "string" }, "title": { - "description": "Required. Title of the Label.", + "description": "Required. Title of the label.", "type": "string" } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities": { - "description": "The capabilities related to this Label when editing the Label.", + "description": "The capabilities related to this label when editing the label.", "id": "GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities", "properties": { "canDelete": { - "description": "Whether the user can delete this Label. The user must have permission and the Label must be disabled.", + "description": "Whether the user can delete this label. The user must have permission and the label must be disabled.", "type": "boolean" }, "canDisable": { - "description": "Whether the user can disable this Label. The user must have permission and this Label must not already be disabled.", + "description": "Whether the user can disable this label. The user must have permission and this label must not already be disabled.", "type": "boolean" }, "canEnable": { - "description": "Whether the user can enable this Label. The user must have permission and this Label must be disabled.", + "description": "Whether the user can enable this label. The user must have permission and this label must be disabled.", "type": "boolean" }, "canUpdate": { - "description": "Whether the user can change this Label.", + "description": "Whether the user can change this label.", "type": "boolean" } }, "type": "object" }, "GoogleAppsDriveLabelsV2betaLifecycle": { - "description": "The lifecycle state of an object, e.g. Label, Field, or Choice. The Lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -\u003e `PUBLISHED` * `UNPUBLISHED_DRAFT` -\u003e (Deleted) * `PUBLISHED` -\u003e `DISABLED` * `DISABLED` -\u003e `PUBLISHED` * `DISABLED` -\u003e (Deleted) The published and disabled states have some distinct characteristics: * Published - Some kinds of changes may be made to an object in this state, in which case `has_unpublished_changes` will be true. Some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. * Disabled - When disabled, the configured `DisabledPolicy` will take effect.", + "description": "The lifecycle state of an object, such as label, field, or choice. The lifecycle enforces the following transitions: * `UNPUBLISHED_DRAFT` (starting state) * `UNPUBLISHED_DRAFT` -\u003e `PUBLISHED` * `UNPUBLISHED_DRAFT` -\u003e (Deleted) * `PUBLISHED` -\u003e `DISABLED` * `DISABLED` -\u003e `PUBLISHED` * `DISABLED` -\u003e (Deleted) The published and disabled states have some distinct characteristics: * Published—Some kinds of changes might be made to an object in this state, in which case `has_unpublished_changes` will be true. Also, some kinds of changes are not permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label are rejected. * Disabled—When disabled, the configured `DisabledPolicy` takes effect.", "id": "GoogleAppsDriveLabelsV2betaLifecycle", "properties": { "disabledPolicy": { @@ -2524,10 +2524,10 @@ ], "enumDescriptions": [ "Unknown State.", - "The initial state of an object. Once published, the object may never return to this state. Once an object is published, certain kinds of changes are no longer permitted.", - "The object has been published. The object may have unpublished draft changes as indicated by `has_unpublished_changes`.", - "The object has been published, and has since been disabled. The object may have unpublished draft changes as indicated by `has_unpublished_changes`.", - "The object has been deleted" + "The initial state of an object. Once published, the object can never return to this state. Once an object is published, certain kinds of changes are no longer permitted.", + "The object has been published. The object might have unpublished draft changes as indicated by `has_unpublished_changes`.", + "The object has been published and has since been disabled. The object might have unpublished draft changes as indicated by `has_unpublished_changes`.", + "The object has been deleted." ], "readOnly": true, "type": "string" @@ -2540,11 +2540,11 @@ "id": "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy", "properties": { "hideInSearch": { - "description": "Whether to hide this disabled object in the search menu for Drive items. * When `false` the object will generally be shown in the UI as disabled (but still permit searching) when searching for Drive items. * When `true` the object will generally be hidden in the UI when searching for Drive items.", + "description": "Whether to hide this disabled object in the search menu for Drive items. * When `false`, the object is generally shown in the UI as disabled but it appears in the search results when searching for Drive items. * When `true`, the object is generally hidden in the UI when searching for Drive items.", "type": "boolean" }, "showInApply": { - "description": "Whether to show this disabled object in the apply menu on Drive items. * When `true` the object will generally be shown in the UI as disabled and is unselectable. * When `false` the object will generally be hidden in the UI.", + "description": "Whether to show this disabled object in the apply menu on Drive items. * When `true`, the object is generally shown in the UI as disabled and is unselectable. * When `false`, the object is generally hidden in the UI.", "type": "boolean" } }, @@ -2621,7 +2621,7 @@ "id": "GoogleAppsDriveLabelsV2betaLockStatus", "properties": { "locked": { - "description": "Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component may be implicitly locked even if it is not the direct target of a LabelLock, in which case this field will be false.", + "description": "Output only. Indicates whether this label component is the (direct) target of a LabelLock. A label component can be implicitly locked even if it's not the direct target of a LabelLock, in which case this field is set to false.", "readOnly": true, "type": "boolean" } @@ -2726,9 +2726,9 @@ ], "enumDescriptions": [ "Copy mode unspecified.", - "The applied Label and Field values will not be copied by default when the Drive item it is applied to is copied.", - "The applied Label and Field values will always be copied when the Drive item it is applied to is copied. Only admins may use this mode.", - "The applied Label and Field values will be copied if and only if the label is appliable by the user making the copy." + "The applied label and field values are not copied by default when the Drive item it's applied to is copied.", + "The applied label and field values are always copied when the Drive item it's applied to is copied. Only admins can use this mode.", + "The applied label and field values are copied if the label is appliable by the user making the copy." ], "type": "string" }, @@ -2811,7 +2811,7 @@ "id": "GoogleAppsDriveLabelsV2betaUserInfo", "properties": { "person": { - "description": "The identifier for this user who can be used with the People API to get more information. e.g. people/12345678", + "description": "The identifier for this user that can be used with the People API to get more information. For example, people/12345678.", "type": "string" } }, diff --git a/drivelabels/v2beta/drivelabels-gen.go b/drivelabels/v2beta/drivelabels-gen.go index 2e314863d38..fca5d2fddea 100644 --- a/drivelabels/v2beta/drivelabels-gen.go +++ b/drivelabels/v2beta/drivelabels-gen.go @@ -219,18 +219,18 @@ type UsersService struct { } // GoogleAppsDriveLabelsV2betaBadgeColors: The color derived from -// BadgeConfig and coerced to the nearest supported color. +// BadgeConfig and changed to the closest recommended supported color. type GoogleAppsDriveLabelsV2betaBadgeColors struct { - // BackgroundColor: Output only. Badge background which pairs with the - // foreground + // BackgroundColor: Output only. Badge background that pairs with the + // foreground. BackgroundColor *GoogleTypeColor `json:"backgroundColor,omitempty"` - // ForegroundColor: Output only. Badge foreground which pairs with the - // background + // ForegroundColor: Output only. Badge foreground that pairs with the + // background. ForegroundColor *GoogleTypeColor `json:"foregroundColor,omitempty"` // SoloColor: Output only. Color that can be used for text without a - // background + // background. SoloColor *GoogleTypeColor `json:"soloColor,omitempty"` // ForceSendFields is a list of field names (e.g. "BackgroundColor") to @@ -259,13 +259,14 @@ func (s *GoogleAppsDriveLabelsV2betaBadgeColors) MarshalJSON() ([]byte, error) { // GoogleAppsDriveLabelsV2betaBadgeConfig: Badge status of the label. type GoogleAppsDriveLabelsV2betaBadgeConfig struct { - // Color: The color of the badge. When not specified, no badge will be - // rendered. This color will be coerced into the closest recommended - // supported color. + // Color: The color of the badge. When not specified, no badge is + // rendered. The background, foreground, and solo (light and dark mode) + // colors set here are changed in the Drive UI into the closest + // recommended supported color. Color *GoogleTypeColor `json:"color,omitempty"` // PriorityOverride: Override the default global priority of this badge. - // When set to 0, the default priority heuristic will be used. + // When set to 0, the default priority heuristic is used. PriorityOverride int64 `json:"priorityOverride,omitempty,string"` // ForceSendFields is a list of field names (e.g. "Color") to @@ -1377,12 +1378,12 @@ func (s *GoogleAppsDriveLabelsV2betaEnableLabelRequest) MarshalJSON() ([]byte, e return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2betaField: Defines a field which has a display +// GoogleAppsDriveLabelsV2betaField: Defines a field that has a display // name, data type, and other configuration options. This field defines // the kind of metadata that may be set on a Drive item. type GoogleAppsDriveLabelsV2betaField struct { // AppliedCapabilities: Output only. The capabilities this user has on - // this Field and its value when the Label is applied on Drive items. + // this field and its value when the label is applied on Drive items. AppliedCapabilities *GoogleAppsDriveLabelsV2betaFieldAppliedCapabilities `json:"appliedCapabilities,omitempty"` // CreateTime: Output only. The time this field was created. @@ -1402,18 +1403,18 @@ type GoogleAppsDriveLabelsV2betaField struct { // has no meaning when the field is not disabled. Disabler *GoogleAppsDriveLabelsV2betaUserInfo `json:"disabler,omitempty"` - // DisplayHints: Output only. UI Display hints for rendering a Field. + // DisplayHints: Output only. UI display hints for rendering a field. DisplayHints *GoogleAppsDriveLabelsV2betaFieldDisplayHints `json:"displayHints,omitempty"` - // Id: Output only. The key of a field, unique within a Label or - // Library. This value is autogenerated, and will match the form - // `([a-zA-Z0-9_])+ + // Id: Output only. The key of a field, unique within a label or + // library. This value is autogenerated. Matches the regex: + // `([a-zA-Z0-9])+` Id string `json:"id,omitempty"` // IntegerOptions: Integer field options. IntegerOptions *GoogleAppsDriveLabelsV2betaFieldIntegerOptions `json:"integerOptions,omitempty"` - // Lifecycle: Output only. The lifecycle of this Field. + // Lifecycle: Output only. The lifecycle of this field. Lifecycle *GoogleAppsDriveLabelsV2betaLifecycle `json:"lifecycle,omitempty"` // LockStatus: Output only. The LockStatus of this field. @@ -1427,12 +1428,12 @@ type GoogleAppsDriveLabelsV2betaField struct { Publisher *GoogleAppsDriveLabelsV2betaUserInfo `json:"publisher,omitempty"` // QueryKey: Output only. The key to use when constructing Drive search - // queries to find files based on values defined for this Field on - // files. For example: "{query_key}` > 2001-01-01" + // queries to find files based on values defined for this field on + // files. For example, "{query_key}` > 2001-01-01". QueryKey string `json:"queryKey,omitempty"` // SchemaCapabilities: Output only. The capabilities this user has when - // editing this Field + // editing this field. SchemaCapabilities *GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities `json:"schemaCapabilities,omitempty"` // SelectionOptions: Selection field options. @@ -1480,11 +1481,11 @@ type GoogleAppsDriveLabelsV2betaFieldAppliedCapabilities struct { // CanRead: Whether the user can read related applied metadata on items. CanRead bool `json:"canRead,omitempty"` - // CanSearch: Whether the user can search for drive items referencing + // CanSearch: Whether the user can search for Drive items referencing // this field. CanSearch bool `json:"canSearch,omitempty"` - // CanWrite: Whether the user can set this field on drive items. + // CanWrite: Whether the user can set this field on Drive items. CanWrite bool `json:"canWrite,omitempty"` // ForceSendFields is a list of field names (e.g. "CanRead") to @@ -1513,17 +1514,18 @@ func (s *GoogleAppsDriveLabelsV2betaFieldAppliedCapabilities) MarshalJSON() ([]b // GoogleAppsDriveLabelsV2betaFieldDateOptions: Options for the date // field type. type GoogleAppsDriveLabelsV2betaFieldDateOptions struct { - // DateFormat: Output only. ICU Date format. + // DateFormat: Output only. ICU date format. DateFormat string `json:"dateFormat,omitempty"` - // DateFormatType: Localized date formatting option. Field values will - // be rendered in this format according to their locale. + // DateFormatType: Localized date formatting option. Field values are + // rendered in this format according to their locale. // // Possible values: // "DATE_FORMAT_UNSPECIFIED" - Date format unspecified. - // "LONG_DATE" - Includes full month name. e.g. January 12, 1999 MMMM - // d, y - // "SHORT_DATE" - Short, numeric, representation. e.g. 12/13/99 M/d/yy + // "LONG_DATE" - Includes full month name. For example, January 12, + // 1999 (MMMM d, y) + // "SHORT_DATE" - Short, numeric, representation. For example, + // 12/13/99 (M/d/yy) DateFormatType string `json:"dateFormatType,omitempty"` // MaxValue: Output only. Maximum valid value (year, month, day). @@ -1555,20 +1557,21 @@ func (s *GoogleAppsDriveLabelsV2betaFieldDateOptions) MarshalJSON() ([]byte, err return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2betaFieldDisplayHints: UI Display hints for -// rendering a Field. +// GoogleAppsDriveLabelsV2betaFieldDisplayHints: UI display hints for +// rendering a field. type GoogleAppsDriveLabelsV2betaFieldDisplayHints struct { // Disabled: Whether the field should be shown in the UI as disabled. Disabled bool `json:"disabled,omitempty"` - // HiddenInSearch: This Field should be hidden in the search menu. + // HiddenInSearch: This field should be hidden in the search menu when + // searching for Drive items. HiddenInSearch bool `json:"hiddenInSearch,omitempty"` - // Required: Whether the Field should be shown as required in the UI. + // Required: Whether the field should be shown as required in the UI. Required bool `json:"required,omitempty"` - // ShownInApply: This Field should be shown when applying values to a - // Drive item. + // ShownInApply: This field should be shown in the apply menu when + // applying values to a Drive item. ShownInApply bool `json:"shownInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "Disabled") to @@ -1752,9 +1755,9 @@ type GoogleAppsDriveLabelsV2betaFieldProperties struct { // this field. DisplayName string `json:"displayName,omitempty"` - // InsertBeforeField: Input only. Insert or move this Field to be - // ordered before the indicated Field. If empty, the Field will be - // placed at the end of the list. + // InsertBeforeField: Input only. Insert or move this field before the + // indicated field. If empty, the field is placed at the end of the + // list. InsertBeforeField string `json:"insertBeforeField,omitempty"` // Required: Whether the field should be marked as required. @@ -1784,18 +1787,18 @@ func (s *GoogleAppsDriveLabelsV2betaFieldProperties) MarshalJSON() ([]byte, erro } // GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities: The capabilities -// related to this Field when editing the Field. +// related to this field when editing the field. type GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities struct { - // CanDelete: Whether the user can delete this Field. The user must have - // permissions and the Field must be deprecated. + // CanDelete: Whether the user can delete this field. The user must have + // permission and the field must be deprecated. CanDelete bool `json:"canDelete,omitempty"` - // CanDisable: Whether the user can disable this Field. The user must - // have permissions and this Field must not already be disabled. + // CanDisable: Whether the user can disable this field. The user must + // have permission and this field must not already be disabled. CanDisable bool `json:"canDisable,omitempty"` - // CanEnable: Whether the user can enable this Field. The user must have - // permissions and this Field must be disabled. + // CanEnable: Whether the user can enable this field. The user must have + // permission and this field must be disabled. CanEnable bool `json:"canEnable,omitempty"` // CanUpdate: Whether the user can change this field. @@ -1831,8 +1834,8 @@ type GoogleAppsDriveLabelsV2betaFieldSelectionOptions struct { // order is consistent, and modified with `insert_before_choice`. Choices []*GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice `json:"choices,omitempty"` - // ListOptions: When specified, indicates that this field support a list - // of values. Once the field is published, this cannot be changed. + // ListOptions: When specified, indicates this field supports a list of + // values. Once the field is published, this cannot be changed. ListOptions *GoogleAppsDriveLabelsV2betaFieldListOptions `json:"listOptions,omitempty"` // ForceSendFields is a list of field names (e.g. "Choices") to @@ -1859,58 +1862,58 @@ func (s *GoogleAppsDriveLabelsV2betaFieldSelectionOptions) MarshalJSON() ([]byte } // GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice: Selection -// field Choice. +// field choice. type GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice struct { // AppliedCapabilities: Output only. The capabilities related to this - // Choice on applied metadata. + // choice on applied metadata. AppliedCapabilities *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities `json:"appliedCapabilities,omitempty"` - // CreateTime: Output only. The time this Choice was created. + // CreateTime: Output only. The time this choice was created. CreateTime string `json:"createTime,omitempty"` - // Creator: Output only. The user who created this Choice. + // Creator: Output only. The user who created this choice. Creator *GoogleAppsDriveLabelsV2betaUserInfo `json:"creator,omitempty"` - // DisableTime: Output only. The time this Choice was disabled. This - // value has no meaning when the Choice is not disabled. + // DisableTime: Output only. The time this choice was disabled. This + // value has no meaning when the choice is not disabled. DisableTime string `json:"disableTime,omitempty"` - // Disabler: Output only. The user who disabled this Choice. This value + // Disabler: Output only. The user who disabled this choice. This value // has no meaning when the option is not disabled. Disabler *GoogleAppsDriveLabelsV2betaUserInfo `json:"disabler,omitempty"` - // DisplayHints: Output only. UI Display hints for rendering a Choice. + // DisplayHints: Output only. UI display hints for rendering a choice. DisplayHints *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints `json:"displayHints,omitempty"` - // Id: The unique value of the Choice. This ID will be autogenerated, - // and will match the form `([a-zA-Z0-9_])+`. + // Id: The unique value of the choice. This ID is autogenerated. Matches + // the regex: `([a-zA-Z0-9_])+`. Id string `json:"id,omitempty"` - // Lifecycle: Output only. Lifecycle of the Choice. + // Lifecycle: Output only. Lifecycle of the choice. Lifecycle *GoogleAppsDriveLabelsV2betaLifecycle `json:"lifecycle,omitempty"` - // LockStatus: Output only. The LockStatus of this Choice. + // LockStatus: Output only. The LockStatus of this choice. LockStatus *GoogleAppsDriveLabelsV2betaLockStatus `json:"lockStatus,omitempty"` - // Properties: Basic properties of the Choice. + // Properties: Basic properties of the choice. Properties *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties `json:"properties,omitempty"` - // PublishTime: Output only. The time this Choice was published. This - // value has no meaning when the Choice is not published. + // PublishTime: Output only. The time this choice was published. This + // value has no meaning when the choice is not published. PublishTime string `json:"publishTime,omitempty"` - // Publisher: Output only. The user who published this Choice. This - // value has no meaning when the Choice is not published. + // Publisher: Output only. The user who published this choice. This + // value has no meaning when the choice is not published. Publisher *GoogleAppsDriveLabelsV2betaUserInfo `json:"publisher,omitempty"` // SchemaCapabilities: Output only. The capabilities related to this // option when editing the option. SchemaCapabilities *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabilities `json:"schemaCapabilities,omitempty"` - // UpdateTime: Output only. The time this Choice was updated last. + // UpdateTime: Output only. The time this choice was updated last. UpdateTime string `json:"updateTime,omitempty"` - // Updater: Output only. The user who updated this Choice last. + // Updater: Output only. The user who updated this choice last. Updater *GoogleAppsDriveLabelsV2betaUserInfo `json:"updater,omitempty"` // ForceSendFields is a list of field names (e.g. "AppliedCapabilities") @@ -1938,15 +1941,15 @@ func (s *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice) MarshalJSON() ( } // GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilit -// ies: The capabilities related to this Choice on applied metadata. +// ies: The capabilities related to this choice on applied metadata. type GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities struct { // CanRead: Whether the user can read related applied metadata on items. CanRead bool `json:"canRead,omitempty"` - // CanSearch: Whether the user can use this Choice in search queries. + // CanSearch: Whether the user can use this choice in search queries. CanSearch bool `json:"canSearch,omitempty"` - // CanSelect: Whether the user can select this Choice on an item. + // CanSelect: Whether the user can select this choice on an item. CanSelect bool `json:"canSelect,omitempty"` // ForceSendFields is a list of field names (e.g. "CanRead") to @@ -1973,21 +1976,21 @@ func (s *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabiliti } // GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints: -// UI Display hints for rendering a Option. +// UI display hints for rendering an option. type GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints struct { - // BadgeColors: The colors to use for the badge. Coerced to Google + // BadgeColors: The colors to use for the badge. Changed to Google // Material colors based on the chosen `properties.badge_config.color`. BadgeColors *GoogleAppsDriveLabelsV2betaBadgeColors `json:"badgeColors,omitempty"` - // BadgePriority: The priority of this badge, used to compare and sort - // between multiple badges. A lower number means that the badge should - // be shown first. When a badging configuration is not present, this - // will be 0. Otherwise, this will be set to - // `BadgeConfig.priority_override` or the default heuristic which - // prefers creation date of the Label, and field and option priority. + // BadgePriority: The priority of this badge. Used to compare and sort + // between multiple badges. A lower number means the badge should be + // shown first. When a badging configuration is not present, this will + // be 0. Otherwise, this will be set to `BadgeConfig.priority_override` + // or the default heuristic which prefers creation date of the label, + // and field and option priority. BadgePriority int64 `json:"badgePriority,omitempty,string"` - // DarkBadgeColors: The dark-mode color to use for the badge. Coerced to + // DarkBadgeColors: The dark-mode color to use for the badge. Changed to // Google Material colors based on the chosen // `properties.badge_config.color`. DarkBadgeColors *GoogleAppsDriveLabelsV2betaBadgeColors `json:"darkBadgeColors,omitempty"` @@ -1995,11 +1998,12 @@ type GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints struct { // Disabled: Whether the option should be shown in the UI as disabled. Disabled bool `json:"disabled,omitempty"` - // HiddenInSearch: This option should be hidden in the search menu. + // HiddenInSearch: This option should be hidden in the search menu when + // searching for Drive items. HiddenInSearch bool `json:"hiddenInSearch,omitempty"` - // ShownInApply: This option should be shown in the menu when applying - // values to a Drive item. + // ShownInApply: This option should be shown in the apply menu when + // applying values to a Drive item. ShownInApply bool `json:"shownInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "BadgeColors") to @@ -2026,22 +2030,22 @@ func (s *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints) Mar } // GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties: -// Basic properties of the Choice. +// Basic properties of the choice. type GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties struct { - // BadgeConfig: The badge configuration for this Choice. When set, the - // Label that owns this Choice will be considered a "badged label". + // BadgeConfig: The badge configuration for this choice. When set, the + // label that owns this choice is considered a "badged label". BadgeConfig *GoogleAppsDriveLabelsV2betaBadgeConfig `json:"badgeConfig,omitempty"` - // Description: The description of this Label. + // Description: The description of this label. Description string `json:"description,omitempty"` // DisplayName: Required. The display text to show in the UI identifying // this field. DisplayName string `json:"displayName,omitempty"` - // InsertBeforeChoice: Input only. Insert or move this Choice to be - // ordered before the indicated Choice. If empty, the Choice will be - // placed at the end of the list. + // InsertBeforeChoice: Input only. Insert or move this choice before the + // indicated choice. If empty, the choice is placed at the end of the + // list. InsertBeforeChoice string `json:"insertBeforeChoice,omitempty"` // ForceSendFields is a list of field names (e.g. "BadgeConfig") to @@ -2068,18 +2072,18 @@ func (s *GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties) Marsh } // GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabiliti -// es: The capabilities related to this Choice when editing the Choice. +// es: The capabilities related to this choice when editing the choice. type GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabilities struct { - // CanDelete: Whether the user can delete this Choice. + // CanDelete: Whether the user can delete this choice. CanDelete bool `json:"canDelete,omitempty"` - // CanDisable: Whether the user can disable this Chioce. + // CanDisable: Whether the user can disable this choice. CanDisable bool `json:"canDisable,omitempty"` - // CanEnable: Whether the user can enable this Choice. + // CanEnable: Whether the user can enable this choice. CanEnable bool `json:"canEnable,omitempty"` - // CanUpdate: Whether the user can update this Choice. + // CanUpdate: Whether the user can update this choice. CanUpdate bool `json:"canUpdate,omitempty"` // ForceSendFields is a list of field names (e.g. "CanDelete") to @@ -2142,8 +2146,8 @@ func (s *GoogleAppsDriveLabelsV2betaFieldTextOptions) MarshalJSON() ([]byte, err // GoogleAppsDriveLabelsV2betaFieldUserOptions: Options for the user // field type. type GoogleAppsDriveLabelsV2betaFieldUserOptions struct { - // ListOptions: When specified, indicates that this field support a list - // of values. Once the field is published, this cannot be changed. + // ListOptions: When specified, indicates that this field supports a + // list of values. Once the field is published, this cannot be changed. ListOptions *GoogleAppsDriveLabelsV2betaFieldListOptions `json:"listOptions,omitempty"` // ForceSendFields is a list of field names (e.g. "ListOptions") to @@ -2201,17 +2205,17 @@ func (s *GoogleAppsDriveLabelsV2betaIntegerLimits) MarshalJSON() ([]byte, error) return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2betaLabel: A Label defines a taxonomy which -// may be applied to a Drive items in order to organize and search -// across Items. Labels may be simple strings, or may contain Fields -// that describe additional metadata which can be further used to -// organize and search Drive items. +// GoogleAppsDriveLabelsV2betaLabel: A label defines a taxonomy that can +// be applied to Drive items in order to organize and search across +// items. Labels can be simple strings, or can contain fields that +// describe additional metadata that can be further used to organize and +// search Drive items. type GoogleAppsDriveLabelsV2betaLabel struct { // AppliedCapabilities: Output only. The capabilities related to this // label on applied metadata. AppliedCapabilities *GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities `json:"appliedCapabilities,omitempty"` - // AppliedLabelPolicy: Output only. Behavior of this Label when its + // AppliedLabelPolicy: Output only. Behavior of this label when it's // applied to Drive items. AppliedLabelPolicy *GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy `json:"appliedLabelPolicy,omitempty"` @@ -2229,25 +2233,25 @@ type GoogleAppsDriveLabelsV2betaLabel struct { // has no meaning when the label is not disabled. Disabler *GoogleAppsDriveLabelsV2betaUserInfo `json:"disabler,omitempty"` - // DisplayHints: Output only. UI Display hints for rendering the Label. + // DisplayHints: Output only. UI display hints for rendering the label. DisplayHints *GoogleAppsDriveLabelsV2betaLabelDisplayHints `json:"displayHints,omitempty"` - // Fields: List of Fields in descending priority order. + // Fields: List of fields in descending priority order. Fields []*GoogleAppsDriveLabelsV2betaField `json:"fields,omitempty"` - // Id: Output only. Globally unique identifier of this Label. ID makes - // up part of the Label `name`, but unlike `name`, ID is consistent + // Id: Output only. Globally unique identifier of this label. ID makes + // up part of the label `name`, but unlike `name`, ID is consistent // between revisions. Matches the regex: `([a-zA-Z0-9])+` Id string `json:"id,omitempty"` - // LabelType: Required. The type of this label. + // LabelType: Required. The type of label. // // Possible values: // "LABEL_TYPE_UNSPECIFIED" - Unknown label type. // "SHARED" - Shared labels may be shared with users to apply to Drive // items. - // "ADMIN" - Admin owned label. Only creatable and editable by admins, - // supports some additional admin-only features. + // "ADMIN" - Admin-owned label. Only creatable and editable by admins. + // Supports some additional admin-only features. LabelType string `json:"labelType,omitempty"` // LearnMoreUri: Custom URL to present to users to allow them to learn @@ -2261,12 +2265,12 @@ type GoogleAppsDriveLabelsV2betaLabel struct { // LockStatus: Output only. The LockStatus of this label. LockStatus *GoogleAppsDriveLabelsV2betaLockStatus `json:"lockStatus,omitempty"` - // Name: Output only. Resource name of the Label. Will be in the form of + // Name: Output only. Resource name of the label. Will be in the form of // either: `labels/{id}` or `labels/{id}@{revision_id}` depending on the // request. See `id` and `revision_id` below. Name string `json:"name,omitempty"` - // Properties: Required. The basic properties of the Label. + // Properties: Required. The basic properties of the label. Properties *GoogleAppsDriveLabelsV2betaLabelProperties `json:"properties,omitempty"` // PublishTime: Output only. The time this label was published. This @@ -2285,14 +2289,14 @@ type GoogleAppsDriveLabelsV2betaLabel struct { // revision. RevisionCreator *GoogleAppsDriveLabelsV2betaUserInfo `json:"revisionCreator,omitempty"` - // RevisionId: Output only. Revision ID of the Label. Revision ID may be - // part of the Label `name` depending on the request issued. A new - // revision is created whenever revisioned properties of a Label are + // RevisionId: Output only. Revision ID of the label. Revision ID might + // be part of the label `name` depending on the request issued. A new + // revision is created whenever revisioned properties of a label are // changed. Matches the regex: `([a-zA-Z0-9])+` RevisionId string `json:"revisionId,omitempty"` // SchemaCapabilities: Output only. The capabilities the user has on - // this Label. + // this label. SchemaCapabilities *GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities `json:"schemaCapabilities,omitempty"` // ServerResponse contains the HTTP response code and headers from the @@ -2324,16 +2328,16 @@ func (s *GoogleAppsDriveLabelsV2betaLabel) MarshalJSON() ([]byte, error) { } // GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities: The capabilities -// a user has on this Label's applied metadata. +// a user has on this label's applied metadata. type GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities struct { - // CanApply: Whether the user can apply this Label to items. + // CanApply: Whether the user can apply this label to items. CanApply bool `json:"canApply,omitempty"` // CanRead: Whether the user can read applied metadata related to this // label. CanRead bool `json:"canRead,omitempty"` - // CanRemove: Whether the user can remove this Label from items. + // CanRemove: Whether the user can remove this label from items. CanRemove bool `json:"canRemove,omitempty"` // ForceSendFields is a list of field names (e.g. "CanApply") to @@ -2360,21 +2364,20 @@ func (s *GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities) MarshalJSON() ([]b } // GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy: Behavior of this -// Label when its applied to Drive items. +// label when it's applied to Drive items. type GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy struct { - // CopyMode: Indicates how the applied Label, and Field values should be + // CopyMode: Indicates how the applied label and field values should be // copied when a Drive item is copied. // // Possible values: // "COPY_MODE_UNSPECIFIED" - Copy mode unspecified. - // "DO_NOT_COPY" - The applied Label and Field values will not be - // copied by default when the Drive item it is applied to is copied. - // "ALWAYS_COPY" - The applied Label and Field values will always be - // copied when the Drive item it is applied to is copied. Only admins - // may use this mode. - // "COPY_APPLIABLE" - The applied Label and Field values will be - // copied if and only if the label is appliable by the user making the - // copy. + // "DO_NOT_COPY" - The applied label and field values are not copied + // by default when the Drive item it's applied to is copied. + // "ALWAYS_COPY" - The applied label and field values are always + // copied when the Drive item it's applied to is copied. Only admins can + // use this mode. + // "COPY_APPLIABLE" - The applied label and field values are copied if + // the label is appliable by the user making the copy. CopyMode string `json:"copyMode,omitempty"` // ForceSendFields is a list of field names (e.g. "CopyMode") to @@ -2400,20 +2403,21 @@ func (s *GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy) MarshalJSON() ([]by return gensupport.MarshalJSON(raw, s.ForceSendFields, s.NullFields) } -// GoogleAppsDriveLabelsV2betaLabelDisplayHints: UI Display hints for -// rendering the Label. +// GoogleAppsDriveLabelsV2betaLabelDisplayHints: UI display hints for +// rendering the label. type GoogleAppsDriveLabelsV2betaLabelDisplayHints struct { - // Disabled: Whether the Label should be shown in the UI as disabled. + // Disabled: Whether the label should be shown in the UI as disabled. Disabled bool `json:"disabled,omitempty"` - // HiddenInSearch: This Label should be hidden in the search menu when + // HiddenInSearch: This label should be hidden in the search menu when // searching for Drive items. HiddenInSearch bool `json:"hiddenInSearch,omitempty"` - // Priority: Order to display label in a list + // Priority: Order to display label in a list. Priority int64 `json:"priority,omitempty,string"` - // ShownInApply: This Label should be shown in the apply menu. + // ShownInApply: This label should be shown in the apply menu when + // applying values to a Drive item. ShownInApply bool `json:"shownInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "Disabled") to @@ -2619,14 +2623,14 @@ type GoogleAppsDriveLabelsV2betaLabelPermission struct { // // Possible values: // "LABEL_ROLE_UNSPECIFIED" - Unknown role. - // "READER" - A reader can read the Label and associated metadata + // "READER" - A reader can read the label and associated metadata // applied to Drive items. // "APPLIER" - An applier can write associated metadata on Drive items // in which they also have write access to. Implies `READER`. - // "ORGANIZER" - An organizer is allowed to pin this label in shared - // drives they manage and add new appliers to the label. - // "EDITOR" - Editors may make any updates including deleting the - // Label which will also delete associated Drive item metadata. Implies + // "ORGANIZER" - An organizer can pin this label in shared drives they + // manage and add new appliers to the label. + // "EDITOR" - Editors can make any update including deleting the label + // which also deletes the associated Drive item metadata. Implies // `APPLIER`. Role string `json:"role,omitempty"` @@ -2658,12 +2662,12 @@ func (s *GoogleAppsDriveLabelsV2betaLabelPermission) MarshalJSON() ([]byte, erro } // GoogleAppsDriveLabelsV2betaLabelProperties: Basic properties of the -// Label. +// label. type GoogleAppsDriveLabelsV2betaLabelProperties struct { - // Description: The description of this Label. + // Description: The description of the label. Description string `json:"description,omitempty"` - // Title: Required. Title of the Label. + // Title: Required. Title of the label. Title string `json:"title,omitempty"` // ForceSendFields is a list of field names (e.g. "Description") to @@ -2690,21 +2694,21 @@ func (s *GoogleAppsDriveLabelsV2betaLabelProperties) MarshalJSON() ([]byte, erro } // GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities: The capabilities -// related to this Label when editing the Label. +// related to this label when editing the label. type GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities struct { - // CanDelete: Whether the user can delete this Label. The user must have - // permission and the Label must be disabled. + // CanDelete: Whether the user can delete this label. The user must have + // permission and the label must be disabled. CanDelete bool `json:"canDelete,omitempty"` - // CanDisable: Whether the user can disable this Label. The user must - // have permission and this Label must not already be disabled. + // CanDisable: Whether the user can disable this label. The user must + // have permission and this label must not already be disabled. CanDisable bool `json:"canDisable,omitempty"` - // CanEnable: Whether the user can enable this Label. The user must have - // permission and this Label must be disabled. + // CanEnable: Whether the user can enable this label. The user must have + // permission and this label must be disabled. CanEnable bool `json:"canEnable,omitempty"` - // CanUpdate: Whether the user can change this Label. + // CanUpdate: Whether the user can change this label. CanUpdate bool `json:"canUpdate,omitempty"` // ForceSendFields is a list of field names (e.g. "CanDelete") to @@ -2731,17 +2735,18 @@ func (s *GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities) MarshalJSON() ([]by } // GoogleAppsDriveLabelsV2betaLifecycle: The lifecycle state of an -// object, e.g. Label, Field, or Choice. The Lifecycle enforces the +// object, such as label, field, or choice. The lifecycle enforces the // following transitions: * `UNPUBLISHED_DRAFT` (starting state) * // `UNPUBLISHED_DRAFT` -> `PUBLISHED` * `UNPUBLISHED_DRAFT` -> (Deleted) // * `PUBLISHED` -> `DISABLED` * `DISABLED` -> `PUBLISHED` * `DISABLED` // -> (Deleted) The published and disabled states have some distinct -// characteristics: * Published - Some kinds of changes may be made to +// characteristics: * Published—Some kinds of changes might be made to // an object in this state, in which case `has_unpublished_changes` will -// be true. Some kinds of changes are not permitted. Generally, any -// change that would invalidate or cause new restrictions on existing -// metadata related to the Label will be rejected. * Disabled - When -// disabled, the configured `DisabledPolicy` will take effect. +// be true. Also, some kinds of changes are not permitted. Generally, +// any change that would invalidate or cause new restrictions on +// existing metadata related to the label are rejected. * +// Disabled—When disabled, the configured `DisabledPolicy` takes +// effect. type GoogleAppsDriveLabelsV2betaLifecycle struct { // DisabledPolicy: The policy that governs how to show a disabled label, // field, or selection choice. @@ -2757,14 +2762,14 @@ type GoogleAppsDriveLabelsV2betaLifecycle struct { // Possible values: // "STATE_UNSPECIFIED" - Unknown State. // "UNPUBLISHED_DRAFT" - The initial state of an object. Once - // published, the object may never return to this state. Once an object + // published, the object can never return to this state. Once an object // is published, certain kinds of changes are no longer permitted. - // "PUBLISHED" - The object has been published. The object may have + // "PUBLISHED" - The object has been published. The object might have // unpublished draft changes as indicated by `has_unpublished_changes`. - // "DISABLED" - The object has been published, and has since been - // disabled. The object may have unpublished draft changes as indicated - // by `has_unpublished_changes`. - // "DELETED" - The object has been deleted + // "DISABLED" - The object has been published and has since been + // disabled. The object might have unpublished draft changes as + // indicated by `has_unpublished_changes`. + // "DELETED" - The object has been deleted. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "DisabledPolicy") to @@ -2796,16 +2801,16 @@ func (s *GoogleAppsDriveLabelsV2betaLifecycle) MarshalJSON() ([]byte, error) { // different contexts. type GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy struct { // HideInSearch: Whether to hide this disabled object in the search menu - // for Drive items. * When `false` the object will generally be shown in - // the UI as disabled (but still permit searching) when searching for - // Drive items. * When `true` the object will generally be hidden in the + // for Drive items. * When `false`, the object is generally shown in the + // UI as disabled but it appears in the search results when searching + // for Drive items. * When `true`, the object is generally hidden in the // UI when searching for Drive items. HideInSearch bool `json:"hideInSearch,omitempty"` // ShowInApply: Whether to show this disabled object in the apply menu - // on Drive items. * When `true` the object will generally be shown in - // the UI as disabled and is unselectable. * When `false` the object - // will generally be hidden in the UI. + // on Drive items. * When `true`, the object is generally shown in the + // UI as disabled and is unselectable. * When `false`, the object is + // generally hidden in the UI. ShowInApply bool `json:"showInApply,omitempty"` // ForceSendFields is a list of field names (e.g. "HideInSearch") to @@ -2973,9 +2978,9 @@ func (s *GoogleAppsDriveLabelsV2betaListLimits) MarshalJSON() ([]byte, error) { // whether a label component should be considered locked. type GoogleAppsDriveLabelsV2betaLockStatus struct { // Locked: Output only. Indicates whether this label component is the - // (direct) target of a LabelLock. A label component may be implicitly - // locked even if it is not the direct target of a LabelLock, in which - // case this field will be false. + // (direct) target of a LabelLock. A label component can be implicitly + // locked even if it's not the direct target of a LabelLock, in which + // case this field is set to false. Locked bool `json:"locked,omitempty"` // ForceSendFields is a list of field names (e.g. "Locked") to @@ -3155,14 +3160,13 @@ type GoogleAppsDriveLabelsV2betaUpdateLabelCopyModeRequest struct { // // Possible values: // "COPY_MODE_UNSPECIFIED" - Copy mode unspecified. - // "DO_NOT_COPY" - The applied Label and Field values will not be - // copied by default when the Drive item it is applied to is copied. - // "ALWAYS_COPY" - The applied Label and Field values will always be - // copied when the Drive item it is applied to is copied. Only admins - // may use this mode. - // "COPY_APPLIABLE" - The applied Label and Field values will be - // copied if and only if the label is appliable by the user making the - // copy. + // "DO_NOT_COPY" - The applied label and field values are not copied + // by default when the Drive item it's applied to is copied. + // "ALWAYS_COPY" - The applied label and field values are always + // copied when the Drive item it's applied to is copied. Only admins can + // use this mode. + // "COPY_APPLIABLE" - The applied label and field values are copied if + // the label is appliable by the user making the copy. CopyMode string `json:"copyMode,omitempty"` // LanguageCode: The BCP-47 language code to use for evaluating @@ -3300,8 +3304,8 @@ func (s *GoogleAppsDriveLabelsV2betaUserCapabilities) MarshalJSON() ([]byte, err // GoogleAppsDriveLabelsV2betaUserInfo: Information about a user. type GoogleAppsDriveLabelsV2betaUserInfo struct { - // Person: The identifier for this user who can be used with the People - // API to get more information. e.g. people/12345678 + // Person: The identifier for this user that can be used with the People + // API to get more information. For example, people/12345678. Person string `json:"person,omitempty"` // ForceSendFields is a list of field names (e.g. "Person") to @@ -4319,11 +4323,11 @@ type LabelsGetCall struct { header_ http.Header } -// Get: Get a Label by its resource name. Resource name may be any of: * -// `labels/{id}` - See to `labels/{id}@latest` * `labels/{id}@latest` - -// Gets the latest revision of the Label. * `labels/{id}@published` - -// Gets the current published revision of the Label. * -// `labels/{id}@{revision_id}` - Gets the Label at the specified +// Get: Get a label by its resource name. Resource name may be any of: * +// `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - +// Gets the latest revision of the label. * `labels/{id}@published` - +// Gets the current published revision of the label. * +// `labels/{id}@{revision_id}` - Gets the label at the specified // revision ID. // // - name: Label resource name. May be any of: * `labels/{id}` @@ -4336,23 +4340,24 @@ func (r *LabelsService) Get(name string) *LabelsGetCall { } // LanguageCode sets the optional parameter "languageCode": The BCP-47 -// language code to use for evaluating localized Field labels. When not -// specified, values in the default configured language will be used. +// language code to use for evaluating localized field labels. When not +// specified, values in the default configured language are used. func (c *LabelsGetCall) LanguageCode(languageCode string) *LabelsGetCall { c.urlParams_.Set("languageCode", languageCode) return c } // UseAdminAccess sets the optional parameter "useAdminAccess": Set to -// `true` in order to use the user's admin credentials. The server will -// verify the user is an admin for the Label before allowing access. +// `true` in order to use the user's admin credentials. The server +// verifies that the user is an admin for the label before allowing +// access. func (c *LabelsGetCall) UseAdminAccess(useAdminAccess bool) *LabelsGetCall { c.urlParams_.Set("useAdminAccess", fmt.Sprint(useAdminAccess)) return c } // View sets the optional parameter "view": When specified, only certain -// Fields belonging to the indicated view will be returned. +// fields belonging to the indicated view are returned. // // Possible values: // "LABEL_VIEW_BASIC" - Implies the field mask: @@ -4462,7 +4467,7 @@ func (c *LabelsGetCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabels } return ret, nil // { - // "description": "Get a Label by its resource name. Resource name may be any of: * `labels/{id}` - See to `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the Label. * `labels/{id}@published` - Gets the current published revision of the Label. * `labels/{id}@{revision_id}` - Gets the Label at the specified revision ID.", + // "description": "Get a label by its resource name. Resource name may be any of: * `labels/{id}` - See `labels/{id}@latest` * `labels/{id}@latest` - Gets the latest revision of the label. * `labels/{id}@published` - Gets the current published revision of the label. * `labels/{id}@{revision_id}` - Gets the label at the specified revision ID.", // "flatPath": "v2beta/labels/{labelsId}", // "httpMethod": "GET", // "id": "drivelabels.labels.get", @@ -4471,7 +4476,7 @@ func (c *LabelsGetCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabels // ], // "parameters": { // "languageCode": { - // "description": "The BCP-47 language code to use for evaluating localized Field labels. When not specified, values in the default configured language will be used.", + // "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", // "location": "query", // "type": "string" // }, @@ -4483,12 +4488,12 @@ func (c *LabelsGetCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabels // "type": "string" // }, // "useAdminAccess": { - // "description": "Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.", + // "description": "Set to `true` in order to use the user's admin credentials. The server verifies that the user is an admin for the label before allowing access.", // "location": "query", // "type": "boolean" // }, // "view": { - // "description": "When specified, only certain Fields belonging to the indicated view will be returned.", + // "description": "When specified, only certain fields belonging to the indicated view are returned.", // "enum": [ // "LABEL_VIEW_BASIC", // "LABEL_VIEW_FULL" @@ -4519,11 +4524,7 @@ type LabelsListCall struct { header_ http.Header } -// List: -// ---------------------------------------------------------------------- -// ---- ## Label APIs -// --------------------------------------------------------------- List -// Labels. +// List: List labels. func (r *LabelsService) List() *LabelsListCall { c := &LabelsListCall{s: r.s, urlParams_: make(gensupport.URLParams)} return c @@ -4531,7 +4532,7 @@ func (r *LabelsService) List() *LabelsListCall { // LanguageCode sets the optional parameter "languageCode": The BCP-47 // language code to use for evaluating localized field labels. When not -// specified, values in the default configured language will be used. +// specified, values in the default configured language are used. func (c *LabelsListCall) LanguageCode(languageCode string) *LabelsListCall { c.urlParams_.Set("languageCode", languageCode) return c @@ -4543,14 +4544,14 @@ func (c *LabelsListCall) LanguageCode(languageCode string) *LabelsListCall { // // Possible values: // "LABEL_ROLE_UNSPECIFIED" - Unknown role. -// "READER" - A reader can read the Label and associated metadata +// "READER" - A reader can read the label and associated metadata // applied to Drive items. // "APPLIER" - An applier can write associated metadata on Drive items // in which they also have write access to. Implies `READER`. -// "ORGANIZER" - An organizer is allowed to pin this label in shared -// drives they manage and add new appliers to the label. -// "EDITOR" - Editors may make any updates including deleting the -// Label which will also delete associated Drive item metadata. Implies +// "ORGANIZER" - An organizer can pin this label in shared drives they +// manage and add new appliers to the label. +// "EDITOR" - Editors can make any update including deleting the label +// which also deletes the associated Drive item metadata. Implies // `APPLIER`. func (c *LabelsListCall) MinimumRole(minimumRole string) *LabelsListCall { c.urlParams_.Set("minimumRole", minimumRole) @@ -4558,7 +4559,7 @@ func (c *LabelsListCall) MinimumRole(minimumRole string) *LabelsListCall { } // PageSize sets the optional parameter "pageSize": Maximum number of -// Labels to return per page. Default: 50. Max: 200. +// labels to return per page. Default: 50. Max: 200. func (c *LabelsListCall) PageSize(pageSize int64) *LabelsListCall { c.urlParams_.Set("pageSize", fmt.Sprint(pageSize)) return c @@ -4573,11 +4574,11 @@ func (c *LabelsListCall) PageToken(pageToken string) *LabelsListCall { // PublishedOnly sets the optional parameter "publishedOnly": Whether to // include only published labels in the results. * When `true`, only the -// current published label revisions will be returned. Disabled labels -// will be included. Returned Label resource names will reference the -// published revision (`labels/{id}/{revision_id}`). * When `false`, the -// current label revisions will be returned, which may not by published. -// Returned Label resource names will not reference a specific revision +// current published label revisions are returned. Disabled labels are +// included. Returned label resource names reference the published +// revision (`labels/{id}/{revision_id}`). * When `false`, the current +// label revisions are returned, which might not be published. Returned +// label resource names don't reference a specific revision // (`labels/{id}`). func (c *LabelsListCall) PublishedOnly(publishedOnly bool) *LabelsListCall { c.urlParams_.Set("publishedOnly", fmt.Sprint(publishedOnly)) @@ -4593,7 +4594,7 @@ func (c *LabelsListCall) UseAdminAccess(useAdminAccess bool) *LabelsListCall { } // View sets the optional parameter "view": When specified, only certain -// fields belonging to the indicated view will be returned. +// fields belonging to the indicated view are returned. // // Possible values: // "LABEL_VIEW_BASIC" - Implies the field mask: @@ -4702,14 +4703,14 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel } return ret, nil // { - // "description": "-------------------------------------------------------------------------- ## Label APIs --------------------------------------------------------------- List Labels.", + // "description": "List labels.", // "flatPath": "v2beta/labels", // "httpMethod": "GET", // "id": "drivelabels.labels.list", // "parameterOrder": [], // "parameters": { // "languageCode": { - // "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.", + // "description": "The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.", // "location": "query", // "type": "string" // }, @@ -4724,16 +4725,16 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel // ], // "enumDescriptions": [ // "Unknown role.", - // "A reader can read the Label and associated metadata applied to Drive items.", + // "A reader can read the label and associated metadata applied to Drive items.", // "An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`.", - // "An organizer is allowed to pin this label in shared drives they manage and add new appliers to the label.", - // "Editors may make any updates including deleting the Label which will also delete associated Drive item metadata. Implies `APPLIER`." + // "An organizer can pin this label in shared drives they manage and add new appliers to the label.", + // "Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`." // ], // "location": "query", // "type": "string" // }, // "pageSize": { - // "description": "Maximum number of Labels to return per page. Default: 50. Max: 200.", + // "description": "Maximum number of labels to return per page. Default: 50. Max: 200.", // "format": "int32", // "location": "query", // "type": "integer" @@ -4744,7 +4745,7 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel // "type": "string" // }, // "publishedOnly": { - // "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions will be returned. Disabled labels will be included. Returned Label resource names will reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions will be returned, which may not by published. Returned Label resource names will not reference a specific revision (`labels/{id}`).", + // "description": "Whether to include only published labels in the results. * When `true`, only the current published label revisions are returned. Disabled labels are included. Returned label resource names reference the published revision (`labels/{id}/{revision_id}`). * When `false`, the current label revisions are returned, which might not be published. Returned label resource names don't reference a specific revision (`labels/{id}`).", // "location": "query", // "type": "boolean" // }, @@ -4754,7 +4755,7 @@ func (c *LabelsListCall) Do(opts ...googleapi.CallOption) (*GoogleAppsDriveLabel // "type": "boolean" // }, // "view": { - // "description": "When specified, only certain fields belonging to the indicated view will be returned.", + // "description": "When specified, only certain fields belonging to the indicated view are returned.", // "enum": [ // "LABEL_VIEW_BASIC", // "LABEL_VIEW_FULL"