- 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/v3/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. |
includeItemsFromAllDrives |
Se os itens do Meu Drive e do drive compartilhado devem ser incluídos nos resultados. |
includeRemoved |
Se quer incluir mudanças indicando que itens foram removidos da lista de alterações, por exemplo, por exclusão ou perda de acesso. |
includeTeamDriveItems |
Obsoleto: use |
pageSize |
O número máximo de alterações a serem retornadas por página. |
pageToken |
O token para continuar uma solicitação de lista anterior na próxima página. Deve ser definido como o valor de "nextPageToken" da resposta anterior ou para a resposta do método getStartPageToken. |
restrictToMyDrive |
Define se os resultados serão restringidos às mudanças na hierarquia do Meu Drive. Isso omite alterações em arquivos, como aqueles na pasta "Dados do aplicativo", ou em arquivos compartilhados que não foram adicionados ao Meu Drive. |
spaces |
Uma lista separada por vírgulas de espaços para consulta em corpora. Os valores aceitos são "drive" e "appDataFolder". |
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 "Publicado" é compatível. |
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 |
---|
{
"kind": string,
"nextPageToken": string,
"newStartPageToken": string,
"changes": [
{
object ( |
Campos | |
---|---|
kind |
Identifica o tipo de recurso. Valor: a string fixa |
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. O token da página não expira. |
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. O token da página não expira. |
changes[] |
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/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 que sejam usados pelo app. Para mais informações, consulte o Guia de autorização.