{"openapi":"3.0.0","info":{"description":"An API for managing Drive Labels","version":[{"name":"v2","value":"v2"}]},"servers":[{"description":"An API for managing Drive Labels","url":"https://api.apirails.com/googledrivelabels"}],"paths":{"/v2/labels":{"get":{"tags":["File Storage"],"parameters":[{"name":"customer","in":"query","description":"The customer to scope this list request to. For example: `customers/abcd1234`. If unset, will return all labels within the current customer.","required":false,"schema":{"type":"string","example":""}},{"name":"languageCode","in":"query","description":"The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.","required":false,"schema":{"type":"string","example":""}},{"name":"minimumRole","in":"query","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`.","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["LABEL_ROLE_UNSPECIFIED","READER","APPLIER","ORGANIZER","EDITOR"]}}},{"name":"pageSize","in":"query","description":"Maximum number of labels to return per page. Default: 50. Max: 200.","required":false,"schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token of the page to return.","required":false,"schema":{"type":"string","example":""}},{"name":"publishedOnly","in":"query","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","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"useAdminAccess","in":"query","description":"Set to `true` in order to use the user's admin credentials. This will return all labels within the customer.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"view","in":"query","description":"When specified, only certain fields belonging to the indicated view are returned.","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["LABEL_VIEW_BASIC","LABEL_VIEW_FULL"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/list","api_endpoint":"https://drivelabels.googleapis.com/v2/labels"},"summary":"List labels","description":"List labels. For more information, see [Search for labels](https://developers.google.com/workspace/drive/labels/guides/search-label).","security":[{"bearerAuth":[]}]},"post":{"tags":["Labels"],"parameters":[{"name":"languageCode","in":"query","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.","required":false,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/create","api_endpoint":"https://drivelabels.googleapis.com/v2/labels"},"summary":"Create label","description":"Creates a label. For more information, see [Create and publish a label](https://developers.google.com/workspace/drive/labels/guides/create-label).","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"appliedCapabilities":{"type":"object","description":"Output only. The capabilities related to this label on applied metadata.","properties":{"canApply":{"type":"boolean","description":"Whether the user can apply this label to items.","enum":[true,false]},"canRead":{"type":"boolean","description":"Whether the user can read applied metadata related to this label.","enum":[true,false]},"canRemove":{"type":"boolean","description":"Whether the user can remove this label from items.","enum":[true,false]}}},"appliedLabelPolicy":{"type":"object","description":"Output only. Behavior of this label when it's applied to Drive items.","properties":{"copyMode":{"type":"string","description":"Indicates how the applied label and field values should be copied when a Drive item is copied.","enum":["COPY_MODE_UNSPECIFIED","DO_NOT_COPY","ALWAYS_COPY","COPY_APPLIABLE"]}}},"createTime":{"type":"string","description":"Output only. The time this label was created."},"creator":{"type":"object","description":"Output only. The user who created this label.","properties":{"person":{"type":"string","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`."}}},"customer":{"type":"string","description":"Output only. The customer this label belongs to. For example: `customers/123abc789`."},"disableTime":{"type":"string","description":"Output only. The time this label was disabled. This value has no meaning when the label isn't disabled."},"disabler":{"type":"object","description":"Output only. The user who disabled this label. This value has no meaning when the label isn't disabled.","properties":{"person":{"type":"string","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`."}}},"displayHints":{"type":"object","description":"Output only. UI display hints for rendering the label.","properties":{"disabled":{"type":"boolean","description":"Whether the label should be shown in the UI as disabled.","enum":[true,false]},"hiddenInSearch":{"type":"boolean","description":"This label should be hidden in the search menu when searching for Drive items.","enum":[true,false]},"priority":{"type":"string","description":"The order to display labels in a list."},"shownInApply":{"type":"boolean","description":"This label should be shown in the apply menu when applying values to a Drive item.","enum":[true,false]}}},"enabledAppSettings":{"type":"object","description":"Optional. The `EnabledAppSettings` for this Label.","properties":{"enabledApps":{"type":"array","description":"Optional. The list of apps where the label can be used."}}},"fields":{"type":"array","description":"List of fields in descending priority order.","items":{"type":"object","properties":{"appliedCapabilities":{"type":"object","description":"Output only. The capabilities this user has on this field and its value when the label is applied on Drive items."},"createTime":{"type":"string","description":"Output only. The time this field was created."},"creator":{"type":"object","description":"Output only. The user who created this field."},"dateOptions":{"type":"object","description":"Date field options."},"disableTime":{"type":"string","description":"Output only. The time this field was disabled. This value has no meaning when the field is not disabled."},"disabler":{"type":"object","description":"Output only. The user who disabled this field. This value has no meaning when the field is not disabled."},"displayHints":{"type":"object","description":"Output only. UI display hints for rendering a field."},"id":{"type":"string","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])+`."},"integerOptions":{"type":"object","description":"Integer field options."},"lifecycle":{"type":"object","description":"Output only. The lifecycle of this field."},"lockStatus":{"type":"object","description":"Output only. The `LockStatus` of this field."},"properties":{"type":"object","description":"The basic properties of the field."},"publisher":{"type":"object","description":"Output only. The user who published this field. This value has no meaning when the field is not published."},"queryKey":{"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}` > 2001-01-01\"."},"schemaCapabilities":{"type":"object","description":"Output only. The capabilities this user has when editing this field."},"selectionOptions":{"type":"object","description":"Selection field options."},"textOptions":{"type":"object","description":"Text field options."},"updateTime":{"type":"string","description":"Output only. The time this field was updated."},"updater":{"type":"object","description":"Output only. The user who modified this field."},"userOptions":{"type":"object","description":"User field options."}}}},"id":{"type":"string","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])+`."},"labelType":{"type":"string","description":"Required. The type of label.","enum":["LABEL_TYPE_UNSPECIFIED","SHARED","ADMIN","GOOGLE_APP"]},"learnMoreUri":{"type":"string","description":"Custom URL to present to users to allow them to learn more about this label and how it should be used."},"lifecycle":{"type":"object","description":"Output only. The lifecycle state of the label including whether it's published, deprecated, and has draft changes.","properties":{"disabledPolicy":{"type":"object","description":"The policy that governs how to show a disabled label, field, or selection choice."},"hasUnpublishedChanges":{"type":"boolean","description":"Output only. Whether the object associated with this lifecycle has unpublished changes.","enum":[true,false]},"state":{"type":"string","description":"Output only. The state of the object associated with this lifecycle.","enum":["STATE_UNSPECIFIED","UNPUBLISHED_DRAFT","PUBLISHED","DISABLED","DELETED"]}}},"lockStatus":{"type":"object","description":"Output only. The `LockStatus` of this label.","properties":{"locked":{"type":"boolean","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.","enum":[true,false]}}},"name":{"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."},"properties":{"type":"object","description":"Required. The basic properties of the label.","properties":{"description":{"type":"string","description":"The description of the label."},"title":{"type":"string","description":"Required. Title of the label."}}},"publishTime":{"type":"string","description":"Output only. The time this label was published. This value has no meaning when the label isn't published."},"publisher":{"type":"object","description":"Output only. The user who published this label. This value has no meaning when the label isn't published.>>","properties":{"person":{"type":"string","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`."}}},"revisionCreateTime":{"type":"string","description":"Output only. The time this label revision was created."},"revisionCreator":{"type":"object","description":"Output only. The user who created this label revision.","properties":{"person":{"type":"string","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`."}}},"revisionId":{"type":"string","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])+`."},"schemaCapabilities":{"type":"object","description":"Output only. The capabilities the user has on this label.","properties":{"canDelete":{"type":"boolean","description":"Whether the user can delete this label. The user must have permission and the label must be disabled.","enum":[true,false]},"canDisable":{"type":"boolean","description":"Whether the user can disable this label. The user must have permission and this label must not already be disabled.","enum":[true,false]},"canEnable":{"type":"boolean","description":"Whether the user can enable this label. The user must have permission and this label must be disabled.","enum":[true,false]},"canUpdate":{"type":"boolean","description":"Whether the user can change this label.","enum":[true,false]}}}}},"example":{"appliedCapabilities":{},"appliedLabelPolicy":{},"createTime":"value","creator":{},"customer":"value","disableTime":"value","disabler":{},"displayHints":{},"enabledAppSettings":{},"fields":["value"],"id":"id-123","labelType":"LABEL_TYPE_UNSPECIFIED","learnMoreUri":"value","lifecycle":{},"lockStatus":{},"name":"value","properties":{},"publishTime":"value","publisher":{},"revisionCreateTime":"value","revisionCreator":{},"revisionId":"id-123","schemaCapabilities":{}}}}}}},"/v2/labels/{labelsId}/revisions/{revisionsId}/permissions":{"get":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"revisionsId","in":"path","description":"The revisionsId path segment — identifier of the revisionsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Maximum number of permissions to return per page. Default: 50. Max: 200.","required":false,"schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token of the page to return.","required":false,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.revisions.permissions/list","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/revisions/{revisionsId}/permissions"},"summary":"List permissions","description":"Lists a label's permissions.","security":[{"bearerAuth":[]}]},"post":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"revisionsId","in":"path","description":"The revisionsId path segment — identifier of the revisionsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.revisions.permissions/create","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/revisions/{revisionsId}/permissions"},"summary":"Create permission","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 publis","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"audience":{"type":"string","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."},"email":{"type":"string","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."},"group":{"type":"string","description":"Group resource name."},"name":{"type":"string","description":"Resource name of this permission."},"person":{"type":"string","description":"Person resource name."},"role":{"type":"string","description":"The role the principal should have.","enum":["LABEL_ROLE_UNSPECIFIED","READER","APPLIER","ORGANIZER","EDITOR"]}}},"example":{"audience":"value","email":"value","group":"value","name":"value","person":"value","role":"LABEL_ROLE_UNSPECIFIED"}}}}},"patch":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"revisionsId","in":"path","description":"The revisionsId path segment — identifier of the revisionsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.revisions/updatePermissions","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/revisions/{revisionsId}/permissions"},"summary":"Update revision permissions","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 publis","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"audience":{"type":"string","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."},"email":{"type":"string","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."},"group":{"type":"string","description":"Group resource name."},"name":{"type":"string","description":"Resource name of this permission."},"person":{"type":"string","description":"Person resource name."},"role":{"type":"string","description":"The role the principal should have.","enum":["LABEL_ROLE_UNSPECIFIED","READER","APPLIER","ORGANIZER","EDITOR"]}}},"example":{"audience":"value","email":"value","group":"value","name":"value","person":"value","role":"LABEL_ROLE_UNSPECIFIED"}}}}}},"/v2/labels/{labelsId}/revisions/{revisionsId}/locks":{"get":{"tags":["Locks"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"revisionsId","in":"path","description":"The revisionsId path segment — identifier of the revisionsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Maximum number of locks to return per page. Default: 100. Max: 200.","required":false,"schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token of the page to return.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.revisions.locks/list","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/revisions/{revisionsId}/locks"},"summary":"List locks","description":"Lists the label locks on a label.","security":[{"bearerAuth":[]}]}},"/v2/labels/{labelsId}/permissions":{"get":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Maximum number of permissions to return per page. Default: 50. Max: 200.","required":false,"schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token of the page to return.","required":false,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.permissions/list","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/permissions"},"summary":"List label permissions","description":"Lists a label's permissions.","security":[{"bearerAuth":[]}]},"post":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.permissions/create","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/permissions"},"summary":"Create label permission","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 publis","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"audience":{"type":"string","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."},"email":{"type":"string","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."},"group":{"type":"string","description":"Group resource name."},"name":{"type":"string","description":"Resource name of this permission."},"person":{"type":"string","description":"Person resource name."},"role":{"type":"string","description":"The role the principal should have.","enum":["LABEL_ROLE_UNSPECIFIED","READER","APPLIER","ORGANIZER","EDITOR"]}}},"example":{"audience":"value","email":"value","group":"value","name":"value","person":"value","role":"LABEL_ROLE_UNSPECIFIED"}}}}},"patch":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/updatePermissions","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/permissions"},"summary":"Update label permissions","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 publis","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"audience":{"type":"string","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."},"email":{"type":"string","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."},"group":{"type":"string","description":"Group resource name."},"name":{"type":"string","description":"Resource name of this permission."},"person":{"type":"string","description":"Person resource name."},"role":{"type":"string","description":"The role the principal should have.","enum":["LABEL_ROLE_UNSPECIFIED","READER","APPLIER","ORGANIZER","EDITOR"]}}},"example":{"audience":"value","email":"value","group":"value","name":"value","person":"value","role":"LABEL_ROLE_UNSPECIFIED"}}}}}},"/v2/labels/{labelsId}/locks":{"get":{"tags":["Locks"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"Maximum number of locks to return per page. Default: 100. Max: 200.","required":false,"schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token of the page to return.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.locks/list","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/locks"},"summary":"List label locks","description":"Lists the label locks on a label.","security":[{"bearerAuth":[]}]}},"/v2/labels/{labelsId}":{"get":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"languageCode","in":"query","description":"The BCP-47 language code to use for evaluating localized field labels. When not specified, values in the default configured language are used.","required":false,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"view","in":"query","description":"When specified, only certain fields belonging to the indicated view are returned.","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["LABEL_VIEW_BASIC","LABEL_VIEW_FULL"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/get","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}"},"summary":"Get label","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","security":[{"bearerAuth":[]}]},"delete":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"writeControl.requiredRevisionId","in":"query","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.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/delete","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}"},"summary":"Delete label","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 m","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/labels/{labelsId}/revisions/{revisionsId}/permissions/{permissionsId}":{"delete":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"permissionsId","in":"path","description":"The permissionsId path segment — identifier of the permissionsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"revisionsId","in":"path","description":"The revisionsId path segment — identifier of the revisionsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.revisions.permissions/delete","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/revisions/{revisionsId}/permissions/{permissionsId}"},"summary":"Delete permission","description":"Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/labels/{labelsId}/permissions/{permissionsId}":{"delete":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"permissionsId","in":"path","description":"The permissionsId path segment — identifier of the permissionsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"useAdminAccess","in":"query","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.","required":false,"schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.permissions/delete","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/permissions/{permissionsId}"},"summary":"Delete label permission","description":"Deletes a label's permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v2/labels/{labelsId}/enable":{"post":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/enable","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}:enable"},"summary":"Enable label","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","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"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 will be used."},"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.","enum":[true,false]},"writeControl":{"type":"object","description":"Provides control over how write requests are executed. Defaults to unset, which means the last write wins.","properties":{"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."}}}}},"example":{"languageCode":"en","useAdminAccess":"","writeControl":{}}}}}}},"/v2/labels/{labelsId}/publish":{"post":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/publish","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}:publish"},"summary":"Publish label","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 resul","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"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 will be used."},"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.","enum":[true,false]},"writeControl":{"type":"object","description":"Provides control over how write requests are executed. Defaults to unset, which means the last write wins.","properties":{"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."}}}}},"example":{"languageCode":"en","useAdminAccess":"","writeControl":{}}}}}}},"/v2/labels/{labelsId}/disable":{"post":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/disable","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}:disable"},"summary":"Disable label","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 curren","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"disabledPolicy":{"type":"object","description":"Disabled policy to use.","properties":{"hideInSearch":{"type":"boolean","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 t","enum":[true,false]},"showInApply":{"type":"boolean","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.","enum":[true,false]}}},"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 will be used."},"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."},"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.","enum":[true,false]},"writeControl":{"type":"object","description":"Provides control over how write requests are executed. Defaults to unset, which means the last write wins.","properties":{"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."}}}}},"example":{"disabledPolicy":{},"languageCode":"en","updateMask":"value","useAdminAccess":"","writeControl":{}}}}}}},"/v2/labels/{labelsId}/delta":{"post":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/delta","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}:delta"},"summary":"List label deltas","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 t","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"languageCode":{"type":"string","description":"The BCP-47 language code to use for evaluating localized field labels when `include_label_in_response` is `true`."},"requests":{"type":"array","description":"A list of updates to apply to the label. Requests will be applied in the order they are specified.","items":{"type":"object","properties":{"createField":{"type":"object","description":"Creates a field."},"createSelectionChoice":{"type":"object","description":"Create a choice within a selection field."},"deleteField":{"type":"object","description":"Deletes a field from the label."},"deleteSelectionChoice":{"type":"object","description":"Delete a choice within a selection field."},"disableField":{"type":"object","description":"Disables the field."},"disableSelectionChoice":{"type":"object","description":"Disable a choice within a selection field."},"enableField":{"type":"object","description":"Enables the field."},"enableSelectionChoice":{"type":"object","description":"Enable a choice within a selection field."},"updateField":{"type":"object","description":"Updates basic properties of a field."},"updateFieldType":{"type":"object","description":"Update field type and/or type options."},"updateLabel":{"type":"object","description":"Updates the label properties."},"updateSelectionChoiceProperties":{"type":"object","description":"Update a choice property within a selection field."}}}},"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.","enum":[true,false]},"view":{"type":"string","description":"When specified, only certain fields belonging to the indicated view will be returned.","enum":["LABEL_VIEW_BASIC","LABEL_VIEW_FULL"]},"writeControl":{"type":"object","description":"Provides control over how write requests are executed.","properties":{"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."}}}}},"example":{"languageCode":"en","requests":["value"],"useAdminAccess":"","view":"LABEL_VIEW_BASIC","writeControl":{}}}}}}},"/v2/labels/{labelsId}/revisions/{revisionsId}/permissions/batchUpdate":{"post":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"revisionsId","in":"path","description":"The revisionsId path segment — identifier of the revisionsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.revisions.permissions/batchUpdate","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/revisions/{revisionsId}/permissions:batchUpdate"},"summary":"Batch update revision permissions","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","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. The request message specifying the resources to update.","items":{"type":"object","properties":{"labelPermission":{"type":"object","description":"Required. The permission to create or update on the label."},"parent":{"type":"string","description":"Required. The parent label resource name."},"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.","enum":[true,false]}}}},"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. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or ma","enum":[true,false]}}},"example":{"requests":["value"],"useAdminAccess":""}}}}}},"/v2/labels/{labelsId}/permissions/batchUpdate":{"post":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.permissions/batchUpdate","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/permissions:batchUpdate"},"summary":"Batch update label permissions","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","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. The request message specifying the resources to update.","items":{"type":"object","properties":{"labelPermission":{"type":"object","description":"Required. The permission to create or update on the label."},"parent":{"type":"string","description":"Required. The parent label resource name."},"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.","enum":[true,false]}}}},"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. If this is set, the `use_admin_access` field in the `UpdateLabelPermissionRequest` messages must either be empty or ma","enum":[true,false]}}},"example":{"requests":["value"],"useAdminAccess":""}}}}}},"/v2/labels/{labelsId}/revisions/{revisionsId}/permissions/batchDelete":{"post":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"revisionsId","in":"path","description":"The revisionsId path segment — identifier of the revisionsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.revisions.permissions/batchDelete","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/revisions/{revisionsId}/permissions:batchDelete"},"summary":"Batch delete revision permissions","description":"Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. The request message specifying the resources to update.","items":{"type":"object","properties":{"name":{"type":"string","description":"Required. Label permission resource name."},"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.","enum":[true,false]}}}},"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. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or ma","enum":[true,false]}}},"example":{"requests":["value"],"useAdminAccess":""}}}}}},"/v2/labels/{labelsId}/permissions/batchDelete":{"post":{"tags":["Permissions"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels.permissions/batchDelete","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}/permissions:batchDelete"},"summary":"Batch delete label permissions","description":"Deletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Required. The request message specifying the resources to update.","items":{"type":"object","properties":{"name":{"type":"string","description":"Required. Label permission resource name."},"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.","enum":[true,false]}}}},"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. If this is set, the `use_admin_access` field in the `DeleteLabelPermissionRequest` messages must either be empty or ma","enum":[true,false]}}},"example":{"requests":["value"],"useAdminAccess":""}}}}}},"/v2/users/{usersId}/capabilities":{"get":{"tags":["Capabilities"],"parameters":[{"name":"usersId","in":"path","description":"The usersId path segment — identifier of the usersId resource.","required":true,"schema":{"type":"string","example":""}},{"name":"customer","in":"query","description":"The customer to scope this request to. For example: `customers/abcd1234`. If unset, it will return settings within the current customer.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/users/getCapabilities","api_endpoint":"https://drivelabels.googleapis.com/v2/users/{usersId}/capabilities"},"summary":"Get user capabilities","description":"Gets the user capabilities.","security":[{"bearerAuth":[]}]}},"/v2/limits/label":{"get":{"tags":["Label"],"parameters":[{"name":"name","in":"query","description":"Required. Label revision resource name must be: \"limits/label\".","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/limits/getLabel","api_endpoint":"https://drivelabels.googleapis.com/v2/limits/label"},"summary":"Get user label limits","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.","security":[{"bearerAuth":[]}]}},"/v2/labels/{labelsId}/updateLabelCopyMode":{"post":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/updateLabelCopyMode","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}:updateLabelCopyMode"},"summary":"Update label copy mode","description":"Updates a label's `CopyMode`. Changes to this policy aren't revisioned, don't require publishing, and take effect immediately.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"copyMode":{"type":"string","description":"Required. Indicates how the applied label and field values should be copied when a Drive item is copied.","enum":["COPY_MODE_UNSPECIFIED","DO_NOT_COPY","ALWAYS_COPY","COPY_APPLIABLE"]},"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 will be used."},"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.","enum":[true,false]},"view":{"type":"string","description":"When specified, only certain fields belonging to the indicated view will be returned.","enum":["LABEL_VIEW_BASIC","LABEL_VIEW_FULL"]}}},"example":{"copyMode":"COPY_MODE_UNSPECIFIED","languageCode":"en","useAdminAccess":"","view":"LABEL_VIEW_BASIC"}}}}}},"/v2/labels/{labelsId}/updateLabelEnabledAppSettings":{"post":{"tags":["Labels"],"parameters":[{"name":"labelsId","in":"path","description":"The labelsId path segment — identifier of the labelsId resource.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/workspace/drive/labels/reference/rest/v2/labels/updateLabelEnabledAppSettings","api_endpoint":"https://drivelabels.googleapis.com/v2/labels/{labelsId}:updateLabelEnabledAppSettings"},"summary":"Update label enabled app settings","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.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"enabledAppSettings":{"type":"object","description":"Required. The new `EnabledAppSettings` value for the label.","properties":{"enabledApps":{"type":"array","description":"Optional. The list of apps where the label can be used."}}},"languageCode":{"type":"string","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."},"useAdminAccess":{"type":"boolean","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.","enum":[true,false]},"view":{"type":"string","description":"Optional. When specified, only certain fields belonging to the indicated view will be returned.","enum":["LABEL_VIEW_BASIC","LABEL_VIEW_FULL"]}}},"example":{"enabledAppSettings":{},"languageCode":"en","useAdminAccess":"","view":"LABEL_VIEW_BASIC"}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}