Method: files.update

Aktualizuje metadane pliku, jego zawartość lub obie te rzeczy.

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 wartość literalną */*. Literał */* jest używany tylko do wskazania, ż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:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • Identyfikator URI metadanych w przypadku żądań dotyczących tylko metadanych:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku do zaktualizowania.

Parametry zapytania

Parametry
addParents

string

Lista identyfikatorów nadrzędnych do dodania rozdzielana przecinkami.
convert
(deprecated)

boolean

Wycofano: 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 zachowanie, w którym aktualizowana jest wartość modifiedDate. Zastępuje to setModifiedDate.
newRevision

boolean

Określa, czy przesłanie obiektu blob powinno spowodować utworzenie nowej wersji. Jeśli wartość to false, dane obiektu blob w bieżącej wersji głównej zostaną zastąpione. Jeśli ta opcja ma wartość „true” lub nie jest ustawiona, nowy obiekt blob jest tworzony jako wersja główna, a poprzednie nieprzypięte wersje są zachowywane przez krótki czas. Przypięte wersje są przechowywane bez ograniczeń czasowych i wykorzystują dodatkowy limit miejsca na dane (maksymalnie 200 wersji). Szczegółowe informacje o tym, jak są przechowywane zmiany, znajdziesz w Centrum pomocy Dysku.
ocr

boolean

Określa, czy należy próbować przeprowadzić OCR w przypadku przesłanych plików .jpg, .png, .gif lub .pdf.
ocrLanguage

string

Jeśli ocr ma wartość true, podpowiada język, którego należy użyć. Prawidłowe wartości to kody BCP 47.
pinned

boolean

Czy przypiąć nową wersję. Plik może mieć maksymalnie 200 przypiętych wersji.
removeParents

string

Rozdzielona przecinkami lista identyfikatorów nadrzędnych do usunięcia.
setModifiedDate

boolean

Określa, czy data modyfikacji ma być ustawiona na podstawie wartości podanej w treści żądania. Ustawienie tego pola na true jest równoznaczne z modifiedDateBehavior=fromBodyOrNow, a false jest równoznaczne z modifiedDateBehavior=now. Aby zapobiec zmianom daty modyfikacji, ustaw wartość modifiedDateBehavior=noChange.
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.
timedTextLanguage

string

Język tekstu synchronizowanego.
timedTextTrackName

string

Nazwa ścieżki z tekstem synchronizowanym.
updateViewedDate

boolean

Określa, czy po zaktualizowaniu pliku ma zostać zaktualizowana data wyświetlenia.
uploadType

string

Typ żądania przesyłania do identyfikatora URI /upload. Jeśli przesyłasz dane za pomocą /upload identyfikatora URI, 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

Czy treść ma być używana 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/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 i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.