Method: changes.list

Wyświetla listę zmian dotyczących użytkownika lub dysku współdzielonego.

Żą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 zostanie określony, identyfikator zmiany będzie odzwierciedlać dysk współdzielony. Użyj połączonego identyfikatora dysku i identyfikatora zmiany jako identyfikatora.
includeCorpusRemovals

boolean

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

boolean

Określa, czy uwzględniać zmiany wskazujące, że elementy zostały usunięte z listy zmian, np. 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 poza hierarchią Mojego dysku. Jeśli ta opcja ma wartość „false”, zmiany w plikach, np. w folderze Dane aplikacji lub w udostępnionych plikach, które nie zostały dodane do Mojego dysku, zostaną pominięte w wynikach.
includeTeamDriveItems
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady includeItemsFromAllDrives.
maxResults

integer

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

string

Lista rozdzielonych przecinkami przestrzeni do wysłania zapytania. Obsługiwane wartości to drive, appDataFolder i photos.
startChangeId
(deprecated)

string (int64 format)

Wycofana: zamiast niej używaj zasady pageToken.
supportsAllDrives

boolean

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

boolean

Wycofana: zamiast niej używaj zasady supportsAllDrives.
teamDriveId
(deprecated)

string

Wycofana: zamiast niej używaj zasady driveId.
includePermissionsForView

string

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

string

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

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista zmian dotyczących użytkownika.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "items": [
    {
      object (Change)
    }
  ],
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string
}
Pola
items[]

object (Change)

Lista zmian. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników.
largestChangeId

string (int64 format)

Identyfikator bieżącej największej zmiany.
nextPageToken

string

Token strony z następną stroną zmian. Ta opcja nie będzie widoczna, jeśli osiągnięto koniec listy zmian. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić, a stronicowanie należy rozpocząć od pierwszej strony wyników.
kind

string

Zawsze jest to drive#changeList.
etag

string

ETag listy.
newStartPageToken

string

Token strony początkowej dla przyszłych zmian. Ta opcja będzie widoczna tylko wtedy, gdy dotrzesz do końca listy bieżących zmian.

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 ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.