- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Répertorie les modifications apportées à un utilisateur ou à un Drive partagé.
Requête HTTP
GET https://www.googleapis.com/drive/v2/changes
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
Paramètres | |
---|---|
driveId |
Drive partagé à partir duquel les modifications seront renvoyées. Si vous le spécifiez, les ID de modification reflèteront le Drive partagé. Utilisez l'ID de Drive et l'ID de modification combinés comme identifiant. |
includeCorpusRemovals |
Indique si les modifications doivent inclure la ressource de fichier si l'utilisateur y a toujours accès au moment de la requête, même si un fichier a été supprimé de la liste des modifications et qu'il n'y aura plus d'entrées de modification pour ce fichier. |
includeDeleted |
Indique si les modifications indiquant que des éléments ont été supprimés de la liste des modifications doivent être incluses (par exemple, en cas de suppression ou de perte d'accès). |
includeItemsFromAllDrives |
Indique si les éléments de Mon Drive et des Drive partagés doivent être inclus dans les résultats. |
includeSubscribed |
Indique si les modifications en dehors de la hiérarchie Mon Drive doivent être incluses dans les résultats. Si ce paramètre est défini sur "False", les modifications apportées aux fichiers, comme celles du dossier "Application Data" ou des fichiers partagés qui n'ont pas été ajoutés à Mon Drive, ne sont pas incluses dans le résultat. |
includeTeamDriveItems |
Obsolète: utilisez |
maxResults |
Nombre maximal de modifications à renvoyer. |
pageToken |
Jeton permettant de poursuivre une requête de liste précédente sur la page suivante. Cette valeur doit être définie sur la valeur de |
spaces |
Liste des espaces à interroger, séparés par une virgule. Les valeurs acceptées sont |
startChangeId |
Obsolète: utilisez |
supportsAllDrives |
Indique si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés. |
supportsTeamDrives |
Obsolète: utilisez |
teamDriveId |
Obsolète: utilisez |
includePermissionsForView |
Spécifie les autorisations de la vue supplémentaire à inclure dans la réponse. Seule l'option |
includeLabels |
Liste d'ID de libellés séparés par une virgule, à inclure dans la partie |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Liste des modifications apportées à un utilisateur.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Champs | |
---|---|
largestChangeId |
ID de modification le plus élevé actuellement. |
nextPageToken |
Jeton de page pour la page de modifications suivante. Cette valeur n'est pas affichée si vous avez atteint la fin de la liste des modifications. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats. |
kind |
Cette valeur est toujours |
etag |
ETag de la liste. |
newStartPageToken |
Jeton de la page de départ pour les futures modifications. Cette option ne s'affiche que si la fin de la liste des modifications actuelles a été atteinte. |
selfLink |
Lien vers cette liste. |
nextLink |
Lien vers la page suivante des modifications. |
items[] |
Liste des modifications. Si nextPageToken est renseigné, cette liste peut être incomplète et une page de résultats supplémentaire doit être extraite. |
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
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.meet.readonly
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
Certains champs d'application sont soumis à des restrictions et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.