Method: changes.watch

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

string

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

boolean

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

boolean

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

boolean

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
(deprecated)

boolean

Wycofane: użyj w zastępstwie tego includeItemsFromAllDrives.
pageSize

integer

Maksymalna liczba zmian zwracanych na stronę.
pageToken

string

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

boolean

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

string

Rozdzielana przecinkami lista przestrzeni, których dotyczy zapytanie w korpusach. Obsługiwane wartości to „drive” i „appDataFolder”.
supportsAllDrives

boolean

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

boolean

Wycofane: użyj w zastępstwie tego supportsAllDrives.
teamDriveId
(deprecated)

string

Wycofane: użyj w zastępstwie zasady driveId.
includePermissionsForView

string

Określa, które uprawnienia dodatkowego widoku należy uwzględnić w odpowiedzi. Obsługiwana jest tylko opcja „opublikowano”.
includeLabels

string

Lista identyfikatorów etykiet rozdzielonych przecinkami, które mają być uwzględnione w sekcji 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, aby można było ich używać w aplikacji. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.