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 |
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 |
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 |
Określa, czy w wynikach mają być uwzględnione zarówno elementy z Mojego dysku, jak i dysku współdzielonego. |
includeRemoved |
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 |
Wycofane: zamiast tego użyj elementu |
pageSize |
Maksymalna liczba zmian zwracanych na stronę. |
pageToken |
Token kontynuacji poprzedniego żądania listy na następnej stronie. Należy ustawić wartość „nextPageToken” z poprzedniej odpowiedzi lub odpowiedź z metody getStartPageToken. |
restrictToMyDrive |
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 |
Rozdzielona przecinkami lista spacji, do których należy wysłać zapytanie w korpusie. Obsługiwane wartości to „drive” i „appDataFolder”. |
supportsAllDrives |
Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: zamiast tego użyj elementu |
teamDriveId |
Wycofane: zamiast tego użyj elementu |
includePermissionsForView |
Określa, które dodatkowe uprawnienia do widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość „opublikowane”. |
includeLabels |
Rozdzielona przecinkami lista identyfikatorów etykiet do uwzględnienia w części |
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 ( |
Pola | |
---|---|
kind |
Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków |
nextPageToken |
Token strony następnej strony zmian. Będzie ona niedostępna po osiągnięciu końca listy zmian. Token strony nie wygasa. |
newStartPageToken |
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[] |
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.