naftiko: 1.0.0-alpha2
info:
  label: Google Drive Labels API — Labels
  description: 'Google Drive Labels API — Labels. 14 operations. Lead operation: Google Retrieve Labels. Self-contained Naftiko
    capability covering one Google business surface.'
  tags:
  - Google
  - Labels
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GOOGLE_API_KEY: GOOGLE_API_KEY
capability:
  consumes:
  - type: http
    namespace: drive-labels-labels
    baseUri: https://drivelabels.googleapis.com
    description: Google Drive Labels API — Labels business capability. Self-contained, no shared references.
    resources:
    - name: v2-labels
      path: /v2/labels
      operations:
      - name: googledrivelabelslabelslist
        method: GET
        description: Google Retrieve Labels
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: customer
          in: query
          type: string
          description: 'The customer to scope this list request to. For example: "customers/abcd1234". If unset, will return
            all labels within the current customer.'
        - name: languageCode
          in: query
          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.
        - name: minimumRole
          in: query
          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`.
        - name: pageSize
          in: query
          type: integer
          description: 'Maximum number of labels to return per page. Default: 50. Max: 200.'
        - name: pageToken
          in: query
          type: string
          description: The token of the page to return.
        - name: publishedOnly
          in: query
          type: boolean
          description: Whether to include only published labels in the results. * When `true`, only the current published
            label revisions are returned. Disabled labels are included. R
        - name: useAdminAccess
          in: query
          type: boolean
          description: Set to `true` in order to use the user's admin credentials. This will return all Labels within the
            customer.
        - name: view
          in: query
          type: string
          description: When specified, only certain fields belonging to the indicated view are returned.
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
      - name: googledrivelabelslabelscreate
        method: POST
        description: Google Create Labels
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: languageCode
          in: query
          type: string
          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.
        - name: useAdminAccess
          in: query
          type: boolean
          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.
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-name
      path: /v2/{name}
      operations:
      - name: googledrivelabelslabelsrevisionspermissionsdelete
        method: DELETE
        description: Google Delete  Name
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: Required. Label Permission resource name.
          required: true
        - name: useAdminAccess
          in: query
          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.
        - name: writeControl.requiredRevisionId
          in: query
          type: string
          description: The revision_id of the label that the write request will be applied to. If this is not the latest revision
            of the label, the request will not be processed and w
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
    - name: v2-name}:delta
      path: /v2/{name}:delta
      operations:
      - name: googledrivelabelslabelsdelta
        method: POST
        description: Google Create Name:delta
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: Required. The resource name of the Label to update.
          required: true
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-name}:disable
      path: /v2/{name}:disable
      operations:
      - name: googledrivelabelslabelsdisable
        method: POST
        description: Google Create Name:disable
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: Required. Label resource name.
          required: true
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-name}:enable
      path: /v2/{name}:enable
      operations:
      - name: googledrivelabelslabelsenable
        method: POST
        description: Google Create Name:enable
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: Required. Label resource name.
          required: true
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-name}:publish
      path: /v2/{name}:publish
      operations:
      - name: googledrivelabelslabelspublish
        method: POST
        description: Google Create Name:publish
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: Required. Label resource name.
          required: true
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-name}:updateLabelCopyMode
      path: /v2/{name}:updateLabelCopyMode
      operations:
      - name: googledrivelabelslabelsupdatelabelcopymode
        method: POST
        description: Google Create Name:updatelabelcopymode
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: name
          in: path
          type: string
          description: Required. The resource name of the Label to update.
          required: true
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-parent-locks
      path: /v2/{parent}/locks
      operations:
      - name: googledrivelabelslabelsrevisionslockslist
        method: GET
        description: Google Retrieve Parent Locks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          description: 'Required. Label on which Locks are applied. Format: labels/{label}'
          required: true
        - name: pageSize
          in: query
          type: integer
          description: 'Maximum number of Locks to return per page. Default: 100. Max: 200.'
        - name: pageToken
          in: query
          type: string
          description: The token of the page to return.
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
    - name: v2-parent-permissions
      path: /v2/{parent}/permissions
      operations:
      - name: googledrivelabelslabelsrevisionspermissionslist
        method: GET
        description: Google Retrieve Parent Permissions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          description: 'Required. The parent Label resource name on which Label Permission are listed. Format: labels/{label}'
          required: true
        - name: pageSize
          in: query
          type: integer
          description: 'Maximum number of permissions to return per page. Default: 50. Max: 200.'
        - name: pageToken
          in: query
          type: string
          description: The token of the page to return.
        - name: useAdminAccess
          in: query
          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.
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
      - name: googledrivelabelslabelsrevisionspermissionscreate
        method: POST
        description: Google Create Parent Permissions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          description: 'Required. The parent Label resource name on the Label Permission is created. Format: labels/{label}'
          required: true
        - name: useAdminAccess
          in: query
          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.
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: googledrivelabelslabelsrevisionsupdatepermissions
        method: PATCH
        description: Google Patch  Parent Permissions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          description: Required. The parent Label resource name.
          required: true
        - name: useAdminAccess
          in: query
          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.
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-parent-permissions:batchDelete
      path: /v2/{parent}/permissions:batchDelete
      operations:
      - name: googledrivelabelslabelsrevisionspermissionsbatchdelete
        method: POST
        description: Google Create Parent Permissions:batchdelete
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          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 UpdateLabelPerm'
          required: true
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v2-parent-permissions:batchUpdate
      path: /v2/{parent}/permissions:batchUpdate
      operations:
      - name: googledrivelabelslabelsrevisionspermissionsbatchupdate
        method: POST
        description: Google Create Parent Permissions:batchupdate
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: parent
          in: path
          type: string
          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 UpdateLabelPerm'
          required: true
        - name: $.xgafv
          in: query
          type: string
          description: V1 error format.
        - name: access_token
          in: query
          type: string
          description: OAuth access token.
        - name: alt
          in: query
          type: string
          description: Data format for response.
        - name: callback
          in: query
          type: string
          description: JSONP
        - name: fields
          in: query
          type: string
          description: Selector specifying which fields to include in a partial response.
        - name: key
          in: query
          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.
        - name: oauth_token
          in: query
          type: string
          description: OAuth 2.0 token for the current user.
        - name: prettyPrint
          in: query
          type: boolean
          description: Returns response with indentations and line breaks.
        - name: quotaUser
          in: query
          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.
        - name: upload_protocol
          in: query
          type: string
          description: Upload protocol for media (e.g. "raw", "multipart").
        - name: uploadType
          in: query
          type: string
          description: Legacy upload protocol for media (e.g. "media", "multipart").
        - name: Authorization
          in: header
          type: string
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      token: '{{env.GOOGLE_API_KEY}}'
  exposes:
  - type: rest
    namespace: drive-labels-labels-rest
    port: 8080
    description: REST adapter for Google Drive Labels API — Labels. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v2/labels
      name: v2-labels
      description: REST surface for v2-labels.
      operations:
      - method: GET
        name: googledrivelabelslabelslist
        description: Google Retrieve Labels
        call: drive-labels-labels.googledrivelabelslabelslist
        with:
          customer: rest.customer
          languageCode: rest.languageCode
          minimumRole: rest.minimumRole
          pageSize: rest.pageSize
          pageToken: rest.pageToken
          publishedOnly: rest.publishedOnly
          useAdminAccess: rest.useAdminAccess
          view: rest.view
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: googledrivelabelslabelscreate
        description: Google Create Labels
        call: drive-labels-labels.googledrivelabelslabelscreate
        with:
          languageCode: rest.languageCode
          useAdminAccess: rest.useAdminAccess
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/{name}
      name: v2-name
      description: REST surface for v2-name.
      operations:
      - method: DELETE
        name: googledrivelabelslabelsrevisionspermissionsdelete
        description: Google Delete  Name
        call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionsdelete
        with:
          name: rest.name
          useAdminAccess: rest.useAdminAccess
          writeControl.requiredRevisionId: rest.writeControl.requiredRevisionId
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/name-delta
      name: v2-name-delta
      description: REST surface for v2-name}:delta.
      operations:
      - method: POST
        name: googledrivelabelslabelsdelta
        description: Google Create Name:delta
        call: drive-labels-labels.googledrivelabelslabelsdelta
        with:
          name: rest.name
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/name-disable
      name: v2-name-disable
      description: REST surface for v2-name}:disable.
      operations:
      - method: POST
        name: googledrivelabelslabelsdisable
        description: Google Create Name:disable
        call: drive-labels-labels.googledrivelabelslabelsdisable
        with:
          name: rest.name
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/name-enable
      name: v2-name-enable
      description: REST surface for v2-name}:enable.
      operations:
      - method: POST
        name: googledrivelabelslabelsenable
        description: Google Create Name:enable
        call: drive-labels-labels.googledrivelabelslabelsenable
        with:
          name: rest.name
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/name-publish
      name: v2-name-publish
      description: REST surface for v2-name}:publish.
      operations:
      - method: POST
        name: googledrivelabelslabelspublish
        description: Google Create Name:publish
        call: drive-labels-labels.googledrivelabelslabelspublish
        with:
          name: rest.name
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/name-updatelabelcopymode
      name: v2-name-updatelabelcopymode
      description: REST surface for v2-name}:updateLabelCopyMode.
      operations:
      - method: POST
        name: googledrivelabelslabelsupdatelabelcopymode
        description: Google Create Name:updatelabelcopymode
        call: drive-labels-labels.googledrivelabelslabelsupdatelabelcopymode
        with:
          name: rest.name
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/{parent}/locks
      name: v2-parent-locks
      description: REST surface for v2-parent-locks.
      operations:
      - method: GET
        name: googledrivelabelslabelsrevisionslockslist
        description: Google Retrieve Parent Locks
        call: drive-labels-labels.googledrivelabelslabelsrevisionslockslist
        with:
          parent: rest.parent
          pageSize: rest.pageSize
          pageToken: rest.pageToken
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/{parent}/permissions
      name: v2-parent-permissions
      description: REST surface for v2-parent-permissions.
      operations:
      - method: GET
        name: googledrivelabelslabelsrevisionspermissionslist
        description: Google Retrieve Parent Permissions
        call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionslist
        with:
          parent: rest.parent
          pageSize: rest.pageSize
          pageToken: rest.pageToken
          useAdminAccess: rest.useAdminAccess
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: googledrivelabelslabelsrevisionspermissionscreate
        description: Google Create Parent Permissions
        call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionscreate
        with:
          parent: rest.parent
          useAdminAccess: rest.useAdminAccess
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: googledrivelabelslabelsrevisionsupdatepermissions
        description: Google Patch  Parent Permissions
        call: drive-labels-labels.googledrivelabelslabelsrevisionsupdatepermissions
        with:
          parent: rest.parent
          useAdminAccess: rest.useAdminAccess
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/{parent}/permissions-batchdelete
      name: v2-parent-permissions-batchdelete
      description: REST surface for v2-parent-permissions:batchDelete.
      operations:
      - method: POST
        name: googledrivelabelslabelsrevisionspermissionsbatchdelete
        description: Google Create Parent Permissions:batchdelete
        call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionsbatchdelete
        with:
          parent: rest.parent
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/{parent}/permissions-batchupdate
      name: v2-parent-permissions-batchupdate
      description: REST surface for v2-parent-permissions:batchUpdate.
      operations:
      - method: POST
        name: googledrivelabelslabelsrevisionspermissionsbatchupdate
        description: Google Create Parent Permissions:batchupdate
        call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionsbatchupdate
        with:
          parent: rest.parent
          $.xgafv: rest.$.xgafv
          access_token: rest.access_token
          alt: rest.alt
          callback: rest.callback
          fields: rest.fields
          key: rest.key
          oauth_token: rest.oauth_token
          prettyPrint: rest.prettyPrint
          quotaUser: rest.quotaUser
          upload_protocol: rest.upload_protocol
          uploadType: rest.uploadType
          Authorization: rest.Authorization
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: drive-labels-labels-mcp
    port: 9090
    transport: http
    description: MCP adapter for Google Drive Labels API — Labels. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: google-retrieve-labels
      description: Google Retrieve Labels
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: drive-labels-labels.googledrivelabelslabelslist
      with:
        customer: tools.customer
        languageCode: tools.languageCode
        minimumRole: tools.minimumRole
        pageSize: tools.pageSize
        pageToken: tools.pageToken
        publishedOnly: tools.publishedOnly
        useAdminAccess: tools.useAdminAccess
        view: tools.view
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-labels
      description: Google Create Labels
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelscreate
      with:
        languageCode: tools.languageCode
        useAdminAccess: tools.useAdminAccess
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-delete-name
      description: Google Delete  Name
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionsdelete
      with:
        name: tools.name
        useAdminAccess: tools.useAdminAccess
        writeControl.requiredRevisionId: tools.writeControl.requiredRevisionId
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-name-delta
      description: Google Create Name:delta
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelsdelta
      with:
        name: tools.name
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-name-disable
      description: Google Create Name:disable
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelsdisable
      with:
        name: tools.name
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-name-enable
      description: Google Create Name:enable
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelsenable
      with:
        name: tools.name
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-name-publish
      description: Google Create Name:publish
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelspublish
      with:
        name: tools.name
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-name-updatelabelcopymode
      description: Google Create Name:updatelabelcopymode
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelsupdatelabelcopymode
      with:
        name: tools.name
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-retrieve-parent-locks
      description: Google Retrieve Parent Locks
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: drive-labels-labels.googledrivelabelslabelsrevisionslockslist
      with:
        parent: tools.parent
        pageSize: tools.pageSize
        pageToken: tools.pageToken
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: google-retrieve-parent-permissions
      description: Google Retrieve Parent Permissions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionslist
      with:
        parent: tools.parent
        pageSize: tools.pageSize
        pageToken: tools.pageToken
        useAdminAccess: tools.useAdminAccess
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-parent-permissions
      description: Google Create Parent Permissions
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionscreate
      with:
        parent: tools.parent
        useAdminAccess: tools.useAdminAccess
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-patch-parent-permissions
      description: Google Patch  Parent Permissions
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: drive-labels-labels.googledrivelabelslabelsrevisionsupdatepermissions
      with:
        parent: tools.parent
        useAdminAccess: tools.useAdminAccess
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-parent-permissions-batchdelete
      description: Google Create Parent Permissions:batchdelete
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionsbatchdelete
      with:
        parent: tools.parent
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: google-create-parent-permissions-batchupdate
      description: Google Create Parent Permissions:batchupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: drive-labels-labels.googledrivelabelslabelsrevisionspermissionsbatchupdate
      with:
        parent: tools.parent
        $.xgafv: tools.$.xgafv
        access_token: tools.access_token
        alt: tools.alt
        callback: tools.callback
        fields: tools.fields
        key: tools.key
        oauth_token: tools.oauth_token
        prettyPrint: tools.prettyPrint
        quotaUser: tools.quotaUser
        upload_protocol: tools.upload_protocol
        uploadType: tools.uploadType
        Authorization: tools.Authorization
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.