Method: changes.list

Wyświetla zmiany wprowadzone przez użytkownika lub na dysku współdzielonym. 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 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

Wycofana: użyj w jej miejsce zasady 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

Wycofana: użyj w jej miejsce zasady supportsAllDrives.
teamDriveId
(deprecated)

string

Wycofana: użyj w jej miejsce 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 musi być pusta.

Treść odpowiedzi

Lista zmian dla użytkownika.

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

Zapis JSON 
{
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string,
  "changes": [
    {
      object (Change)
    }
  ]
}
Pola
kind

string

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

string

Token strony dla następnej strony zmian. Nie będzie widoczna, jeśli dojdzie do końca lista zmian. Token strony nie wygasa.
newStartPageToken

string

Token strony początkowej dla przyszłych zmian. Jest ona widoczna tylko wtedy, gdy osiągnięto koniec listy bieżących zmian. Token strony nie wygasa.
changes[]

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