Method: changes.list

Wyświetla zmiany wprowadzone przez użytkownika lub na dysku współdzielonym.

Żądanie HTTP

GET https://www.googleapis.com/drive/v2/changes

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 musi być pusta.

Treść odpowiedzi

Lista zmian dla 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 (Change)
    }
  ]
}
Pola
largestChangeId

string (int64 format)

Identyfikator bieżącej największej zmiany.
nextPageToken

string

Token strony dla następnej strony zmian. Nie będzie widoczna, jeśli dojdziesz do końca listy zmian. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić i ponowić pobieranie stron od pierwszej strony wyników.
kind

string

Jest ona zawsze drive#changeList.
etag

string

ETag listy.
newStartPageToken

string

Token strony startowej dla przyszłych zmian. Jest ona widoczna tylko wtedy, gdy osiągnięto koniec listy bieżących zmian.
items[]

object (Change)

lista zmian; Jeśli parametr nextPageToken jest wypełniony, lista może być niekompletna i należy pobrać kolejną 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.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.