{ "ownerDomain": "google.com", "name": "drivelabels", "kind": "discovery#restDescription", "servicePath": "", "rootUrl": "https://drivelabels.googleapis.com/", "batchPath": "batch", "baseUrl": "https://drivelabels.googleapis.com/", "title": "Drive Labels API", "mtlsRootUrl": "https://drivelabels.mtls.googleapis.com/", "documentationLink": "https://developers.google.com/workspace/drive/labels", "protocol": "rest", "fullyEncodeReservedExpansion": true, "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/drive.admin.labels": { "description": "See, edit, create, and delete all Google Drive labels in your organization, and see your organization's label-related admin policies" }, "https://www.googleapis.com/auth/drive.labels": { "description": "See, edit, create, and delete your Google Drive labels" }, "https://www.googleapis.com/auth/drive.labels.readonly": { "description": "See your Google Drive labels" }, "https://www.googleapis.com/auth/drive.admin.labels.readonly": { "description": "See all Google Drive labels and label-related admin policies in your organization" } } } }, "id": "drivelabels:v2beta", "ownerName": "Google", "resources": { "labels": { "resources": { "permissions": { "methods": { "batchUpdate": { "id": "drivelabels.labels.permissions.batchUpdate", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+parent}/permissions:batchUpdate", "httpMethod": "POST", "request": { "$ref": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsRequest" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsResponse" }, "flatPath": "v2beta/labels/{labelsId}/permissions:batchUpdate", "parameters": { "parent": { "required": true, "description": "Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.", "pattern": "^labels/[^/]+$", "location": "path", "type": "string" } } }, "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaListLabelPermissionsResponse" }, "flatPath": "v2beta/labels/{labelsId}/permissions", "parameters": { "parent": { "description": "Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`.", "pattern": "^labels/[^/]+$", "location": "path", "required": true, "type": "string" }, "useAdminAccess": { "type": "boolean", "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.", "location": "query" }, "pageSize": { "type": "integer", "format": "int32", "description": "Maximum number of permissions to return per page. Default: 50. Max: 200.", "location": "query" }, "pageToken": { "description": "The token of the page to return.", "location": "query", "type": "string" } }, "id": "drivelabels.labels.permissions.list", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ], "description": "Lists a label's permissions.", "path": "v2beta/{+parent}/permissions", "httpMethod": "GET" }, "create": { "path": "v2beta/{+parent}/permissions", "httpMethod": "POST", "description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "id": "drivelabels.labels.permissions.create", "parameters": { "parent": { "type": "string", "description": "Required. The parent label resource name on the label permission is created. Format: `labels/{label}`.", "pattern": "^labels/[^/]+$", "location": "path", "required": true }, "useAdminAccess": { "type": "boolean", "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.", "location": "query" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "request": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "flatPath": "v2beta/labels/{labelsId}/permissions" }, "batchDelete": { "parameters": { "parent": { "description": "Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.", "pattern": "^labels/[^/]+$", "location": "path", "required": true, "type": "string" } }, "request": { "$ref": "GoogleAppsDriveLabelsV2betaBatchDeleteLabelPermissionsRequest" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v2beta/labels/{labelsId}/permissions:batchDelete", "description": "Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+parent}/permissions:batchDelete", "httpMethod": "POST", "id": "drivelabels.labels.permissions.batchDelete", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ] }, "delete": { "description": "Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+name}", "httpMethod": "DELETE", "id": "drivelabels.labels.permissions.delete", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "parameters": { "useAdminAccess": { "type": "boolean", "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.", "location": "query" }, "name": { "type": "string", "required": true, "description": "Required. Label permission resource name.", "pattern": "^labels/[^/]+/permissions/[^/]+$", "location": "path" } }, "flatPath": "v2beta/labels/{labelsId}/permissions/{permissionsId}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" } } } }, "locks": { "methods": { "list": { "description": "Lists the label locks on a label.", "path": "v2beta/{+parent}/locks", "httpMethod": "GET", "id": "drivelabels.labels.locks.list", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ], "parameters": { "pageSize": { "format": "int32", "description": "Maximum number of locks to return per page. Default: 100. Max: 200.", "location": "query", "type": "integer" }, "pageToken": { "type": "string", "description": "The token of the page to return.", "location": "query" }, "parent": { "type": "string", "required": true, "description": "Required. Label on which locks are applied. Format: `labels/{label}`.", "pattern": "^labels/[^/]+$", "location": "path" } }, "flatPath": "v2beta/labels/{labelsId}/locks", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaListLabelLocksResponse" } } } }, "revisions": { "methods": { "updatePermissions": { "id": "drivelabels.labels.revisions.updatePermissions", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+parent}/permissions", "httpMethod": "PATCH", "request": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions", "parameters": { "parent": { "description": "Required. The parent label resource name.", "pattern": "^labels/[^/]+/revisions/[^/]+$", "location": "path", "required": true, "type": "string" }, "useAdminAccess": { "type": "boolean", "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.", "location": "query" } } } }, "resources": { "permissions": { "methods": { "delete": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions/{permissionsId}", "parameters": { "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.", "location": "query", "type": "boolean" }, "name": { "type": "string", "description": "Required. Label permission resource name.", "pattern": "^labels/[^/]+/revisions/[^/]+/permissions/[^/]+$", "location": "path", "required": true } }, "id": "drivelabels.labels.revisions.permissions.delete", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+name}", "httpMethod": "DELETE" }, "batchDelete": { "parameters": { "parent": { "required": true, "description": "Required. The parent label resource name shared by all permissions being deleted. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.", "pattern": "^labels/[^/]+/revisions/[^/]+$", "location": "path", "type": "string" } }, "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions:batchDelete", "request": { "$ref": "GoogleAppsDriveLabelsV2betaBatchDeleteLabelPermissionsRequest" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleProtobufEmpty" }, "description": "Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+parent}/permissions:batchDelete", "httpMethod": "POST", "id": "drivelabels.labels.revisions.permissions.batchDelete", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ] }, "create": { "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "id": "drivelabels.labels.revisions.permissions.create", "path": "v2beta/{+parent}/permissions", "httpMethod": "POST", "description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "request": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions", "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The parent label resource name on the label permission is created. Format: `labels/{label}`.", "pattern": "^labels/[^/]+/revisions/[^/]+$", "location": "path" }, "useAdminAccess": { "type": "boolean", "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.", "location": "query" } } }, "list": { "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions", "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaListLabelPermissionsResponse" }, "parameters": { "parent": { "type": "string", "description": "Required. The parent label resource name on which label permissions are listed. Format: `labels/{label}`.", "pattern": "^labels/[^/]+/revisions/[^/]+$", "location": "path", "required": true }, "useAdminAccess": { "type": "boolean", "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.", "location": "query" }, "pageSize": { "description": "Maximum number of permissions to return per page. Default: 50. Max: 200.", "location": "query", "format": "int32", "type": "integer" }, "pageToken": { "description": "The token of the page to return.", "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ], "id": "drivelabels.labels.revisions.permissions.list", "path": "v2beta/{+parent}/permissions", "httpMethod": "GET", "description": "Lists a label's permissions." }, "batchUpdate": { "description": "Updates label permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+parent}/permissions:batchUpdate", "httpMethod": "POST", "id": "drivelabels.labels.revisions.permissions.batchUpdate", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "parameters": { "parent": { "description": "Required. The parent label resource name shared by all permissions being updated. Format: `labels/{label}`. If this is set, the parent field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.", "pattern": "^labels/[^/]+/revisions/[^/]+$", "location": "path", "required": true, "type": "string" } }, "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/permissions:batchUpdate", "request": { "$ref": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsRequest" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsResponse" } } } }, "locks": { "methods": { "list": { "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaListLabelLocksResponse" }, "flatPath": "v2beta/labels/{labelsId}/revisions/{revisionsId}/locks", "parameters": { "parent": { "required": true, "description": "Required. Label on which locks are applied. Format: `labels/{label}`.", "pattern": "^labels/[^/]+/revisions/[^/]+$", "location": "path", "type": "string" }, "pageSize": { "format": "int32", "description": "Maximum number of locks to return per page. Default: 100. Max: 200.", "location": "query", "type": "integer" }, "pageToken": { "description": "The token of the page to return.", "location": "query", "type": "string" } }, "id": "drivelabels.labels.revisions.locks.list", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ], "description": "Lists the label locks on a label.", "path": "v2beta/{+parent}/locks", "httpMethod": "GET" } } } } } }, "methods": { "updatePermissions": { "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The parent label resource name.", "pattern": "^labels/[^/]+$", "location": "path" }, "useAdminAccess": { "type": "boolean", "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.", "location": "query" } }, "flatPath": "v2beta/labels/{labelsId}/permissions", "request": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "parameterOrder": [ "parent" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "description": "Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "path": "v2beta/{+parent}/permissions", "httpMethod": "PATCH", "id": "drivelabels.labels.updatePermissions", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ] }, "enable": { "parameters": { "name": { "type": "string", "required": true, "description": "Required. Label resource name.", "pattern": "^labels/[^/]+$", "location": "path" } }, "flatPath": "v2beta/labels/{labelsId}:enable", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "request": { "$ref": "GoogleAppsDriveLabelsV2betaEnableLabelRequest" }, "path": "v2beta/{+name}:enable", "httpMethod": "POST", "description": "Enable a disabled label and restore it to its published state. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). This will result in a new published revision based on the current disabled published revision. If there's an existing disabled draft revision, a new revision will be created based on that draft and will be enabled.", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "id": "drivelabels.labels.enable" }, "list": { "parameters": { "minimumRole": { "enumDescriptions": [ "Unknown role.", "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 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`." ], "enum": [ "LABEL_ROLE_UNSPECIFIED", "READER", "APPLIER", "ORGANIZER", "EDITOR" ], "type": "string", "description": "Specifies the level of access the user must have on the returned labels. The minimum role a user must have on a label. Defaults to `READER`.", "location": "query" }, "publishedOnly": { "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" }, "languageCode": { "type": "string", "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" }, "pageSize": { "type": "integer", "description": "Maximum number of labels to return per page. Default: 50. Max: 200.", "location": "query", "format": "int32" }, "view": { "description": "When specified, only certain fields belonging to the indicated view are returned.", "location": "query", "type": "string", "enumDescriptions": [ "Implies the field mask: `name,id,revision_id,label_type,properties.*`", "All possible fields." ], "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" ] }, "pageToken": { "description": "The token of the page to return.", "location": "query", "type": "string" }, "customer": { "description": "The customer to scope this list request to. For example: `customers/abcd1234`. If unset, will return all labels within the current customer.", "location": "query", "type": "string" }, "useAdminAccess": { "type": "boolean", "description": "Set to `true` in order to use the user's admin credentials. This will return all labels within the customer.", "location": "query" } }, "parameterOrder": [], "response": { "$ref": "GoogleAppsDriveLabelsV2betaListLabelsResponse" }, "flatPath": "v2beta/labels", "path": "v2beta/labels", "httpMethod": "GET", "description": "List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ], "id": "drivelabels.labels.list" }, "disable": { "path": "v2beta/{+name}:disable", "httpMethod": "POST", "description": "Disable a published label. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Disabling a label will result in a new disabled published revision based on the current published revision. If there's a draft revision, a new disabled draft revision will be created based on the latest draft revision. Older draft revisions will be deleted. Once disabled, a label may be deleted with `DeleteLabel`.", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "id": "drivelabels.labels.disable", "parameters": { "name": { "type": "string", "description": "Required. Label resource name.", "pattern": "^labels/[^/]+$", "location": "path", "required": true } }, "flatPath": "v2beta/labels/{labelsId}:disable", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "request": { "$ref": "GoogleAppsDriveLabelsV2betaDisableLabelRequest" } }, "publish": { "id": "drivelabels.labels.publish", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Publish all draft changes to the label. Once published, the label may not return to its draft state. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label). Publishing a label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the label will be rejected. For example, the following changes to a label will be rejected after the label is published: * The label cannot be directly deleted. It must be disabled first, then deleted. * `Field.FieldType` cannot be changed. * Changes to field validation options cannot reject something that was previously accepted. * Reducing the maximum entries.", "path": "v2beta/{+name}:publish", "httpMethod": "POST", "flatPath": "v2beta/labels/{labelsId}:publish", "request": { "$ref": "GoogleAppsDriveLabelsV2betaPublishLabelRequest" }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "parameters": { "name": { "description": "Required. Label resource name.", "pattern": "^labels/[^/]+$", "location": "path", "required": true, "type": "string" } } }, "updateLabelCopyMode": { "id": "drivelabels.labels.updateLabelCopyMode", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.", "path": "v2beta/{+name}:updateLabelCopyMode", "httpMethod": "POST", "flatPath": "v2beta/labels/{labelsId}:updateLabelCopyMode", "request": { "$ref": "GoogleAppsDriveLabelsV2betaUpdateLabelCopyModeRequest" }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "parameters": { "name": { "description": "Required. The resource name of the label to update.", "pattern": "^labels/[^/]+$", "location": "path", "required": true, "type": "string" } } }, "get": { "parameters": { "languageCode": { "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" }, "name": { "type": "string", "description": "Required. Label resource name. May be any of: * `labels/{id}` (equivalent to labels/{id}@latest) * `labels/{id}@latest` * `labels/{id}@published` * `labels/{id}@{revision_id}`", "pattern": "^labels/[^/]+$", "location": "path", "required": true }, "useAdminAccess": { "type": "boolean", "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" }, "view": { "description": "When specified, only certain fields belonging to the indicated view are returned.", "location": "query", "enumDescriptions": [ "Implies the field mask: `name,id,revision_id,label_type,properties.*`", "All possible fields." ], "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" ], "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "flatPath": "v2beta/labels/{labelsId}", "description": "Get a label by its resource name. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label). 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.", "path": "v2beta/{+name}", "httpMethod": "GET", "id": "drivelabels.labels.get", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ] }, "create": { "id": "drivelabels.labels.create", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).", "path": "v2beta/labels", "httpMethod": "POST", "request": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "parameterOrder": [], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "flatPath": "v2beta/labels", "parameters": { "languageCode": { "description": "The BCP-47 language code to use for evaluating localized field labels in response. When not specified, values in the default configured language will be used.", "location": "query", "type": "string" }, "useAdminAccess": { "description": "Set to `true` in order to use the user's admin privileges. The server will verify the user is an admin before allowing access.", "location": "query", "type": "boolean" } } }, "delta": { "flatPath": "v2beta/labels/{labelsId}:delta", "request": { "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequest" }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponse" }, "parameters": { "name": { "required": true, "description": "Required. The resource name of the label to update.", "pattern": "^labels/[^/]+$", "location": "path", "type": "string" } }, "id": "drivelabels.labels.delta", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Updates a single label by applying a set of update requests resulting in a new draft revision. For more information, see [Update a label](https://developers.google.com/workspace/drive/labels/guides/update-label). The batch update is all-or-nothing: If any of the update requests are invalid, no changes are applied. The resulting draft revision must be published before the changes may be used with Drive items.", "path": "v2beta/{+name}:delta", "httpMethod": "POST" }, "updateLabelEnabledAppSettings": { "id": "drivelabels.labels.updateLabelEnabledAppSettings", "path": "v2beta/{+name}:updateLabelEnabledAppSettings", "httpMethod": "POST", "description": "Updates a label's `EnabledAppSettings`. Enabling a label in a Google Workspace app allows it to be used in that app. This change isn't revisioned, doesn't require publishing, and takes effect immediately.", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "request": { "$ref": "GoogleAppsDriveLabelsV2betaUpdateLabelEnabledAppSettingsRequest" }, "flatPath": "v2beta/labels/{labelsId}:updateLabelEnabledAppSettings", "parameters": { "name": { "type": "string", "description": "Required. The resource name of the label to update. The resource name of the label to update.", "pattern": "^labels/[^/]+$", "location": "path", "required": true } } }, "delete": { "id": "drivelabels.labels.delete", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.labels" ], "description": "Permanently deletes a label and related metadata on Drive items. For more information, see [Disable, enable, and delete a label](https://developers.google.com/workspace/drive/labels/guides/disable-delete-label). Once deleted, the label and related Drive item metadata will be deleted. Only draft labels and disabled labels may be deleted.", "path": "v2beta/{+name}", "httpMethod": "DELETE", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleProtobufEmpty" }, "flatPath": "v2beta/labels/{labelsId}", "parameters": { "name": { "required": true, "description": "Required. Label resource name.", "pattern": "^labels/[^/]+$", "location": "path", "type": "string" }, "useAdminAccess": { "type": "boolean", "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.", "location": "query" }, "writeControl.requiredRevisionId": { "type": "string", "description": "The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.", "location": "query" } } } } }, "users": { "methods": { "getCapabilities": { "parameterOrder": [ "name" ], "response": { "$ref": "GoogleAppsDriveLabelsV2betaUserCapabilities" }, "flatPath": "v2beta/users/{usersId}/capabilities", "parameters": { "name": { "description": "Required. The resource name of the user. Only \"users/me/capabilities\" is supported.", "pattern": "^users/[^/]+/capabilities$", "location": "path", "required": true, "type": "string" }, "customer": { "description": "The customer to scope this request to. For example: `customers/abcd1234`. If unset, it will return settings within the current customer.", "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ], "id": "drivelabels.users.getCapabilities", "path": "v2beta/{+name}", "httpMethod": "GET", "description": "Gets the user capabilities." } } }, "limits": { "methods": { "getLabel": { "path": "v2beta/limits/label", "httpMethod": "GET", "description": "Get the constraints on the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.", "scopes": [ "https://www.googleapis.com/auth/drive.admin.labels", "https://www.googleapis.com/auth/drive.admin.labels.readonly", "https://www.googleapis.com/auth/drive.labels", "https://www.googleapis.com/auth/drive.labels.readonly" ], "id": "drivelabels.limits.getLabel", "parameters": { "name": { "description": "Required. Label revision resource name must be: \"limits/label\".", "location": "query", "type": "string" } }, "parameterOrder": [], "response": { "$ref": "GoogleAppsDriveLabelsV2betaLabelLimits" }, "flatPath": "v2beta/limits/label" } } } }, "revision": "20260504", "parameters": { "prettyPrint": { "description": "Returns response with indentations and line breaks.", "location": "query", "default": "true", "type": "boolean" }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" }, "$.xgafv": { "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "type": "string", "description": "V1 error format.", "location": "query" }, "key": { "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query" }, "alt": { "description": "Data format for response.", "location": "query", "default": "json", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "type": "string" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "location": "query", "type": "string" }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query", "type": "string" } }, "discoveryVersion": "v1", "version": "v2beta", "schemas": { "GoogleAppsDriveLabelsV2betaFieldIntegerOptions": { "description": "Options for the Integer field type.", "properties": { "minValue": { "readOnly": true, "type": "string", "description": "Output only. The minimum valid value for the integer field.", "format": "int64" }, "maxValue": { "format": "int64", "description": "Output only. The maximum valid value for the integer field.", "readOnly": true, "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaFieldIntegerOptions", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteSelectionChoiceResponse": { "description": "Response following choice delete.", "properties": {}, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteSelectionChoiceResponse", "type": "object" }, "GoogleAppsDriveLabelsV2betaTextLimits": { "description": "Limits for text field type.", "properties": { "minLength": { "format": "int32", "description": "Minimum length allowed for a text field type.", "type": "integer" }, "maxLength": { "description": "Maximum length allowed for a text field type.", "format": "int32", "type": "integer" } }, "id": "GoogleAppsDriveLabelsV2betaTextLimits", "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldDateOptions": { "id": "GoogleAppsDriveLabelsV2betaFieldDateOptions", "type": "object", "description": "Options for the date field type.", "properties": { "dateFormatType": { "description": "Localized date formatting option. Field values are rendered in this format according to their locale.", "type": "string", "enumDescriptions": [ "Date format unspecified.", "Includes full month name. For example, January 12, 1999 (MMMM d, y)", "Short, numeric, representation. For example, 12/13/99 (M/d/yy)" ], "enum": [ "DATE_FORMAT_UNSPECIFIED", "LONG_DATE", "SHORT_DATE" ] }, "minValue": { "readOnly": true, "$ref": "GoogleTypeDate", "description": "Output only. Minimum valid value (year, month, day)." }, "dateFormat": { "description": "Output only. ICU date format.", "readOnly": true, "type": "string" }, "maxValue": { "readOnly": true, "$ref": "GoogleTypeDate", "description": "Output only. Maximum valid value (year, month, day)." } } }, "GoogleAppsDriveLabelsV2betaLockStatus": { "id": "GoogleAppsDriveLabelsV2betaLockStatus", "type": "object", "description": "Contains information about whether a label component should be considered locked.", "properties": { "locked": { "description": "Output only. Indicates whether this label component is the (direct) target of a label lock. A label component can be implicitly locked even if it's not the direct target of a label lock, in which case this field is set to false.", "readOnly": true, "type": "boolean" } } }, "GoogleAppsDriveLabelsV2betaFieldDisplayHints": { "id": "GoogleAppsDriveLabelsV2betaFieldDisplayHints", "type": "object", "description": "UI display hints for rendering a field.", "properties": { "hiddenInSearch": { "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.", "type": "boolean" }, "disabled": { "description": "Whether the field should be shown in the UI as disabled.", "type": "boolean" }, "shownInApply": { "description": "This field should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" } } }, "GoogleAppsDriveLabelsV2betaDateLimits": { "id": "GoogleAppsDriveLabelsV2betaDateLimits", "type": "object", "description": "Limits for date field type.", "properties": { "maxValue": { "description": "Maximum value for the date field type.", "$ref": "GoogleTypeDate" }, "minValue": { "description": "Minimum value for the date field type.", "$ref": "GoogleTypeDate" } } }, "GoogleAppsDriveLabelsV2betaDisableLabelRequest": { "id": "GoogleAppsDriveLabelsV2betaDisableLabelRequest", "type": "object", "description": "Request to deprecate a published label.", "properties": { "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.", "type": "boolean" }, "writeControl": { "description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins.", "$ref": "GoogleAppsDriveLabelsV2betaWriteControl" }, "updateMask": { "type": "string", "description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.", "format": "google-fieldmask" }, "disabledPolicy": { "description": "Disabled policy to use.", "$ref": "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy" }, "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.", "type": "string" } } }, "GoogleTypeDate": { "id": "GoogleTypeDate", "type": "object", "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "properties": { "year": { "type": "integer", "format": "int32", "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year." }, "month": { "format": "int32", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "type": "integer" }, "day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "format": "int32", "type": "integer" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldPropertiesRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldPropertiesRequest", "type": "object", "description": "Request to update field properties.", "properties": { "id": { "description": "Required. The field to update.", "type": "string" }, "updateMask": { "type": "string", "description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.", "format": "google-fieldmask" }, "properties": { "description": "Required. Basic field properties.", "$ref": "GoogleAppsDriveLabelsV2betaFieldProperties" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponse", "type": "object", "description": "Response for label update.", "properties": { "responses": { "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseResponse" }, "description": "The reply of the updates. This maps 1:1 with the updates, although responses to some requests may be empty." }, "updatedLabel": { "description": "The label after updates were applied. This is only set if `include_label_in_response` is `true` and there were no errors.", "$ref": "GoogleAppsDriveLabelsV2betaLabel" } } }, "GoogleProtobufEmpty": { "id": "GoogleProtobufEmpty", "type": "object", "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "properties": {} }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints": { "description": "UI display hints for rendering an option.", "properties": { "disabled": { "description": "Whether the option should be shown in the UI as disabled.", "type": "boolean" }, "shownInApply": { "description": "This option should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" }, "badgePriority": { "type": "string", "format": "int64", "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." }, "darkBadgeColors": { "description": "The dark-mode color to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.", "$ref": "GoogleAppsDriveLabelsV2betaBadgeColors" }, "badgeColors": { "description": "The colors to use for the badge. Changed to Google Material colors based on the chosen `properties.badge_config.color`.", "$ref": "GoogleAppsDriveLabelsV2betaBadgeColors" }, "hiddenInSearch": { "description": "This option should be hidden in the search menu when searching for Drive items.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints", "type": "object" }, "GoogleAppsDriveLabelsV2betaListLabelPermissionsResponse": { "description": "Response for listing the permissions on a label.", "properties": { "labelPermissions": { "description": "Label permissions.", "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" } }, "nextPageToken": { "description": "The token of the next page in the response.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaListLabelPermissionsResponse", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateSelectionChoiceRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateSelectionChoiceRequest", "type": "object", "description": "Request to create a selection choice.", "properties": { "fieldId": { "description": "Required. The selection field in which a choice will be created.", "type": "string" }, "choice": { "description": "Required. The choice to create.", "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteSelectionChoiceRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteSelectionChoiceRequest", "type": "object", "description": "Request to delete a choice.", "properties": { "fieldId": { "description": "Required. The selection field from which a choice will be deleted.", "type": "string" }, "id": { "description": "Required. Choice to delete.", "type": "string" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateLabelPropertiesRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateLabelPropertiesRequest", "type": "object", "description": "Updates basic properties of a label.", "properties": { "updateMask": { "format": "google-fieldmask", "description": "The fields that should be updated. At least one field must be specified. The root `label_properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.", "type": "string" }, "properties": { "description": "Required. Label properties to update.", "$ref": "GoogleAppsDriveLabelsV2betaLabelProperties" } } }, "GoogleAppsDriveLabelsV2betaUserLimits": { "description": "Limits for Field.Type.USER.", "properties": { "listLimits": { "description": "Limits for list-variant of a field type.", "$ref": "GoogleAppsDriveLabelsV2betaListLimits" } }, "id": "GoogleAppsDriveLabelsV2betaUserLimits", "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettingsEnabledApp": { "id": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettingsEnabledApp", "type": "object", "description": "An app where the label can be used.", "properties": { "app": { "description": "Optional. The name of the app.", "type": "string", "enumDescriptions": [ "Unspecified", "Drive", "Gmail" ], "enum": [ "APP_UNSPECIFIED", "DRIVE", "GMAIL" ] } } }, "GoogleAppsDriveLabelsV2betaUserInfo": { "id": "GoogleAppsDriveLabelsV2betaUserInfo", "type": "object", "description": "Information about a user.", "properties": { "person": { "description": "The identifier for this user that can be used with the [People API](https://developers.google.com/people) to get more information. For example, `people/12345678`.", "type": "string" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateLabelPropertiesResponse": { "description": "Response following update to label properties.", "properties": {}, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateLabelPropertiesResponse", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableFieldResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableFieldResponse", "type": "object", "description": "Response following field enable.", "properties": {} }, "GoogleAppsDriveLabelsV2betaFieldListOptions": { "description": "Options for a multi-valued variant of an associated field type.", "properties": { "maxEntries": { "type": "integer", "format": "int32", "description": "Maximum number of entries permitted." } }, "id": "GoogleAppsDriveLabelsV2betaFieldListOptions", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableFieldRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableFieldRequest", "type": "object", "description": "Request to enable the field.", "properties": { "id": { "description": "Required. ID of the field to enable.", "type": "string" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableFieldResponse": { "description": "Response following field disable.", "properties": {}, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableFieldResponse", "type": "object" }, "GoogleAppsDriveLabelsV2betaField": { "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.", "properties": { "userOptions": { "description": "User field options.", "$ref": "GoogleAppsDriveLabelsV2betaFieldUserOptions" }, "creator": { "description": "Output only. The user who created this field.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "disabler": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", "description": "Output only. The user who disabled this field. This value has no meaning when the field is not disabled." }, "lifecycle": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLifecycle", "description": "Output only. The lifecycle of this field." }, "properties": { "description": "The basic properties of the field.", "$ref": "GoogleAppsDriveLabelsV2betaFieldProperties" }, "disableTime": { "readOnly": true, "type": "string", "description": "Output only. The time this field was disabled. This value has no meaning when the field is not disabled.", "format": "google-datetime" }, "appliedCapabilities": { "description": "Output only. The capabilities this user has on this field and its value when the label is applied on Drive items.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaFieldAppliedCapabilities" }, "dateOptions": { "description": "Date field options.", "$ref": "GoogleAppsDriveLabelsV2betaFieldDateOptions" }, "textOptions": { "description": "Text field options.", "$ref": "GoogleAppsDriveLabelsV2betaFieldTextOptions" }, "selectionOptions": { "description": "Selection field options.", "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptions" }, "createTime": { "format": "google-datetime", "description": "Output only. The time this field was created.", "readOnly": true, "type": "string" }, "displayHints": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaFieldDisplayHints", "description": "Output only. UI display hints for rendering a field." }, "updateTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The time this field was updated." }, "id": { "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" }, "integerOptions": { "description": "Integer field options.", "$ref": "GoogleAppsDriveLabelsV2betaFieldIntegerOptions" }, "schemaCapabilities": { "description": "Output only. The capabilities this user has when editing this field.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities" }, "updater": { "description": "Output only. The user who modified this field.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "lockStatus": { "description": "Output only. The `LockStatus` of this field.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLockStatus" }, "queryKey": { "readOnly": true, "type": "string", "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\"." }, "publisher": { "description": "Output only. The user who published this field. This value has no meaning when the field is not published.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" } }, "id": "GoogleAppsDriveLabelsV2betaField", "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldLimits": { "id": "GoogleAppsDriveLabelsV2betaFieldLimits", "type": "object", "description": "Field constants governing the structure of a field; such as, the maximum title length, minimum and maximum field values or length, etc.", "properties": { "textLimits": { "description": "The relevant limits for the specified Field.Type. Text field limits.", "$ref": "GoogleAppsDriveLabelsV2betaTextLimits" }, "selectionLimits": { "description": "Selection field limits.", "$ref": "GoogleAppsDriveLabelsV2betaSelectionLimits" }, "maxDisplayNameLength": { "type": "integer", "description": "Limits for field title.", "format": "int32" }, "longTextLimits": { "description": "Long text field limits.", "$ref": "GoogleAppsDriveLabelsV2betaLongTextLimits" }, "maxIdLength": { "format": "int32", "description": "Maximum length for the id.", "type": "integer" }, "integerLimits": { "description": "Integer field limits.", "$ref": "GoogleAppsDriveLabelsV2betaIntegerLimits" }, "maxDescriptionLength": { "description": "Limits for field description, also called help text.", "format": "int32", "type": "integer" }, "dateLimits": { "description": "Date field limits.", "$ref": "GoogleAppsDriveLabelsV2betaDateLimits" }, "userLimits": { "description": "User field limits.", "$ref": "GoogleAppsDriveLabelsV2betaUserLimits" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateFieldRequest": { "description": "Request to create a field within a label.", "properties": { "field": { "description": "Required. Field to create.", "$ref": "GoogleAppsDriveLabelsV2betaField" } }, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateFieldRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelLock": { "description": "A lock that can be applied to a label, field, or choice.", "properties": { "createTime": { "format": "google-datetime", "description": "Output only. The time this label lock was created.", "readOnly": true, "type": "string" }, "deleteTime": { "description": "Output only. A timestamp indicating when this label lock was scheduled for deletion. Present only if this label lock is in the `DELETING` state.", "format": "google-datetime", "readOnly": true, "type": "string" }, "creator": { "description": "Output only. The user whose credentials were used to create the label lock. Not present if no user was responsible for creating the label lock.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "name": { "description": "Output only. Resource name of this label lock.", "readOnly": true, "type": "string" }, "state": { "readOnly": true, "type": "string", "enumDescriptions": [ "Unknown state.", "The label lock is active and is being enforced by the server.", "The label lock is being deleted. The label lock will continue to be enforced by the server until it has been fully removed." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "DELETING" ], "description": "Output only. This label lock's state." }, "fieldId": { "description": "The ID of the field that should be locked. Empty if the whole label should be locked.", "type": "string" }, "choiceId": { "description": "The ID of the selection field choice that should be locked. If present, `field_id` must also be present.", "type": "string" }, "capabilities": { "description": "Output only. The user's capabilities on this label lock.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLabelLockCapabilities" } }, "id": "GoogleAppsDriveLabelsV2betaLabelLock", "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelLimits": { "id": "GoogleAppsDriveLabelsV2betaLabelLimits", "type": "object", "description": "Label constraints governing the structure of a label; such as, the maximum number of fields allowed and maximum length of the label title.", "properties": { "maxTitleLength": { "description": "The maximum number of characters allowed for the title.", "format": "int32", "type": "integer" }, "maxDeletedFields": { "description": "The maximum number of published fields that can be deleted.", "format": "int32", "type": "integer" }, "maxDescriptionLength": { "format": "int32", "description": "The maximum number of characters allowed for the description.", "type": "integer" }, "maxFields": { "description": "The maximum number of fields allowed within the label.", "format": "int32", "type": "integer" }, "fieldLimits": { "description": "The limits for fields.", "$ref": "GoogleAppsDriveLabelsV2betaFieldLimits" }, "name": { "description": "Resource name.", "type": "string" }, "maxDraftRevisions": { "type": "integer", "format": "int32", "description": "The maximum number of draft revisions that will be kept before deleting old drafts." } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateFieldResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateFieldResponse", "type": "object", "description": "Response following field create.", "properties": { "id": { "description": "The field of the created field. When left blank in a create request, a key will be autogenerated and can be identified here.", "type": "string" }, "priority": { "format": "int32", "description": "The priority of the created field. The priority may change from what was specified to assure contiguous priorities between fields (1-n).", "type": "integer" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateSelectionChoiceResponse": { "description": "Response following selection choice create.", "properties": { "fieldId": { "description": "The server-generated ID of the field.", "type": "string" }, "id": { "description": "The server-generated ID of the created choice within the field.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateSelectionChoiceResponse", "type": "object" }, "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsRequest": { "description": "Updates one or more label permissions.", "properties": { "requests": { "description": "Required. The request message specifying the resources to update.", "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaUpdateLabelPermissionRequest" } }, "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. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or match this field.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaLongTextLimits": { "id": "GoogleAppsDriveLabelsV2betaLongTextLimits", "type": "object", "description": "Limits for long text field type.", "properties": { "maxLength": { "format": "int32", "description": "Maximum length allowed for a long text field type.", "type": "integer" }, "minLength": { "type": "integer", "description": "Minimum length allowed for a long text field type.", "format": "int32" } } }, "GoogleAppsDriveLabelsV2betaListLabelLocksResponse": { "id": "GoogleAppsDriveLabelsV2betaListLabelLocksResponse", "type": "object", "description": "The response to a `ListLabelLocksRequest`.", "properties": { "labelLocks": { "description": "Label locks.", "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaLabelLock" } }, "nextPageToken": { "description": "The token of the next page in the response.", "type": "string" } } }, "GoogleAppsDriveLabelsV2betaLifecycle": { "description": "The lifecycle state of an object, such as label, field, or choice. For more information, see [Label lifecycle](https://developers.google.com/workspace/drive/labels/guides/label-lifecycle). 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 aren't 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.", "properties": { "state": { "readOnly": true, "type": "string", "enumDescriptions": [ "Unknown State.", "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." ], "enum": [ "STATE_UNSPECIFIED", "UNPUBLISHED_DRAFT", "PUBLISHED", "DISABLED", "DELETED" ], "description": "Output only. The state of the object associated with this lifecycle." }, "disabledPolicy": { "description": "The policy that governs how to show a disabled label, field, or selection choice.", "$ref": "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy" }, "hasUnpublishedChanges": { "description": "Output only. Whether the object associated with this lifecycle has unpublished changes.", "readOnly": true, "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaLifecycle", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse", "type": "object", "description": "Response following update to selection choice properties.", "properties": { "priority": { "type": "integer", "format": "int32", "description": "The priority of the updated choice. The priority may change from what was specified to assure contiguous priorities between choices (1-n)." } } }, "GoogleTypeColor": { "id": "GoogleTypeColor", "type": "object", "description": "Represents a color in the RGBA color space. This representation is designed for simplicity of conversion to and from color representations in various languages over compactness. For example, the fields of this representation can be trivially provided to the constructor of `java.awt.Color` in Java; it can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha` method in iOS; and, with just a little work, it can be easily formatted into a CSS `rgba()` string in JavaScript. This reference page doesn't have information about the absolute color space that should be used to interpret the RGB value—for example, sRGB, Adobe RGB, DCI-P3, and BT.2020. By default, applications should assume the sRGB color space. When color equality needs to be decided, implementations, unless documented otherwise, treat two colors as equal if all their red, green, blue, and alpha values each differ by at most `1e-5`. Example (Java): import com.google.type.Color; // ... public static java.awt.Color fromProto(Color protocolor) { float alpha = protocolor.hasAlpha() ? protocolor.getAlpha().getValue() : 1.0; return new java.awt.Color( protocolor.getRed(), protocolor.getGreen(), protocolor.getBlue(), alpha); } public static Color toProto(java.awt.Color color) { float red = (float) color.getRed(); float green = (float) color.getGreen(); float blue = (float) color.getBlue(); float denominator = 255.0; Color.Builder resultBuilder = Color .newBuilder() .setRed(red / denominator) .setGreen(green / denominator) .setBlue(blue / denominator); int alpha = color.getAlpha(); if (alpha != 255) { result.setAlpha( FloatValue .newBuilder() .setValue(((float) alpha) / denominator) .build()); } return resultBuilder.build(); } // ... Example (iOS / Obj-C): // ... static UIColor* fromProto(Color* protocolor) { float red = [protocolor red]; float green = [protocolor green]; float blue = [protocolor blue]; FloatValue* alpha_wrapper = [protocolor alpha]; float alpha = 1.0; if (alpha_wrapper != nil) { alpha = [alpha_wrapper value]; } return [UIColor colorWithRed:red green:green blue:blue alpha:alpha]; } static Color* toProto(UIColor* color) { CGFloat red, green, blue, alpha; if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) { return nil; } Color* result = [[Color alloc] init]; [result setRed:red]; [result setGreen:green]; [result setBlue:blue]; if (alpha \u003c= 0.9999) { [result setAlpha:floatWrapperWithValue(alpha)]; } [result autorelease]; return result; } // ... Example (JavaScript): // ... var protoToCssColor = function(rgb_color) { var redFrac = rgb_color.red || 0.0; var greenFrac = rgb_color.green || 0.0; var blueFrac = rgb_color.blue || 0.0; var red = Math.floor(redFrac * 255); var green = Math.floor(greenFrac * 255); var blue = Math.floor(blueFrac * 255); if (!('alpha' in rgb_color)) { return rgbToCssColor(red, green, blue); } var alphaFrac = rgb_color.alpha.value || 0.0; var rgbParams = [red, green, blue].join(','); return ['rgba(', rgbParams, ',', alphaFrac, ')'].join(''); }; var rgbToCssColor = function(red, green, blue) { var rgbNumber = new Number((red \u003c\u003c 16) | (green \u003c\u003c 8) | blue); var hexString = rgbNumber.toString(16); var missingZeros = 6 - hexString.length; var resultBuilder = ['#']; for (var i = 0; i \u003c missingZeros; i++) { resultBuilder.push('0'); } resultBuilder.push(hexString); return resultBuilder.join(''); }; // ...", "properties": { "green": { "description": "The amount of green in the color as a value in the interval [0, 1].", "format": "float", "type": "number" }, "red": { "type": "number", "format": "float", "description": "The amount of red in the color as a value in the interval [0, 1]." }, "blue": { "description": "The amount of blue in the color as a value in the interval [0, 1].", "format": "float", "type": "number" }, "alpha": { "description": "The fraction of this color that should be applied to the pixel. That is, the final pixel color is defined by the equation: `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)` This means that a value of 1.0 corresponds to a solid color, whereas a value of 0.0 corresponds to a completely transparent color. This uses a wrapper message rather than a simple float scalar so that it is possible to distinguish between a default value and the value being unset. If omitted, this color object is rendered as a solid color (as if the alpha value had been explicitly given a value of 1.0).", "format": "float", "type": "number" } } }, "GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities": { "description": "The capabilities related to this field when editing the field.", "properties": { "canDelete": { "description": "Whether the user can delete this field. The user must have permission and the field must be deprecated.", "type": "boolean" }, "canEnable": { "description": "Whether the user can enable this field. The user must have permission and this field must be disabled.", "type": "boolean" }, "canUpdate": { "description": "Whether the user can change this field.", "type": "boolean" }, "canDisable": { "description": "Whether the user can disable this field. The user must have permission and this field must not already be disabled.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaFieldSchemaCapabilities", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableSelectionChoiceResponse": { "description": "Response following choice disable.", "properties": {}, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableSelectionChoiceResponse", "type": "object" }, "GoogleAppsDriveLabelsV2betaBatchDeleteLabelPermissionsRequest": { "description": "Deletes one or more label permissions.", "properties": { "requests": { "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaDeleteLabelPermissionRequest" }, "description": "Required. The request message specifying the resources to update." }, "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. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or match this field.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaBatchDeleteLabelPermissionsRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptions": { "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptions", "type": "object", "description": "Options for the selection field type.", "properties": { "listOptions": { "description": "When specified, indicates this field supports a list of values. Once the field is published, this cannot be changed.", "$ref": "GoogleAppsDriveLabelsV2betaFieldListOptions" }, "choices": { "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice" }, "description": "The options available for this selection field. The list order is consistent, and modified with `insert_before_choice`." } } }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice": { "description": "Selection field choice.", "properties": { "publisher": { "description": "Output only. The user who published this choice. This value has no meaning when the choice is not published.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "lockStatus": { "description": "Output only. The `LockStatus` of this choice.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLockStatus" }, "schemaCapabilities": { "description": "Output only. The capabilities related to this option when editing the option.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabilities" }, "updater": { "description": "Output only. The user who updated this choice last.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "id": { "description": "The unique value of the choice. This ID is autogenerated. Matches the regex: `([a-zA-Z0-9_])+`.", "type": "string" }, "displayHints": { "description": "Output only. UI display hints for rendering a choice.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceDisplayHints" }, "updateTime": { "format": "google-datetime", "description": "Output only. The time this choice was updated last.", "readOnly": true, "type": "string" }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The time this choice was created." }, "appliedCapabilities": { "description": "Output only. The capabilities related to this choice on applied metadata.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities" }, "publishTime": { "readOnly": true, "type": "string", "description": "Output only. The time this choice was published. This value has no meaning when the choice is not published.", "format": "google-datetime" }, "disableTime": { "readOnly": true, "type": "string", "description": "Output only. The time this choice was disabled. This value has no meaning when the choice is not disabled.", "format": "google-datetime" }, "properties": { "description": "Basic properties of the choice.", "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties" }, "lifecycle": { "description": "Output only. Lifecycle of the choice.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLifecycle" }, "creator": { "description": "Output only. The user who created this choice.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "disabler": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", "description": "Output only. The user who disabled this choice. This value has no meaning when the option is not disabled." } }, "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoice", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseResponse", "type": "object", "description": "A single response from an update.", "properties": { "createSelectionChoice": { "description": "Creates a selection list option to add to a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateSelectionChoiceResponse" }, "enableField": { "description": "Enables field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableFieldResponse" }, "enableSelectionChoice": { "description": "Enables a choice within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableSelectionChoiceResponse" }, "updateFieldType": { "description": "Updates field type and/or type options.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldTypeResponse" }, "deleteField": { "description": "Deletes a field from the label.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteFieldResponse" }, "deleteSelectionChoice": { "description": "Deletes a choice from a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteSelectionChoiceResponse" }, "disableSelectionChoice": { "description": "Disables a choice within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableSelectionChoiceResponse" }, "updateLabel": { "description": "Updates basic properties of a label.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateLabelPropertiesResponse" }, "createField": { "description": "Creates a field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseCreateFieldResponse" }, "disableField": { "description": "Disables field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDisableFieldResponse" }, "updateField": { "description": "Updates basic properties of a field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldPropertiesResponse" }, "updateSelectionChoiceProperties": { "description": "Updates a choice within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateSelectionChoicePropertiesResponse" } } }, "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy": { "id": "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy", "type": "object", "description": "The policy that governs how to treat a disabled label, field, or selection choice in different contexts.", "properties": { "showInApply": { "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" }, "hideInSearch": { "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" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteFieldResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseDeleteFieldResponse", "type": "object", "description": "Response following field delete.", "properties": {} }, "GoogleAppsDriveLabelsV2betaUpdateLabelEnabledAppSettingsRequest": { "id": "GoogleAppsDriveLabelsV2betaUpdateLabelEnabledAppSettingsRequest", "type": "object", "description": "Request to update the `EnabledAppSettings` of the given label. This change is not revisioned, doesn't require publishing, and takes effect immediately. \\", "properties": { "languageCode": { "description": "Optional. The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language will be used.", "type": "string" }, "enabledAppSettings": { "description": "Required. The new `EnabledAppSettings` value for the label.", "$ref": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings" }, "useAdminAccess": { "description": "Optional. 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.", "type": "boolean" }, "view": { "type": "string", "enumDescriptions": [ "Implies the field mask: `name,id,revision_id,label_type,properties.*`", "All possible fields." ], "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" ], "description": "Optional. When specified, only certain fields belonging to the indicated view will be returned." } } }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities": { "description": "The capabilities related to this choice on applied metadata.", "properties": { "canRead": { "description": "Whether the user can read related applied metadata on items.", "type": "boolean" }, "canSelect": { "description": "Whether the user can select this choice on an item.", "type": "boolean" }, "canSearch": { "description": "Whether the user can use this choice in search queries.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceAppliedCapabilities", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableSelectionChoiceRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableSelectionChoiceRequest", "type": "object", "description": "Request to enable a choice.", "properties": { "fieldId": { "description": "Required. The selection field in which a choice will be enabled.", "type": "string" }, "id": { "description": "Required. Choice to enable.", "type": "string" } } }, "GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy": { "id": "GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy", "type": "object", "description": "Behavior of this label when it's applied to Drive items.", "properties": { "copyMode": { "type": "string", "enumDescriptions": [ "Copy mode unspecified.", "The applied label and field values aren't 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." ], "enum": [ "COPY_MODE_UNSPECIFIED", "DO_NOT_COPY", "ALWAYS_COPY", "COPY_APPLIABLE" ], "description": "Indicates how the applied label and field values should be copied when a Drive item is copied." } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldTypeRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldTypeRequest", "type": "object", "description": "Request to change the type of a field.", "properties": { "updateMask": { "format": "google-fieldmask", "description": "The fields that should be updated. At least one field must be specified. The root of `type_options` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.", "type": "string" }, "textOptions": { "description": "Update field to Text.", "$ref": "GoogleAppsDriveLabelsV2betaFieldTextOptions" }, "integerOptions": { "description": "Update field to Integer.", "$ref": "GoogleAppsDriveLabelsV2betaFieldIntegerOptions" }, "selectionOptions": { "description": "Update field to Selection.", "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptions" }, "id": { "description": "Required. The field to update.", "type": "string" }, "dateOptions": { "description": "Update field to Date.", "$ref": "GoogleAppsDriveLabelsV2betaFieldDateOptions" }, "userOptions": { "description": "Update field to User.", "$ref": "GoogleAppsDriveLabelsV2betaFieldUserOptions" } } }, "GoogleAppsDriveLabelsV2betaLabel": { "id": "GoogleAppsDriveLabelsV2betaLabel", "type": "object", "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.", "properties": { "labelType": { "description": "Required. The type of label.", "type": "string", "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.", "A label owned by an internal Google application rather than a customer. These labels are read-only." ], "enum": [ "LABEL_TYPE_UNSPECIFIED", "SHARED", "ADMIN", "GOOGLE_APP" ] }, "createTime": { "description": "Output only. The time this label was created.", "format": "google-datetime", "readOnly": true, "type": "string" }, "displayHints": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLabelDisplayHints", "description": "Output only. UI display hints for rendering the label." }, "schemaCapabilities": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities", "description": "Output only. The capabilities the user has on this label." }, "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])+`.", "readOnly": true, "type": "string" }, "fields": { "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaField" }, "description": "List of fields in descending priority order." }, "enabledAppSettings": { "description": "Optional. The `EnabledAppSettings` for this Label.", "$ref": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings" }, "publisher": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", "description": "Output only. The user who published this label. This value has no meaning when the label isn't published.\u003e\u003e" }, "name": { "readOnly": true, "type": "string", "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." }, "learnMoreUri": { "description": "Custom URL to present to users to allow them to learn more about this label and how it should be used.", "type": "string" }, "lockStatus": { "description": "Output only. The `LockStatus` of this label.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLockStatus" }, "creator": { "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo", "description": "Output only. The user who created this label." }, "disabler": { "description": "Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "customer": { "readOnly": true, "type": "string", "description": "Output only. The customer this label belongs to. For example: `customers/123abc789`." }, "revisionId": { "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" }, "revisionCreateTime": { "readOnly": true, "type": "string", "description": "Output only. The time this label revision was created.", "format": "google-datetime" }, "properties": { "description": "Required. The basic properties of the label.", "$ref": "GoogleAppsDriveLabelsV2betaLabelProperties" }, "appliedLabelPolicy": { "description": "Output only. Behavior of this label when it's applied to Drive items.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLabelAppliedLabelPolicy" }, "lifecycle": { "description": "Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLifecycle" }, "disableTime": { "format": "google-datetime", "description": "Output only. The time this label was disabled. This value has no meaning when the label isn't disabled.", "readOnly": true, "type": "string" }, "revisionCreator": { "description": "Output only. The user who created this label revision.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaUserInfo" }, "publishTime": { "format": "google-datetime", "description": "Output only. The time this label was published. This value has no meaning when the label isn't published.", "readOnly": true, "type": "string" }, "appliedCapabilities": { "description": "Output only. The capabilities related to this label on applied metadata.", "readOnly": true, "$ref": "GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteFieldRequest": { "description": "Request to delete the field.", "properties": { "id": { "description": "Required. ID of the field to delete.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteFieldRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldTypeResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldTypeResponse", "type": "object", "description": "Response following update to field type.", "properties": {} }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties": { "description": "Basic properties of the choice.", "properties": { "description": { "description": "The description of this label.", "type": "string" }, "displayName": { "description": "Required. The display text to show in the UI identifying this field.", "type": "string" }, "badgeConfig": { "description": "The badge configuration for this choice. When set, the label that owns this choice is considered a \"badged label\".", "$ref": "GoogleAppsDriveLabelsV2betaBadgeConfig" }, "insertBeforeChoice": { "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" } }, "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest", "type": "object", "description": "Request to update a choice property.", "properties": { "id": { "description": "Required. The choice to update.", "type": "string" }, "updateMask": { "format": "google-fieldmask", "description": "The fields that should be updated. At least one field must be specified. The root `properties` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.", "type": "string" }, "fieldId": { "description": "Required. The selection field to update.", "type": "string" }, "properties": { "description": "Required. The choice properties to update.", "$ref": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceProperties" } } }, "GoogleAppsDriveLabelsV2betaUpdateLabelPermissionRequest": { "id": "GoogleAppsDriveLabelsV2betaUpdateLabelPermissionRequest", "type": "object", "description": "Updates a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "properties": { "labelPermission": { "description": "Required. The permission to create or update on the label.", "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" }, "parent": { "description": "Required. The parent label resource name.", "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.", "type": "boolean" } } }, "GoogleAppsDriveLabelsV2betaFieldAppliedCapabilities": { "description": "The capabilities related to this field on applied metadata.", "properties": { "canSearch": { "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.", "type": "boolean" }, "canRead": { "description": "Whether the user can read related applied metadata on items.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaFieldAppliedCapabilities", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldPropertiesResponse": { "description": "Response following update to field properties.", "properties": { "priority": { "type": "integer", "description": "The priority of the updated field. The priority may change from what was specified to assure contiguous priorities between fields (1-n).", "format": "int32" } }, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseUpdateFieldPropertiesResponse", "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldTextOptions": { "description": "Options for the Text field type.", "properties": { "maxLength": { "format": "int32", "description": "Output only. The maximum valid length of values for the text field.", "readOnly": true, "type": "integer" }, "minLength": { "readOnly": true, "type": "integer", "format": "int32", "description": "Output only. The minimum valid length of values for the text field." } }, "id": "GoogleAppsDriveLabelsV2betaFieldTextOptions", "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelPermission": { "description": "The permission that applies to a principal (user, group, audience) on a label.", "properties": { "group": { "description": "Group resource name.", "type": "string" }, "audience": { "description": "Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label.", "type": "string" }, "email": { "description": "Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.", "type": "string" }, "name": { "description": "Resource name of this permission.", "type": "string" }, "role": { "type": "string", "enumDescriptions": [ "Unknown role.", "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 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`." ], "enum": [ "LABEL_ROLE_UNSPECIFIED", "READER", "APPLIER", "ORGANIZER", "EDITOR" ], "description": "The role the principal should have." }, "person": { "description": "Person resource name.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaLabelPermission", "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelDisplayHints": { "id": "GoogleAppsDriveLabelsV2betaLabelDisplayHints", "type": "object", "description": "The UI display hints for rendering the label.", "properties": { "shownInApply": { "description": "This label should be shown in the apply menu when applying values to a Drive item.", "type": "boolean" }, "priority": { "description": "The order to display labels in a list.", "format": "int64", "type": "string" }, "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.", "type": "boolean" } } }, "GoogleAppsDriveLabelsV2betaSelectionLimits": { "description": "Limits for selection field type.", "properties": { "maxDisplayNameLength": { "format": "int32", "description": "Maximum length for display name.", "type": "integer" }, "listLimits": { "description": "Limits for list-variant of a field type.", "$ref": "GoogleAppsDriveLabelsV2betaListLimits" }, "maxDeletedChoices": { "format": "int32", "description": "Maximum number of deleted choices.", "type": "integer" }, "maxIdLength": { "format": "int32", "description": "Maximum ID length for a selection option.", "type": "integer" }, "maxChoices": { "type": "integer", "format": "int32", "description": "Maximum number of choices." } }, "id": "GoogleAppsDriveLabelsV2betaSelectionLimits", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequest": { "description": "The set of requests for updating aspects of a label. If any request isn't valid, no requests will be applied.", "properties": { "writeControl": { "description": "Provides control over how write requests are executed.", "$ref": "GoogleAppsDriveLabelsV2betaWriteControl" }, "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.", "type": "boolean" }, "requests": { "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestRequest" }, "description": "A list of updates to apply to the label. Requests will be applied in the order they are specified." }, "view": { "description": "When specified, only certain fields belonging to the indicated view will be returned.", "enumDescriptions": [ "Implies the field mask: `name,id,revision_id,label_type,properties.*`", "All possible fields." ], "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" ], "type": "string" }, "languageCode": { "description": "The BCP-47 language code to use for evaluating localized field labels when `include_label_in_response` is `true`.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldUserOptions": { "id": "GoogleAppsDriveLabelsV2betaFieldUserOptions", "type": "object", "description": "Options for the user field type.", "properties": { "listOptions": { "description": "When specified, indicates that this field supports a list of values. Once the field is published, this cannot be changed.", "$ref": "GoogleAppsDriveLabelsV2betaFieldListOptions" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestRequest": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestRequest", "type": "object", "description": "A single kind of update to apply to a label.", "properties": { "disableSelectionChoice": { "description": "Disable a choice within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableSelectionChoiceRequest" }, "updateField": { "description": "Updates basic properties of a field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldPropertiesRequest" }, "updateSelectionChoiceProperties": { "description": "Update a choice property within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateSelectionChoicePropertiesRequest" }, "disableField": { "description": "Disables the field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableFieldRequest" }, "createField": { "description": "Creates a field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateFieldRequest" }, "updateLabel": { "description": "Updates the label properties.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateLabelPropertiesRequest" }, "enableSelectionChoice": { "description": "Enable a choice within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableSelectionChoiceRequest" }, "enableField": { "description": "Enables the field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestEnableFieldRequest" }, "createSelectionChoice": { "description": "Create a choice within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestCreateSelectionChoiceRequest" }, "deleteSelectionChoice": { "description": "Delete a choice within a selection field.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteSelectionChoiceRequest" }, "updateFieldType": { "description": "Update field type and/or type options.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestUpdateFieldTypeRequest" }, "deleteField": { "description": "Deletes a field from the label.", "$ref": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDeleteFieldRequest" } } }, "GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities": { "description": "The capabilities related to this label when editing the label.", "properties": { "canUpdate": { "description": "Whether the user can change this label.", "type": "boolean" }, "canDelete": { "description": "Whether the user can delete this label. The user must have permission and the label must be disabled.", "type": "boolean" }, "canEnable": { "description": "Whether the user can enable this label. The user must have permission and this 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.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaLabelSchemaCapabilities", "type": "object" }, "GoogleAppsDriveLabelsV2betaPublishLabelRequest": { "id": "GoogleAppsDriveLabelsV2betaPublishLabelRequest", "type": "object", "description": "Request to publish a label.", "properties": { "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.", "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.", "type": "boolean" }, "writeControl": { "description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins.", "$ref": "GoogleAppsDriveLabelsV2betaWriteControl" } } }, "GoogleAppsDriveLabelsV2betaBadgeConfig": { "id": "GoogleAppsDriveLabelsV2betaBadgeConfig", "type": "object", "description": "Badge status of the label.", "properties": { "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.", "$ref": "GoogleTypeColor" }, "priorityOverride": { "type": "string", "description": "Override the default global priority of this badge. When set to 0, the default priority heuristic is used.", "format": "int64" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableSelectionChoiceResponse": { "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelResponseEnableSelectionChoiceResponse", "type": "object", "description": "Response following choice enable.", "properties": {} }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableFieldRequest": { "description": "Request to disable the field.", "properties": { "updateMask": { "description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.", "format": "google-fieldmask", "type": "string" }, "disabledPolicy": { "description": "Required. Field disabled policy.", "$ref": "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy" }, "id": { "description": "Required. Key of the field to disable.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableFieldRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaBadgeColors": { "id": "GoogleAppsDriveLabelsV2betaBadgeColors", "type": "object", "description": "The color derived from BadgeConfig and changed to the closest recommended supported color.", "properties": { "foregroundColor": { "description": "Output only. Badge foreground that pairs with the background.", "readOnly": true, "$ref": "GoogleTypeColor" }, "backgroundColor": { "readOnly": true, "$ref": "GoogleTypeColor", "description": "Output only. Badge background that pairs with the foreground." }, "soloColor": { "description": "Output only. Color that can be used for text without a background.", "readOnly": true, "$ref": "GoogleTypeColor" } } }, "GoogleAppsDriveLabelsV2betaIntegerLimits": { "id": "GoogleAppsDriveLabelsV2betaIntegerLimits", "type": "object", "description": "Limits for integer field type.", "properties": { "maxValue": { "type": "string", "format": "int64", "description": "Maximum value for an integer field type." }, "minValue": { "type": "string", "description": "Minimum value for an integer field type.", "format": "int64" } } }, "GoogleAppsDriveLabelsV2betaLabelProperties": { "description": "Basic properties of the label.", "properties": { "title": { "description": "Required. Title of the label.", "type": "string" }, "description": { "description": "The description of the label.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaLabelProperties", "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldProperties": { "id": "GoogleAppsDriveLabelsV2betaFieldProperties", "type": "object", "description": "The basic properties of the field.", "properties": { "displayName": { "description": "Required. The display text to show in the UI identifying this field.", "type": "string" }, "required": { "description": "Whether the field should be marked as required.", "type": "boolean" }, "insertBeforeField": { "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" } } }, "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableSelectionChoiceRequest": { "description": "Request to disable a choice.", "properties": { "updateMask": { "type": "string", "description": "The fields that should be updated. At least one field must be specified. The root `disabled_policy` is implied and should not be specified. A single `*` can be used as a short-hand for updating every field.", "format": "google-fieldmask" }, "fieldId": { "description": "Required. The selection field in which a choice will be disabled.", "type": "string" }, "disabledPolicy": { "description": "Required. The disabled policy to update.", "$ref": "GoogleAppsDriveLabelsV2betaLifecycleDisabledPolicy" }, "id": { "description": "Required. Choice to disable.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaDeltaUpdateLabelRequestDisableSelectionChoiceRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaDeleteLabelPermissionRequest": { "id": "GoogleAppsDriveLabelsV2betaDeleteLabelPermissionRequest", "type": "object", "description": "Deletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.", "properties": { "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.", "type": "boolean" }, "name": { "description": "Required. Label permission resource name.", "type": "string" } } }, "GoogleAppsDriveLabelsV2betaListLimits": { "id": "GoogleAppsDriveLabelsV2betaListLimits", "type": "object", "description": "Limits for list-variant of a field type.", "properties": { "maxEntries": { "format": "int32", "description": "Maximum number of values allowed for the field type.", "type": "integer" } } }, "GoogleAppsDriveLabelsV2betaLabelLockCapabilities": { "description": "A description of a user's capabilities on a label lock.", "properties": { "canViewPolicy": { "description": "True if the user is authorized to view the policy.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaLabelLockCapabilities", "type": "object" }, "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsResponse": { "id": "GoogleAppsDriveLabelsV2betaBatchUpdateLabelPermissionsResponse", "type": "object", "description": "Response for updating one or more label permissions.", "properties": { "permissions": { "description": "Required. Permissions updated.", "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaLabelPermission" } } } }, "GoogleAppsDriveLabelsV2betaEnableLabelRequest": { "id": "GoogleAppsDriveLabelsV2betaEnableLabelRequest", "type": "object", "description": "Request to enable a label.", "properties": { "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.", "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.", "type": "boolean" }, "writeControl": { "description": "Provides control over how write requests are executed. Defaults to unset, which means the last write wins.", "$ref": "GoogleAppsDriveLabelsV2betaWriteControl" } } }, "GoogleAppsDriveLabelsV2betaListLabelsResponse": { "id": "GoogleAppsDriveLabelsV2betaListLabelsResponse", "type": "object", "description": "Response for listing labels.", "properties": { "labels": { "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaLabel" }, "description": "Labels." }, "nextPageToken": { "description": "The token of the next page in the response.", "type": "string" } } }, "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings": { "id": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettings", "type": "object", "description": "Describes the Google Workspace apps in which the label can be used.", "properties": { "enabledApps": { "type": "array", "items": { "$ref": "GoogleAppsDriveLabelsV2betaLabelEnabledAppSettingsEnabledApp" }, "description": "Optional. The list of apps where the label can be used." } } }, "GoogleAppsDriveLabelsV2betaWriteControl": { "description": "Provides control over how write requests are executed. When not specified, the last write wins.", "properties": { "requiredRevisionId": { "description": "The revision ID of the label that the write request will be applied to. If this isn't the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.", "type": "string" } }, "id": "GoogleAppsDriveLabelsV2betaWriteControl", "type": "object" }, "GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities": { "id": "GoogleAppsDriveLabelsV2betaLabelAppliedCapabilities", "type": "object", "description": "The capabilities a user has on this label's applied metadata.", "properties": { "canRead": { "description": "Whether the user can read applied metadata related to this label.", "type": "boolean" }, "canRemove": { "description": "Whether the user can remove this label from items.", "type": "boolean" }, "canApply": { "description": "Whether the user can apply this label to items.", "type": "boolean" } } }, "GoogleAppsDriveLabelsV2betaUpdateLabelCopyModeRequest": { "description": "Request to update the `CopyMode` of the given label. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately. \\", "properties": { "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.", "type": "boolean" }, "view": { "description": "When specified, only certain fields belonging to the indicated view will be returned.", "enumDescriptions": [ "Implies the field mask: `name,id,revision_id,label_type,properties.*`", "All possible fields." ], "enum": [ "LABEL_VIEW_BASIC", "LABEL_VIEW_FULL" ], "type": "string" }, "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.", "type": "string" }, "copyMode": { "enumDescriptions": [ "Copy mode unspecified.", "The applied label and field values aren't 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." ], "enum": [ "COPY_MODE_UNSPECIFIED", "DO_NOT_COPY", "ALWAYS_COPY", "COPY_APPLIABLE" ], "type": "string", "description": "Required. Indicates how the applied label and field values should be copied when a Drive item is copied." } }, "id": "GoogleAppsDriveLabelsV2betaUpdateLabelCopyModeRequest", "type": "object" }, "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabilities": { "description": "The capabilities related to this choice when editing the choice.", "properties": { "canUpdate": { "description": "Whether the user can update this choice.", "type": "boolean" }, "canDelete": { "description": "Whether the user can delete this choice.", "type": "boolean" }, "canEnable": { "description": "Whether the user can enable this choice.", "type": "boolean" }, "canDisable": { "description": "Whether the user can disable this choice.", "type": "boolean" } }, "id": "GoogleAppsDriveLabelsV2betaFieldSelectionOptionsChoiceSchemaCapabilities", "type": "object" }, "GoogleAppsDriveLabelsV2betaUserCapabilities": { "id": "GoogleAppsDriveLabelsV2betaUserCapabilities", "type": "object", "description": "The capabilities of a user.", "properties": { "name": { "readOnly": true, "type": "string", "description": "Output only. Resource name for the user capabilities." }, "canAdministrateLabels": { "readOnly": true, "type": "boolean", "description": "Output only. Whether the user is an administrator for the shared labels feature." }, "canCreateAdminLabels": { "description": "Output only. Whether the user is allowed to create admin labels.", "readOnly": true, "type": "boolean" }, "canAccessLabelManager": { "description": "Output only. Whether the user is allowed access to the label manager.", "readOnly": true, "type": "boolean" }, "canCreateSharedLabels": { "readOnly": true, "type": "boolean", "description": "Output only. Whether the user is allowed to create shared labels." } } } }, "basePath": "", "description": "An API for managing Drive Labels", "version_module": true, "canonicalName": "Drive Labels", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" } }