Method: files.update

Zaktualizuje metadane lub zawartość pliku. Podczas wywoływania tej metody wypełnij tylko pola żądania, które chcesz zmodyfikować. Podczas aktualizowania pól niektóre z nich, np. modifiedDate, mogą ulec zmianie automatycznie. 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: zamiast dosłownej wartości */* podaj prawidłowy typ MIME. Wartość dosłowna */* jest używana tylko do wskazania, że można przesłać dowolny prawidłowy typ MIME.

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

Żądanie HTTP

  • Identyfikator URI przesyłania – dotyczy żądań przesyłania multimediów:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • Identyfikator URI metadanych, w przypadku żądań tylko z metadanymi:
    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

Oddzielona przecinkami lista identyfikatorów nadrzędnych do dodania.
convert
(deprecated)

boolean

Wycofany: ten parametr nie ma żadnej funkcji.
enforceSingleParent
(deprecated)

boolean

Nieaktualne: dodawanie plików do wielu folderów nie jest już obsługiwane. Zamiast tego użyj shortcuts.
modifiedDateBehavior

enum (ModifiedDateBehavior)

Określa sposób, w jaki modifiedDate jest aktualizowana. Zastępuje to zasadę setModifiedDate.
newRevision

boolean

Określa, czy przesłany blob ma utworzyć nową wersję. Jeśli wartość to false, dane blob w bieżącej wersji głównej zostaną zastąpione. Jeśli wartość jest ustawiona na Prawda lub nie jest ustawiona, nowy blob jest tworzony jako główna wersja, a poprzednie nieprzypięte wersje są zachowane przez krótki czas. Przypięte wersje są przechowywane bez ograniczeń czasowych, wykorzystując dodatkową pulę miejsca na dane, do maksymalnie 200 wersji. Szczegółowe informacje o tym, jak są zachowywane wersje, znajdziesz w Centrum pomocy Dysku.
ocr

boolean

Czy próbować przeprowadzić rozpoznawanie tekstu OCR w przypadku przesłanych plików w formacie .jpg, .png, .gif lub .pdf.
ocrLanguage

string

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

boolean

Czy nowa wersja ma być przypięta. 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 data modyfikacji ma być ustawiana za pomocą wartości podanej w treści żądania. Ustawienie tego pola na true jest równoważne ustawieniu modifiedDateBehavior=fromBodyOrNow, a ustawienie false jest równoważne ustawieniu modifiedDateBehavior=now. Aby zapobiec zmianom w zmodyfikowanym zestawie dat modifiedDateBehavior=noChange.
supportsAllDrives

boolean

Czy aplikacja przesyłająca żądanie obsługuje zarówno Mój Dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofane: użyj w zastępstwie tego supportsAllDrives.
timedTextLanguage

string

Język napisów.
timedTextTrackName

string

Nazwa ścieżki z tekstem synchronizowanym.
updateViewedDate

boolean

Określa, czy po zaktualizowaniu pliku należy zaktualizować datę wyświetlenia.
uploadType

string

Typ żądania przesyłania do identyfikatora URI /upload. Jeśli przesyłasz dane z identyfikatorem URI /upload, to pole jest wymagane. Jeśli tworzysz plik tylko z metadanymi, 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 możliwy do zindeksowania;
includePermissionsForView

string

Określa, które uprawnienia dodatkowego widoku należy uwzględnić w odpowiedzi. Obsługiwana jest tylko wartość published.
includeLabels

string

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