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.