Method: files.update

Aktualizuje metadane lub treść pliku albo jedno i drugie.

Podczas wywoływania tej metody wypełniaj w żądaniu tylko pola, które chcesz zmodyfikować. Podczas aktualizowania pól niektóre z nich mogą zostać zmienione automatycznie, np. modifiedDate. Ta metoda obsługuje semantykę poprawki.

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

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

    (Podaj prawidłowy typ MIME, a nie dosłowną wartość */*. Literał */* jest używany tylko po to, aby wskazać, że można przesłać dowolny prawidłowy typ MIME. Więcej informacji znajdziesz w artykule Obsługiwane typy MIME w Google Workspace i na Dysku Google.

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku.

Parametry zapytania

Parametry
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 tego użyj skrótów.
keepRevisionForever

boolean

Określa, czy w nowej wersji głównej ma być ustawione pole keepForever. Dotyczy to tylko plików z zawartością binarną na Dysku Google. Na zawsze można zachować tylko 200 wersji pliku. Jeśli limit zostanie osiągnięty, spróbuj usunąć przypięte wersje.
ocrLanguage

string

Wskazówka dotycząca języka na potrzeby 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 wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady supportsAllDrives.
uploadType

string

Typ żądania przesyłania do identyfikatora URI /upload. Jeśli przesyłasz dane za pomocą identyfikatora URI /upload, to pole jest wymagane. 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ż nie obsługuje on przesyłania danych.

Akceptowane wartości:
useContentAsIndexableText

boolean

Określa, czy przesłane treści mają być używane jako tekst indeksowany.
includePermissionsForView

string

Określa, które uprawnienia do dodatkowego widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość published.
includeLabels

string

Lista identyfikatorów etykiet rozdzielona przecinkami, które mają być uwzględnione 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ą ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.