- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Enumera los cambios para un usuario o una unidad compartida.
Solicitud HTTP
GET https://www.googleapis.com/drive/v2/changes
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
driveId |
La unidad compartida desde la que se mostrarán los cambios. Si se especifica, los IDs de cambio reflejarán la unidad compartida. Usa el ID de unidad combinada y el ID de cambio como identificador. |
includeCorpusRemovals |
Indica si los cambios deben incluir el recurso de archivo en caso de que el usuario aún pueda acceder al archivo en el momento de la solicitud, incluso si se quitó un archivo de la lista de cambios y no habrá más entradas de cambios para este archivo. |
includeDeleted |
Indica si se deben incluir cambios que indiquen que los elementos se eliminaron de la lista de cambios, por ejemplo, debido a la eliminación o la pérdida de acceso. |
includeItemsFromAllDrives |
Indica si se deben incluir tanto los elementos de Mi unidad como los de la unidad compartida en los resultados. |
includeSubscribed |
Indica si se deben incluir en el resultado los cambios fuera de la jerarquía de Mi unidad. Si la estableces como falsa, se omitirán del resultado los cambios realizados en archivos, como los que se encuentran en la carpeta Datos de la aplicación o en los archivos compartidos que no se hayan agregado a Mi unidad. |
includeTeamDriveItems |
Obsoleto: usa |
maxResults |
Cantidad máxima de cambios que se mostrarán. |
pageToken |
El token para continuar una solicitud de lista anterior en la página siguiente. Se debe establecer en el valor de |
spaces |
Una lista de espacios separados por comas para consultar. Los valores admitidos son |
startChangeId |
Obsoleto: usa |
supportsAllDrives |
Indica si la aplicación solicitante admite Mi unidad y las unidades compartidas. |
supportsTeamDrives |
Obsoleto: usa |
teamDriveId |
Obsoleto: usa |
includePermissionsForView |
Especifica qué permisos de vistas adicionales se deben incluir en la respuesta. Solo se admite |
includeLabels |
Una lista separada por comas de los IDs de las etiquetas que se incluirán en la parte |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Una lista de cambios para un usuario.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Campos | |
---|---|
largestChangeId |
El ID de cambio más grande actual. |
nextPageToken |
El token de la página de la siguiente página de cambios. Estará ausente si se llega al final de la lista de cambios. Si por algún motivo se rechaza el token, se debe descartar y se debe reiniciar la paginación desde la primera página de resultados. |
kind |
Siempre es |
etag |
La ETag de la lista |
newStartPageToken |
El token de la página de inicio para cambios futuros. Esta aparecerá solo si se llegó al final de la lista de cambios actual. |
selfLink |
Vínculo a esta lista. |
nextLink |
Un vínculo a la siguiente página de cambios. |
items[] |
La lista de cambios. Si se propaga nextPageToken, es posible que esta lista esté incompleta y se deba recuperar una página adicional de resultados. |
Permisos de autorización
Se necesita uno de los siguientes alcances 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
Algunos permisos están restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la guía de autorización.