Hier sehen Sie die Änderungen für einen Nutzer oder eine geteilte Ablage.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v2/changes
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
driveId |
Die geteilte Ablage, aus der Änderungen zurückgegeben werden. Wenn angegeben, beziehen sich die Änderungs-IDs auf die geteilte Ablage. Verwenden Sie die kombinierte Laufwerk-ID und die Änderungs-ID als Kennung. |
includeCorpusRemovals |
Gibt an, ob Änderungen die Dateiressource enthalten sollen, wenn der Nutzer zum Zeitpunkt der Anfrage noch auf die Datei zugreifen kann, auch wenn eine Datei aus der Liste der Änderungen entfernt wurde und es keine weiteren Änderungseinträge für diese Datei gibt. |
includeDeleted |
Gibt an, ob Änderungen einbezogen werden sollen, die darauf hinweisen, dass Elemente aus der Liste der Änderungen entfernt wurden, z. B. durch Löschen oder Verlust des Zugriffs. |
includeItemsFromAllDrives |
Legt fest, ob sowohl Elemente aus „Meine Ablage“ als auch Elemente aus geteilten Ablagen in den Ergebnissen enthalten sein sollen. |
includeSubscribed |
Gibt an, ob Änderungen außerhalb der Hierarchie „Meine Ablage“ in das Ergebnis einbezogen werden sollen. Wenn die Richtlinie auf „false“ gesetzt ist, werden Änderungen an Dateien, z. B. im Ordner „Anwendungsdaten“, oder an freigegebenen Dateien, die nicht zu „Meine Ablage“ hinzugefügt wurden, nicht in das Ergebnis übernommen. |
includeTeamDriveItems |
Eingestellt: Verwende stattdessen |
maxResults |
Maximale Anzahl der Änderungen, die zurückgegeben werden sollen. |
pageToken |
Das Token zum Fortsetzen einer vorherigen Listenanfrage auf der nächsten Seite. Dieses sollte auf den Wert von |
spaces |
Eine durch Kommas getrennte Liste mit Leerzeichen, die abgefragt werden sollen. Unterstützte Werte sind |
startChangeId |
Eingestellt: Verwende stattdessen |
supportsAllDrives |
Gibt an, ob die Anwendung, die die Anfrage stellt, sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. |
supportsTeamDrives |
Eingestellt: Verwende stattdessen |
teamDriveId |
Eingestellt: Verwende stattdessen |
includePermissionsForView |
Gibt an, welche zusätzlichen Ansichtsberechtigungen in der Antwort enthalten sein sollen. Nur |
includeLabels |
Eine durch Kommas getrennte Liste mit IDs von Labels, die in den |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der Änderungen eines Nutzers.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Felder | |
---|---|
largestChangeId |
Die aktuelle ID der größten Änderung. |
nextPageToken |
Das Seitentoken für die nächste Seite mit Änderungen. Dieses Element fehlt, wenn das Ende der Änderungsliste erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung von der ersten Ergebnisseite aus neu gestartet werden. |
kind |
Dies ist immer |
etag |
Das ETag der Liste. |
newStartPageToken |
Das Startseitentoken für zukünftige Änderungen. Dieses Feld ist nur vorhanden, wenn das Ende der Liste mit den aktuellen Änderungen erreicht wurde. |
selfLink |
Ein Link zurück zu dieser Liste. |
nextLink |
Ein Link zur nächsten Seite mit Änderungen. |
items[] |
Die Liste der Änderungen. Wenn „nextPageToken“ ausgefüllt ist, ist diese Liste möglicherweise unvollständig und es sollte eine zusätzliche Ergebnisseite abgerufen werden. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.