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 zmiany zostaną zwrócone. Jeśli określisz identyfikatory zmian, będą one odzwierciedlać dane na dysku współdzielonym. użyj połączonego identyfikatora dysku i zmień identyfikator jako identyfikator.

includeCorpusRemovals

boolean

Określa, czy zmiany powinny uwzględniać zasób pliku, jeśli plik jest nadal dostępny dla użytkownika w chwili wysyłania żądania, nawet jeśli plik został usunięty z listy zmian i żadne zmiany nie będą już wprowadzane.

includeItemsFromAllDrives

boolean

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

includeRemoved

boolean

Określa, czy uwzględnić zmiany wskazujące na to, że elementy zostały usunięte z listy zmian, na przykład w wyniku ich usunięcia lub utraty dostępu.

includeTeamDriveItems
(deprecated)

boolean

Wycofane: użyj atrybutu includeItemsFromAllDrives.

pageSize

integer

Maksymalna liczba zmian do zwrócenia na jedną stronę.

pageToken

string

Token kontynuujący poprzednie żądanie listy na następnej stronie. Należy ustawić wartość „nextPageToken” z poprzedniej odpowiedzi lub do odpowiedzi z metody getStartPageToken.

restrictToMyDrive

boolean

Określa, czy ograniczyć wyniki do zmian w hierarchii Mojego dysku. Spowoduje to pominięcie zmian w plikach, na przykład w plikach w folderze Dane aplikacji lub udostępnionych plikach, które nie zostały dodane do Mojego dysku.

spaces

string

Rozdzielona przecinkami lista spacji, na które ma zostać wysłane zapytanie w obrębie korpusów. Obsługiwane wartości to „drive”. i „appDataFolder”.

supportsAllDrives

boolean

Określa, czy aplikacja, której dotyczy prośba, obsługuje zarówno Mój dysk, jak i dyski współdzielone.

supportsTeamDrives
(deprecated)

boolean

Wycofane: użyj atrybutu supportsAllDrives.

teamDriveId
(deprecated)

string

Wycofane: użyj atrybutu driveId.

includePermissionsForView

string

Określa uprawnienia dodatkowego widoku danych, które mają być uwzględnione w odpowiedzi. Tylko „opublikowane” jest obsługiwane.

includeLabels

string

Rozdzielona przecinkami lista identyfikatorów etykiet, które mają zostać 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
{
  "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 następnej strony zmian. Ten parametr nie będzie widoczny, jeśli został osiągnięty koniec listy zmian. Token strony nie wygasa.

newStartPageToken

string

Token strony startowej na potrzeby przyszłych zmian. Ta wartość będzie widoczna tylko wtedy, gdy dojdzie do końca bieżącej listy zmian. Token strony nie wygasa.

changes[]

object (Change)

Lista zmian. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i powinna zostać pobrana dodatkowa strona z wynikami.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.