Method: changes.watch

subskrybować zmiany dotyczące użytkownika.

Żądanie HTTP

POST https://www.googleapis.com/drive/v2/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.
includeDeleted

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.
includeItemsFromAllDrives

boolean

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

boolean

Określa, czy w wyniku mają być uwzględniane zmiany spoza hierarchii Mojego dysku. Gdy to ustawienie ma wartość fałsz, z wyniku pomijane są zmiany w plikach, np. w folderze Application Data, lub pliki udostępnione, które nie zostały dodane do Mojego dysku.
includeTeamDriveItems
(deprecated)

boolean

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

integer

Maksymalna liczba zmian do zwrócenia.
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.
spaces

string

Lista przestrzeni, których dotyczy zapytanie, rozdzielona przecinkami. Obsługiwane wartości to drive, appDataFolder i photos.
startChangeId
(deprecated)

string (int64 format)

Wycofane: użyj w zastępstwie tego pageToken.
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 tego driveId.
includePermissionsForView

string

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

string

Lista identyfikatorów etykiet rozdzielona 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/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.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 aplikacja mogła z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.