Ta strona została przetłumaczona przez Cloud Translation API.

Method: files.update

Żądanie HTTP
Parametry ścieżki
Parametry zapytania
Treść żądania
Treść odpowiedzi
Zakresy autoryzacji
Wypróbuj

Aktualizuje metadane lub zawartość pliku. Wywołując tę metodę, wypełniaj tylko pola w żądaniu, które chcesz zmodyfikować. Podczas aktualizowania pól niektóre pola mogą zostać zmienione automatycznie, np. modifiedDate. Ta metoda obsługuje semantykę poprawki.

Ta metoda obsługuje identyfikator URI /upload i akceptuje przesłane multimedia o tych cechach:

Maksymalny rozmiar pliku: 5120 GB
Akceptowane typy MIME multimediów:*/*

Uwaga: określ prawidłowy typ MIME, a nie literał */*. Literał */* służy tylko do wskazywania, że można przesłać dowolny prawidłowy typ MIME.

Więcej informacji o przesyłaniu plików znajdziesz w artykule Przesyłanie danych plików.

Żądanie HTTP

Identyfikator URI przesyłania dla żądań przesłania multimediów:
PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
Identyfikator URI metadanych dla żądań tylko metadanych:
PATCH https://www.googleapis.com/drive/v3/files/{fileId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry

uploadType

string

Typ żądania przesłania do identyfikatora URI /upload. To pole jest wymagane, jeśli przesyłasz dane za pomocą identyfikatora URI /upload. Jeśli tworzysz plik zawierający tylko metadane, to pole nie jest wymagane. Poza tym to pole nie jest widoczne w widżecie „Wypróbuj tę metodę”, ponieważ widżet nie obsługuje przesyłania danych.

Dopuszczalne wartości:

media – Proste przesyłanie. Przesyłaj tylko multimedia, bez metadanych.
multipart – przesyłanie wieloczęściowe. Prześlij zarówno multimedia, jak i ich metadane w jednym żądaniu.
resumable – przesyłanie z możliwością wznowienia. Prześlij plik w sposób umożliwiający jego wznowienie, korzystając z serii co najmniej 2 żądań, z których pierwsze zawiera metadane.

fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
`uploadType`	`string` Typ żądania przesłania do identyfikatora URI `/upload`. To pole jest wymagane, jeśli przesyłasz dane za pomocą identyfikatora URI `/upload`. Jeśli tworzysz plik zawierający tylko metadane, to pole nie jest wymagane. Poza tym to pole nie jest widoczne w widżecie „Wypróbuj tę metodę”, ponieważ widżet nie obsługuje przesyłania danych. Dopuszczalne wartości: `media` – Proste przesyłanie. Przesyłaj tylko multimedia, bez metadanych. `multipart` – przesyłanie wieloczęściowe. Prześlij zarówno multimedia, jak i ich metadane w jednym żądaniu. `resumable` – przesyłanie z możliwością wznowienia. Prześlij plik w sposób umożliwiający jego wznowienie, korzystając z serii co najmniej 2 żądań, z których pierwsze zawiera metadane.
`addParents`	`string` Rozdzielona przecinkami lista identyfikatorów nadrzędnych do dodania.
`enforceSingleParent (deprecated)`	`boolean` Wycofane: dodawanie plików do wielu folderów nie jest już obsługiwane. Zamiast nich używaj skrótów.
`keepRevisionForever`	`boolean` Określa, czy w nowej wersji nagłówka ustawić pole „keepForever”. Dotyczy to tylko plików z zawartością binarną na Dysku Google. Na zawsze można przechowywać tylko 200 wersji pliku. Jeśli limit został osiągnięty, spróbuj usunąć przypięte wersje.
`ocrLanguage`	`string` Wskazówka dotycząca języka przetwarzania OCR podczas importowania obrazu (kod ISO 639-1).
`removeParents`	`string` Rozdzielona przecinkami lista identyfikatorów elementów nadrzędnych do usunięcia.
`supportsAllDrives`	`boolean` Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone.
`supportsTeamDrives (deprecated)`	`boolean` Wycofane: zamiast tego użyj elementu `supportsAllDrives`.
`useContentAsIndexableText`	`boolean` Określa, czy przesłana treść ma być używana jako indeksowalny tekst.
`includePermissionsForView`	`string` Określa, które dodatkowe uprawnienia do widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość „opublikowane”.
`includeLabels`	`string` Rozdzielona przecinkami lista identyfikatorów etykiet do uwzględnienia w części `labelInfo` odpowiedzi.

Treść żądania

Treść żądania zawiera wystąpienie elementu File.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu File.

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.scripts

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.