Zawiera listę zmian dotyczących użytkownika lub dysku współdzielonego.
Żądanie HTTP
GET https://www.googleapis.com/drive/v2/changes
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
driveId |
Dysk współdzielony, z którego będą zwracane zmiany. Jeśli określisz identyfikatory zmian, będą one odzwierciedlać dane dla dysku współdzielonego. Użyj identyfikatora połączonego dysku i zmień identyfikator jako identyfikatora. |
includeCorpusRemovals |
Określa, czy zmiany powinny obejmować zasób, jeśli użytkownik nadal ma do niego dostęp w momencie żądania, nawet jeśli plik został usunięty z listy zmian i nie będzie już w nim uwzględnione żadne dalsze wpisy o zmianach. |
includeDeleted |
Określa, czy uwzględnić zmiany wskazujące, że elementy zostały usunięte z listy zmian (np. przez usunięcie lub utratę dostępu). |
includeItemsFromAllDrives |
Określa, czy w wynikach mają być uwzględnione zarówno elementy z Mojego dysku, jak i dysku współdzielonego. |
includeSubscribed |
Określa, czy w wyniku mają być uwzględnione zmiany spoza hierarchii Mojego dysku. Jeśli zasada ma wartość Fałsz, zmiany w plikach, takich jak te w folderze Dane aplikacji, oraz w udostępnionych plikach, które nie zostały dodane do Mojego dysku, są pomijane w wynikach wyszukiwania. |
includeTeamDriveItems |
Wycofane: zamiast tego użyj elementu |
maxResults |
Maksymalna liczba zmian do zwrócenia. |
pageToken |
Token kontynuacji poprzedniego żądania listy na następnej stronie. Należy ustawić wartość |
spaces |
Rozdzielona przecinkami lista spacji, których dotyczy zapytanie. Obsługiwane wartości to |
startChangeId |
Wycofane: zamiast tego użyj elementu |
supportsAllDrives |
Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: zamiast tego użyj elementu |
teamDriveId |
Wycofane: zamiast tego użyj elementu |
includePermissionsForView |
Określa, które dodatkowe uprawnienia do widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość |
includeLabels |
Rozdzielona przecinkami lista identyfikatorów etykiet do uwzględnienia w części |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Lista zmian użytkownika.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Pola | |
---|---|
largestChangeId |
Identyfikator największej bieżącej zmiany. |
nextPageToken |
Token strony następnej strony zmian. Będzie ona niedostępna po osiągnięciu końca listy zmian. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go odrzucić i uruchomić ponownie podział na strony na pierwszej stronie wyników. |
kind |
Jest to zawsze |
etag |
Wartość ETag listy. |
newStartPageToken |
Token strony początkowej na potrzeby przyszłych zmian. Będzie widoczna tylko po osiągnięciu końca bieżącej listy zmian. |
selfLink |
Link do tej listy. |
nextLink |
Link do następnej strony ze zmianami. |
items[] |
Lista zmian. Jeśli wartość NextPageToken jest wypełniona, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów 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
Niektóre zakresy są objęte ograniczeniami, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.