Method: changes.watch

Inscrever-se nas alterações de um usuário.

Solicitação HTTP

POST https://www.googleapis.com/drive/v2/changes/watch

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
driveId

string

O drive compartilhado que vai mostrar as alterações. Se especificados, os IDs de mudança vão refletir o drive compartilhado. Use o ID combinado do drive e o ID da mudança como um identificador.

includeCorpusRemovals

boolean

Define se as alterações devem incluir o recurso de arquivo se ele ainda estiver acessível ao usuário no momento da solicitação, mesmo quando um arquivo tiver sido removido da lista de mudanças e não houver mais entradas de alteração para esse arquivo.

includeDeleted

boolean

Se quer incluir mudanças indicando que itens foram removidos da lista de alterações, por exemplo, por exclusão ou perda de acesso.

includeItemsFromAllDrives

boolean

Se os itens do Meu Drive e do drive compartilhado devem ser incluídos nos resultados.

includeSubscribed

boolean

Define se mudanças fora da hierarquia do Meu Drive serão incluídas no resultado. Quando ela é definida como falsa, as alterações em arquivos como os que estão na pasta "Dados do aplicativo" ou em arquivos compartilhados que não foram adicionados ao Meu Drive são omitidas do resultado.

includeTeamDriveItems
(deprecated)

boolean

Obsoleto: use includeItemsFromAllDrives.

maxResults

integer

Número máximo de mudanças a serem retornadas.

pageToken

string

O token para continuar uma solicitação de lista anterior na próxima página. Precisa ser definido como o valor de nextPageToken da resposta anterior ou da resposta do método getStartPageToken.

spaces

string

Uma lista de espaços separados por vírgulas para consultar. Os valores aceitos são drive, appDataFolder e photos.

startChangeId
(deprecated)

string (int64 format)

Obsoleto: use pageToken.

supportsAllDrives

boolean

Se o aplicativo que fez a solicitação é compatível com o Meu Drive e os drives compartilhados.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: use supportsAllDrives.

teamDriveId
(deprecated)

string

Obsoleto: use driveId.

includePermissionsForView

string

Especifica as permissões de visualização extra que vão ser incluídas na resposta. Somente published é aceito.

includeLabels

string

Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte de labelInfo da resposta.

Corpo da solicitação

O corpo da solicitação contém uma instância de Channel.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Channel.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • 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

Alguns escopos são restritos e exigem uma avaliação de segurança para que sejam usados pelo app. Para mais informações, consulte o Guia de autorização.