Google Drive Channels API

openapi: 3.2.0
info:
  title: Google Drive Channels API
  description: The Google Drive API allows clients to access resources from Google Drive.
  version: v3
  contact:
    name: Google
    url: https://developers.google.com/workspace/drive/
  termsOfService: https://developers.google.com/terms
  x-generated-from: google-discovery
  x-source: https://www.googleapis.com/discovery/v1/apis/drive/v3/rest
  x-discovery-revision: '20261102'
  x-generated: '2026-11-04'
servers:
- url: https://www.googleapis.com/drive/v3
  description: Google Drive REST API v3
security:
- oauth2: []
tags:
- name: Channels
paths:
  /channels/stop:
    post:
      operationId: stopChannels
      summary: Stops watching resources through this channel
      description: Stops watching resources through this channel. For more information, see Notifications for resource changes.
      tags:
      - Channels
      x-discovery-id: drive.channels.stop
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Channel'
      responses:
        '200':
          description: Successful response
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - oauth2:
        - https://www.googleapis.com/auth/drive
        - https://www.googleapis.com/auth/drive.appdata
        - https://www.googleapis.com/auth/drive.file
        - https://www.googleapis.com/auth/drive.meet.readonly
        - https://www.googleapis.com/auth/drive.metadata
        - https://www.googleapis.com/auth/drive.metadata.readonly
        - https://www.googleapis.com/auth/drive.photos.readonly
        - https://www.googleapis.com/auth/drive.readonly
components:
  schemas:
    ErrorResponse:
      type: object
      description: Google API error envelope (https://cloud.google.com/apis/design/errors)
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            errors:
              type: array
              items:
                type: object
                properties:
                  domain:
                    type: string
                  reason:
                    type: string
                  message:
                    type: string
                  location:
                    type: string
                  locationType:
                    type: string
    Channel:
      type: object
      description: A notification channel used to watch for resource changes.
      properties:
        token:
          type: string
          description: An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
        id:
          type: string
          description: A UUID or similar unique string that identifies this channel.
        params:
          type: object
          description: Additional parameters controlling delivery channel behavior. Optional.
          additionalProperties:
            type: string
        address:
          type: string
          description: The address where notifications are delivered for this channel.
        payload:
          type: boolean
          description: A Boolean value to indicate whether payload is wanted. Optional.
        type:
          type: string
          description: The type of delivery mechanism used for this channel. Valid values are "web_hook" or "webhook".
        resourceUri:
          type: string
          description: A version-specific identifier for the watched resource.
        resourceId:
          type: string
          description: An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.
        kind:
          type: string
          description: Identifies this as a notification channel used to watch for changes to a resource, which is `api#channel`.
          default: api#channel
        expiration:
          type: string
          description: Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional.
          format: int64
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/drive.scripts: Modify your Google Apps Script scripts' behavior
            https://www.googleapis.com/auth/drive.meet.readonly: See and download your Google Drive files that were created or edited by Google Meet.
            https://www.googleapis.com/auth/drive: See, edit, create, and delete all of your Google Drive files
            https://www.googleapis.com/auth/drive.appdata: See, create, and delete its own configuration data in your Google Drive
            https://www.googleapis.com/auth/drive.file: See, edit, create, and delete only the specific Google Drive files you use with this app
            https://www.googleapis.com/auth/drive.apps.readonly: View your Google Drive apps
            https://www.googleapis.com/auth/drive.photos.readonly: View the photos, videos and albums in your Google Photos
            https://www.googleapis.com/auth/drive.readonly: See and download all your Google Drive files
            https://www.googleapis.com/auth/drive.metadata: View and manage metadata of files in your Google Drive
            https://www.googleapis.com/auth/drive.metadata.readonly: See information about your Google Drive files