Method: changes.watch

Subskrybuje zmiany dotyczące 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

string

Dysk współdzielony, z którego będą zwracane zmiany. Jeśli ten parametr jest określony, identyfikatory zmian będą odzwierciedlać dysk współdzielony. Użyj połączonego identyfikatora dysku i identyfikatora zmiany jako identyfikatora.
includeCorpusRemovals

boolean

Czy zmiany powinny obejmować zasób pliku, jeśli plik jest nadal dostępny dla użytkownika w momencie wysyłania żądania, nawet jeśli plik został usunięty z listy zmian i nie będzie już żadnych wpisów zmian dotyczących tego pliku.
includeItemsFromAllDrives

boolean

Czy w wynikach mają być uwzględniane elementy z Mojego dysku i dysków współdzielonych.
includeRemoved

boolean

Czy uwzględniać zmiany wskazujące, że elementy zostały usunięte z listy zmian, np. przez usunięcie lub utratę dostępu.
includeTeamDriveItems
(deprecated)

boolean

Wycofane: zamiast tego użyj parametru includeItemsFromAllDrives.
pageSize

integer

Maksymalna liczba zmian do zwrócenia. Usługa może zwrócić mniej zmian niż ta wartość.

Jeśli nie podasz tej wartości, usługa zwróci maksymalnie 100 zmian.

Maksymalna wartość to 1000. Wartości powyżej 1000 zostaną zmienione na 1000.
pageToken

string

Token umożliwiający kontynuowanie poprzedniego żądania listy na następnej stronie. Należy ustawić wartość „nextPageToken” z poprzedniej odpowiedzi lub odpowiedź z metody getStartPageToken.
restrictToMyDrive

boolean

Czy ograniczyć wyniki do zmian w hierarchii Mojego dysku. Spowoduje to pominięcie zmian w plikach, takich jak pliki w folderze Dane aplikacji lub pliki udostępnione, które nie zostały dodane do Mojego dysku.
spaces

string

Rozdzielona przecinkami lista przestrzeni do wyszukiwania w korpusach. Obsługiwane wartości to „drive” i „appDataFolder”.
supportsAllDrives

boolean

Czy aplikacja wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofane: zamiast tego użyj parametru supportsAllDrives.
teamDriveId
(deprecated)

string

Wycofane: zamiast tego użyj parametru driveId.
includePermissionsForView

string

Określa, które dodatkowe uprawnienia widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość „published”.
includeLabels

string

Rozdzielona przecinkami lista identyfikatorów etykiet, które mają być uwzględnione w części labelInfo odpowiedzi.

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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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

Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa aplikacji. Więcej informacji znajdziesz w przewodniku po autoryzacji.