Para apps do Google Drive que precisam rastrear mudanças nos arquivos, a coleção changes
oferece uma maneira eficiente de detectar todas as mudanças nos arquivos, incluindo aquelas compartilhadas com um usuário. Se o arquivo
for alterado, a coleção fornecerá o estado atual de cada arquivo.
Receber token da página inicial
Para solicitar o token de página para o estado atual da conta, use o
changes.getStartPageToken
.
Armazene e use esse token na chamada inicial para
changes.list
.
Para recuperar o token da página atual:
Java
Python
PHP
.NET
Node.js
Obter alterações
Para recuperar a lista de mudanças do usuário conectado, envie uma solicitação GET
para a coleção changes
, conforme detalhado em
changes.list
.
As entradas na coleção changes
estão em ordem cronológica (as alterações mais antigas aparecem primeiro). Os parâmetros de consulta includeRemoved
e restrictToMyDrive
determinam se a resposta precisa incluir itens removidos ou compartilhados.
Java
Python
PHP
.NET
Node.js
A coleção changes
na resposta pode conter um nextPageToken
. Se o nextPageToken
estiver listado, ele poderá ser usado para reunir a próxima página de mudanças. Se ele não estiver listado, o aplicativo cliente precisará armazenar
a newStartPageToken
na resposta para uso futuro. Com o token da página armazenado, o aplicativo cliente está preparado para consultar novamente as mudanças futuras.
Receber notificações
Use o método changes.watch
para
se inscrever nas atualizações no registro de alterações. As notificações não têm detalhes
sobre as mudanças. Em vez disso, eles indicam que novas mudanças estão disponíveis. Para recuperar as mudanças reais, pesquise o feed de alterações conforme descrito em Receber alterações.
Para mais informações, consulte Notificações de alterações de recursos.