API Reference

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

To odniesienie do interfejsu API jest uporządkowane według typu zasobu. Każdy typ zasobu ma co najmniej 1 reprezentację danych i co najmniej 1 metodę.

Typy zasobów

  1. Informacje
  2. Zmiany
  3. Kanały
  4. Komentarze
  5. Pliki
  6. Uprawnienia
  7. Odpowiedzi
  8. Wersje
  9. Dyski

Informacje

Szczegółowe informacje o zasobie znajdziesz na stronie Reprezentowanie zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
pobierz GET  /about Zbiera informacje o użytkowniku, jego dysku i funkcjach systemowych.

Wymagane parametry zapytania: fields

Zmiana

Szczegółowe informacje o zasobach znajdziesz na stronie reprezentowania zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
getStartPageToken, GET  /changes/startPageToken Pobiera początkowy token pageToken z listą przyszłych zmian.
list GET  /changes Zawiera listę zmian dotyczących użytkownika lub dysku współdzielonego.

Wymagane parametry zapytania: pageToken

zegarek POST  /changes/watch Subskrybuje zmiany na koncie użytkownika. Aby użyć tej metody, musisz uwzględnić parametr zapytania pageToken.

Kanały

Szczegółowe informacje o zasobach kanałów znajdziesz na stronie Reprezentowanie zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
postój POST  /channels/stop Przestań obserwować zasoby tego kanału

Komentarze

Szczegółowe informacje o zasobie komentarzy znajdziesz na stronie reprezentowania zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
utwórz POST  /files/fileId/comments Tworzy komentarz do pliku.

Wymagane parametry zapytania: fields

usuń DELETE  /files/fileId/comments/commentId Usunięcie komentarza.
pobierz GET  /files/fileId/comments/commentId Pobiera komentarz według identyfikatora.

Wymagane parametry zapytania: fields

list GET  /files/fileId/comments Wyświetla listę komentarzy do pliku.

Wymagane parametry zapytania: fields

zaktualizuj PATCH  /files/fileId/comments/commentId Aktualizuje komentarz o semantykę poprawki.

Wymagane parametry zapytania: fields

Pliki

Szczegółowe informacje o zasobach dotyczących plików znajdziesz na stronie Reprezentowanie zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
kopiuj POST  /files/fileId/copy Tworzy kopię pliku i stosuje wymagane aktualizacje za pomocą semantyki poprawki. Nie można skopiować folderów.
utwórz POST
https://www.googleapis.com/upload/drive/v3/files
i
POST  /files 		Tworzy plik.
usuń DELETE  /files/fileId Trwałe usunięcie pliku należącego do użytkownika bez przenoszenia go do kosza. Jeśli plik należy do dysku współdzielonego, użytkownik musi być organizatorem na dysku nadrzędnym. Jeśli folder docelowy jest folderem, wszystkie jego elementy podrzędne, które należą do użytkownika, również zostaną usunięte.
Opróżnij kosz DELETE  /files/trash Trwale usuwa wszystkie pliki użytkownika znajdujące się w koszu.
eksport GET  /files/fileId/export Eksportuje dokument Google Workspace do żądanego typu MIME i zwraca wyeksportowany plik bajtowy. Pamiętaj, że rozmiar wyeksportowanych treści nie może przekraczać 10 MB.

Wymagane parametry zapytania: mimeType

generateIds GET  /files/generateIds Generuje zestaw identyfikatorów plików, które można podawać w żądaniach tworzenia lub kopiowania.
pobierz GET  /files/fileId Pobiera metadane lub treści pliku na podstawie identyfikatora.
list GET  /files Wyświetla lub wyszukuje pliki.
zaktualizuj PATCH
https://www.googleapis.com/upload/drive/v3/files/fileId
i
PATCH  /files/fileId 		Aktualizuje metadane i/lub zawartość pliku. Wywołując tę metodę, wypełnij tylko pola w żądaniu, które chcesz zmodyfikować. Podczas aktualizowania niektórych pól niektóre pola mogą ulegać automatycznej zmianie, na przykład zmodyfikowana data. Ta metoda obsługuje semantykę poprawki.
zegarek POST  /files/fileId/watch Subskrybuje zmiany w pliku. Możesz określić kanał dla zmian na pliku współdzielonym, ale zmiana w pliku na dysku współdzielonym nie spowoduje utworzenia powiadomienia.
listLabel GET  /files/fileId/listLabels Wyświetla listę etykiet pliku.
modifyLabel POST  /files/fileId/modifyLabels Modyfikuje zestaw etykiet w pliku.

