Method: changes.list

Wyświetla listę zmian dotyczących użytkownika lub dysku współdzielonego. Więcej informacji znajdziesz w sekcji 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, 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.
includeItemsFromAllDrives

boolean

Czy w wynikach mają być uwzględniane elementy z Mojego dysku i dysków współdzielonych.
includeRemoved

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.
includeTeamDriveItems
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady includeItemsFromAllDrives.
pageSize

integer

Maksymalna liczba zmian do zwrócenia na stronie.
pageToken

string

Token umożliwiający kontynuowanie 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 osiągnięto koniec 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ą ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.