Method: changes.list

Lista as alterações de um usuário ou drive compartilhado.

Solicitação HTTP

GET https://www.googleapis.com/drive/v3/changes

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

Parâmetros de consulta

Parâmetros
driveId

string

O drive compartilhado do qual as alterações serão retornadas. Se especificado, os códigos de alteração refletirão o drive compartilhado. Use o código do drive combinado e o código de alteração como um identificador.
includeCorpusRemovals

boolean

Se as alterações devem incluir o recurso de arquivo se o arquivo ainda estiver acessível pelo usuário no momento da solicitação, mesmo quando um arquivo foi removido da lista de alterações e não haverá mais entradas de alteração para esse arquivo.
includeItemsFromAllDrives

boolean

Indica se os itens em "Meu Drive" e nos drives compartilhados devem ser incluídos nos resultados.
includeRemoved

boolean

Se é necessário incluir alterações indicando que os itens foram removidos da lista de alterações, por exemplo, por exclusão ou perda de acesso.
includeTeamDriveItems
(deprecated)

boolean

Obsoleto: use includeItemsFromAllDrives.
pageSize

integer

O número máximo de alterações a serem retornadas por página.
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 do método getStartPageToken.
restrictToMyDrive

boolean

Se os resultados serão restritos a mudanças na hierarquia de "Meu Drive". Isso omite as alterações a arquivos como os da pasta "Application Data" ou dos arquivos compartilhados que não foram adicionados a "Meu Drive".
spaces

string

Uma lista separada por vírgulas de espaços para consulta em corpora. Os valores aceitos são "drive" e "appDataFolder".
supportsAllDrives

boolean

Se o aplicativo solicitante é compatível com "Meu Drive" e drives compartilhados.
supportsTeamDrives
(deprecated)

boolean

Obsoleto: use supportsAllDrives.
teamDriveId
(deprecated)

string

Obsoleto: use driveId.
includePermissionsForView

string

Especifica quais permissões da visualização adicional devem ser incluídas na resposta. Somente "publicado" é suportado.
includeLabels

string

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

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de alterações para um usuário.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string,
  "changes": [
    {
      object (Change)
    }
  ]
}
Campos
kind

string

Identifica o tipo de recurso. Valor: a string fixa "drive#changeList".
nextPageToken

string

O token de página para a próxima página de alterações. Ela estará ausente se o final da lista de alterações for atingido. O token da página não expira.
newStartPageToken

string

O token da página inicial para alterações futuras. Ela estará presente apenas se o final da lista de alterações atuais tiver sido alcançado. O token da página não expira.
changes[]

object (Change)

A lista de alterações. Se nextPageToken for preenchido, essa lista poderá estar incompleta, e uma página adicional de resultados deverá ser buscada.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • 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.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 serem usados pelo app. Para mais informações, consulte o Guia de autorização.