Uprawnienia

Szczegółowe informacje o uprawnieniach znajdziesz na stronie Reprezentowanie zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
utwórz POST  /files/fileId/permissions Powoduje utworzenie uprawnienia do pliku lub dysku współdzielonego. Więcej informacji o tworzeniu uprawnień znajdziesz w artykule Udostępnianie plików, folderów i dysków.
usuń DELETE  /files/fileId/permissions/permissionId Usuwa uprawnienie.
pobierz GET  /files/fileId/permissions/permissionId Pobiera uprawnienia według identyfikatora.
list GET  /files/fileId/permissions Wyświetla listę uprawnień pliku lub dysku współdzielonego.
zaktualizuj PATCH  /files/fileId/permissions/permissionId Aktualizuje uprawnienia za pomocą semantyki poprawki.

Odpowiedzi

Szczegółowe informacje o zasobach odpowiedzi znajdziesz na stronie reprezentowania zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
utwórz POST  /files/fileId/comments/commentId/replies Powoduje utworzenie odpowiedzi na komentarz.

Wymagane parametry zapytania: fields

usuń DELETE  /files/fileId/comments/commentId/replies/replyId Usuwa odpowiedź.
pobierz GET  /files/fileId/comments/commentId/replies/replyId Pobiera odpowiedź według identyfikatora.

Wymagane parametry zapytania: fields

list GET  /files/fileId/comments/commentId/replies Wyświetla listę odpowiedzi na komentarz.

Wymagane parametry zapytania: fields

zaktualizuj PATCH  /files/fileId/comments/commentId/replies/replyId Aktualizuje odpowiedź za pomocą semantyki poprawki.

Wymagane parametry zapytania: fields

Zmiany

Szczegółowe informacje o zasobach wersji znajdziesz na stronie Reprezentowanie zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
usuń DELETE  /files/fileId/revisions/revisionId Trwale usuwa wersję pliku. Na Dysku Google możesz usuwać tylko wersje plików zawierających treści binarne, np. obrazy i filmy. Nie można usunąć wersji innych plików, takich jak Dokumenty czy Arkusze Google, ani ostatniej wersji pliku.
pobierz GET  /files/fileId/revisions/revisionId Pobiera metadane lub treści wersji według identyfikatora.
list GET  /files/fileId/revisions Wyświetla listę wersji pliku.
zaktualizuj PATCH  /files/fileId/revisions/revisionId Aktualizuje wersję o semantykę poprawki.

Napędy

Szczegółowe informacje o zasobach Dysku znajdziesz na stronie Reprezentowanie zasobów.

Metoda Żądanie HTTP Opis
Identyfikatory URI względem https://www.googleapis.com/drive/v3, chyba że zaznaczono inaczej
utwórz POST  /drives Tworzy dysk współdzielony.

Wymagane parametry zapytania: requestId

usuń DELETE  /drives/driveId Trwale usuwa dysk współdzielony, na którym użytkownik jest organizatorem. Dysk współdzielony nie może zawierać żadnych elementów, których nie można przywrócić.
pobierz GET  /drives/driveId Pobiera metadane dysku współdzielonego według identyfikatora.
ukryj POST  /drives/driveId/hide Ukrywa dysk współdzielony w widoku domyślnym.
list GET  /drives Wyświetla listę dysków współdzielonych użytkownika.
Odkryj POST  /drives/driveId/unhide Spowoduje to przywrócenie dysku współdzielonego do widoku domyślnego.
zaktualizuj PATCH  /drives/driveId Aktualizuje metadane dysku współdzielonego.