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:
PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
Identyfikator URI metadanych dla żądań tylko metadanych:
PUT https://www.googleapis.com/drive/v2/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 do aktualizacji.

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.
`convert (deprecated)`	`boolean` Wycofany: ten parametr nie ma funkcji.
`enforceSingleParent (deprecated)`	`boolean` Wycofane: dodawanie plików do wielu folderów nie jest już obsługiwane. Użyj w zamian zasady `shortcuts`.
`modifiedDateBehavior`	`enum (ModifiedDateBehavior)` Określa działanie, w ramach którego aktualizowane jest `modifiedDate`. Spowoduje to zastąpienie kolumny `setModifiedDate`.
`newRevision`	`boolean` Określa, czy przesłanie obiektu blob ma utworzyć nową wersję. Jeśli ma wartość false (fałsz), dane bloba w bieżącej wersji nagłówka zostaną zastąpione. Jeśli zasada ma wartość Prawda lub jest nieskonfigurowana, jako wersja nagłówka tworzony jest nowy obiekt blob, a poprzednie nieprzypięte wersje są zachowywane przez krótki czas. Przypięte wersje są przechowywane bez ograniczeń czasowych z wykorzystaniem dodatkowego miejsca na dane – maksymalnie 200 wersji. Więcej informacji o przechowywaniu wersji znajdziesz w Centrum pomocy Dysku.
`ocr`	`boolean` Określa, czy ma zostać podjęta próba użycia OCR w przypadku plików .jpg, .png, .gif, czy .pdf.
`ocrLanguage`	`string` Jeśli ocr ma wartość true (prawda), wskazówki dotyczące języka, którego należy użyć. Prawidłowe wartości to kody BCP 47.
`pinned`	`boolean` Określa, czy chcesz przypiąć nową wersję. Plik może zawierać maksymalnie 200 przypiętych wersji.
`removeParents`	`string` Rozdzielona przecinkami lista identyfikatorów nadrzędnych do usunięcia.
`setModifiedDate`	`boolean` Określa, czy datę modyfikacji należy ustawić przy użyciu wartości podanej w treści żądania. Ustawienie tego pola na `true` jest równoważne z wartością `modifiedDateBehavior=fromBodyOrNow`, a `false` jest równoważne z `modifiedDateBehavior=now`. Aby zapobiec zmianie daty modyfikacji, ustaw `modifiedDateBehavior=noChange`.
`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`.
`timedTextLanguage`	`string` Język tekstu wskazywanego przez funkcję czasu.
`timedTextTrackName`	`string` Nazwa ścieżki tekstowej z licznikiem czasu.
`updateViewedDate`	`boolean` Określa, czy zaktualizować datę widoku po zaktualizowaniu pliku.
`useContentAsIndexableText`	`boolean` Określa, czy 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ść `published`.
`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/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
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.