Method: changes.list

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

Żą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 będą zwracane zmiany. Jeśli określisz identyfikatory zmian, będą one odzwierciedlać dane dla dysku współdzielonego. Użyj identyfikatora połączonego dysku i zmień identyfikator jako identyfikatora.
includeCorpusRemovals

boolean

Określa, czy zmiany powinny obejmować zasób, jeśli użytkownik nadal ma do niego dostęp w momencie żądania, nawet jeśli plik został usunięty z listy zmian i nie będzie już w nim uwzględnione żadne dalsze wpisy o zmianach.
includeItemsFromAllDrives

boolean

Określa, czy w wynikach mają być uwzględnione zarówno elementy z Mojego dysku, jak i dysku współdzielonego.
includeRemoved

boolean

Określa, czy uwzględnić zmiany wskazujące, że elementy zostały usunięte z listy zmian (np. przez usunięcie lub utratę dostępu).
includeTeamDriveItems
(deprecated)

boolean

Wycofane: zamiast tego użyj elementu includeItemsFromAllDrives.
pageSize

integer

Maksymalna liczba zmian zwracanych na stronę.
pageToken

string

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

boolean

Określa, czy ograniczyć wyniki do zmian w hierarchii Mojego dysku. Pomija to zmiany w plikach takich jak te w folderze Dane aplikacji lub udostępnionych plikach, które nie zostały dodane do Mojego dysku.
spaces

string

Rozdzielona przecinkami lista spacji, do których należy wysłać zapytanie w korpusie. Obsługiwane wartości to „drive” i „appDataFolder”.
supportsAllDrives

boolean

Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofane: zamiast tego użyj elementu supportsAllDrives.
teamDriveId
(deprecated)

string

Wycofane: zamiast tego użyj elementu driveId.
includePermissionsForView

string

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

string

Rozdzielona przecinkami lista identyfikatorów etykiet do uwzględnienia w części labelInfo odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista zmian 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 następnej strony zmian. Będzie ona niedostępna po osiągnięciu końca listy zmian. Token strony nie wygasa.
newStartPageToken

string

Token strony początkowej na potrzeby przyszłych zmian. Będzie widoczna tylko po osiągnięciu końca bieżącej listy zmian. Token strony nie wygasa.
changes[]

object (Change)

Lista zmian. Jeśli wartość NextPageToken jest wypełniona, ta lista może być niekompletna i należy pobrać dodatkową 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.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, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.