Subskrybuje zmiany dla użytkownika. Więcej informacji znajdziesz w artykule Powiadomienia o zmianach zasobów.
Żądanie HTTP
POST https://www.googleapis.com/drive/v3/changes/watch
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry | |
|---|---|
driveId |
Dysk współdzielony, z którego zostaną zwrócone zmiany. Jeśli są określone, identyfikatory zmian będą odzwierciedlać dysk współdzielony. Jako identyfikator użyj połączonego identyfikatora dysku i identyfikatora zmiany. |
includeCorpusRemovals |
Określa, czy zmiany powinny obejmować zasób pliku, jeśli jest on nadal dostępny dla użytkownika w momencie wysłania żądania, nawet jeśli został usunięty z listy zmian i nie będzie już żadnych kolejnych wpisów zmian dotyczących tego pliku. |
includeItemsFromAllDrives |
Czy w wynikach mają być uwzględniane elementy z Mojego dysku i dysków współdzielonych. |
includeRemoved |
Czy uwzględnić zmiany wskazujące, że elementy zostały usunięte z listy zmian, na przykład przez usunięcie lub utratę dostępu. |
includeTeamDriveItems |
Wycofane: użyj w zastępstwie tego |
pageSize |
Maksymalna liczba zmian zwracanych na stronę. |
pageToken |
Token do kontynuowania poprzedniego żądania listy na następnej stronie. Wartość tego parametru powinna być taka sama jak wartość parametru „nextPageToken” z poprzedniej odpowiedzi lub z odpowiedzi z metody getStartPageToken. |
restrictToMyDrive |
Określa, czy wyniki mają być ograniczone do zmian w hierarchii Mojego dysku. Oznacza to, że nie będą uwzględniane zmiany w plikach, takich jak pliki w folderze Application Data czy pliki udostępnione, które nie zostały dodane do Mojego dysku. |
spaces |
Lista rozdzielana przecinkami przestrzeni, których dotyczy zapytanie w korpusach. Obsługiwane wartości to „drive” i „appDataFolder”. |
supportsAllDrives |
Czy aplikacja przesyłająca żądanie obsługuje zarówno Mój Dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: użyj w zastępstwie tego |
teamDriveId |
Wycofane: użyj w zastępstwie tego |
includePermissionsForView |
Określa, które uprawnienia dodatkowego widoku należy uwzględnić w odpowiedzi. Obsługiwana jest tylko opcja „opublikowano”. |
includeLabels |
Lista identyfikatorów etykiet rozdzielona przecinkami, które mają być uwzględnione w sekcji |
Treść żądania
Treść żądania zawiera wystąpienie elementu Channel.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Channel.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.meet.readonlyhttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.metadata.readonlyhttps://www.googleapis.com/auth/drive.photos.readonlyhttps://www.googleapis.com/auth/drive.readonly
Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.