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 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 |
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 |
Określa, czy w wynikach mają być uwzględnione elementy z Mojego dysku i dysku współdzielonego. |
includeRemoved |
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 |
Wycofane: użyj atrybutu |
pageSize |
Maksymalna liczba zmian do zwrócenia na jedną stronę. |
pageToken |
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 |
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 |
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 |
Określa, czy aplikacja, której dotyczy prośba, obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: użyj atrybutu |
teamDriveId |
Wycofane: użyj atrybutu |
includePermissionsForView |
Określa uprawnienia dodatkowego widoku danych, które mają być uwzględnione w odpowiedzi. Tylko „opublikowane” jest obsługiwane. |
includeLabels |
Rozdzielona przecinkami lista identyfikatorów etykiet, które mają zostać uwzględnione w części |
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 ( |
Pola | |
---|---|
kind |
Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków |
nextPageToken |
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 |
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[] |
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.