- Solicitação HTTP
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
Lista as alterações de um usuário ou drive compartilhado.
Solicitação HTTP
GET https://www.googleapis.com/drive/v2/changes
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
Parâmetros | |
---|---|
driveId |
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 |
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 |
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 |
Se os itens do Meu Drive e do drive compartilhado devem ser incluídos nos resultados. |
includeSubscribed |
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 |
Obsoleto: use |
maxResults |
Número máximo de mudanças a serem retornadas. |
pageToken |
O token para continuar uma solicitação de lista anterior na próxima página. Precisa ser definido como o valor de |
spaces |
Uma lista de espaços separados por vírgulas para consultar. Os valores aceitos são |
startChangeId |
Obsoleto: use |
supportsAllDrives |
Se o aplicativo que fez a solicitação é compatível com o Meu Drive e os drives compartilhados. |
supportsTeamDrives |
Obsoleto: use |
teamDriveId |
Obsoleto: use |
includePermissionsForView |
Especifica as permissões de visualização extra que vão ser incluídas na resposta. Somente |
includeLabels |
Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte de |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Uma lista das alterações de um usuário.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Campos | |
---|---|
largestChangeId |
O ID de maior mudança atual. |
nextPageToken |
O token da próxima página de mudanças. Esse valor estará ausente se o fim da lista de alterações tiver sido alcançado. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado e a paginação precisará ser reiniciada a partir da primeira página de resultados. |
kind |
É sempre |
etag |
É a ETag da lista. |
newStartPageToken |
O token da página inicial para mudanças futuras. Só estará presente se o fim da lista de alterações atuais tiver sido alcançado. |
selfLink |
Um link para esta lista. |
nextLink |
Um link para a próxima página de alterações. |
items[] |
Lista de alterações. Se a nextPageToken for preenchida, 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/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.