Method: files.update

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