Method: changes.list

Wyświetla zmiany dotyczące użytkownika lub dysku współdzielonego. Więcej informacji znajdziesz w artykule Pobieranie zmian.

Żądanie HTTP

GET https://www.googleapis.com/drive/v3/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, identyfikatory zmian będą 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.
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

Wycofana: zamiast niej używaj zasady includeItemsFromAllDrives.
pageSize

integer

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

Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 100 zmian.

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

string

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

boolean

Określa, czy wyniki mają być ograniczone do zmian w hierarchii Mój dysk. Nie obejmuje to zmian w plikach, takich jak pliki w folderze Dane aplikacji czy pliki udostępnione, które nie zostały dodane do Mojego dysku.
spaces

string

Lista rozdzielonych przecinkami przestrzeni, w których chcesz wyszukiwać 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

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 
{
  "changes": [
    {
      object (Change)
    }
  ],
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string
}
Pola
changes[]

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

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#changeList".
nextPageToken

string

Token strony z następną stroną zmian. Ta opcja nie będzie widoczna, jeśli dotrzesz do końca listy zmian. Token strony nie wygasa.
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. Token strony nie wygasa.

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ą objęte ograniczeniami i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.