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

Zaktualizuje metadane lub zawartość pliku. Podczas wywoływania tej metody wypełnij tylko pola żądania, które chcesz zmodyfikować. Podczas aktualizowania pól niektóre z nich, np. modifiedDate, mogą ulec zmianie automatycznie. 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: zamiast dosłownej wartości */* podaj prawidłowy typ MIME. Wartość dosłowna */* jest używana tylko do wskazania, że można przesłać dowolny prawidłowy typ MIME.

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

Żądanie HTTP

Identyfikator URI przesyłania, na potrzeby żądań przesyłania multimediów:
PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
Identyfikator URI metadanych, w przypadku żądań tylko z metadanymi:
PATCH https://www.googleapis.com/drive/v3/files/{fileId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry

Parametry
`fileId`	`string` Identyfikator pliku.

fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
`addParents`	`string` Lista identyfikatorów nadrzędnych do dodania, rozdzielona przecinkami.
`enforceSingleParent (deprecated)`	`boolean` Nieaktualne: dodawanie plików do wielu folderów nie jest już obsługiwane. Zamiast tego użyj skrótów.
`keepRevisionForever`	`boolean` Określa, czy w nowej wersji głównej ustawić pole „keepForever”. Dotyczy to tylko plików z zawartością binarną na Dysku Google. Tylko 200 wersji pliku może być przechowywanych na zawsze. Jeśli limit został osiągnięty, spróbuj usunąć przypięte wersje.
`ocrLanguage`	`string` Wskazówka dotycząca języka do przetwarzania OCR podczas importowania obrazu (kod ISO 639-1).
`removeParents`	`string` Rozdzielona przecinkami lista identyfikatorów nadrzędnych do usunięcia.
`supportsAllDrives`	`boolean` Czy aplikacja przesyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone.
`supportsTeamDrives (deprecated)`	`boolean` Wycofane: użyj w zastępstwie tego `supportsAllDrives`.
`uploadType`	`string` Typ żądania przesyłania do identyfikatora URI `/upload`. Jeśli przesyłasz dane z identyfikatorem URI `/upload`, to pole jest wymagane. Jeśli tworzysz plik tylko z metadanymi, to pole nie jest wymagane. Poza tym to pole nie jest widoczne w widżecie „Wypróbuj tę metodę”, ponieważ nie obsługuje on przesyłania danych. Akceptowane wartości: `media` – proste przesyłanie. Prześlij tylko multimedia bez metadanych. `multipart` – przesyłanie w wielu częściach. Prześlij zarówno multimedia, jak i metadane w ramach jednego żądania. `resumable` – przesyłanie z możliwością wznowienia. Prześlij plik w sposób umożliwiający wznowienie przesyłania, używając co najmniej 2 żądań, z których pierwsze zawiera metadane.
`useContentAsIndexableText`	`boolean` Określ, czy przesłane treści mają być używane jako tekst możliwy do zindeksowania.
`includePermissionsForView`	`string` Określa, które uprawnienia dodatkowego widoku należy uwzględnić w odpowiedzi. Obsługiwana jest tylko opcja „opublikowane”.
`includeLabels`	`string` Lista identyfikatorów etykiet rozdzielona przecinkami, które mają być uwzględnione w sekcji `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ą ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.