Method: files.patch

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 mogą się zmieniać automatycznie, np. data modyfikacji. Ta metoda obsługuje semantykę poprawki.

Żądanie HTTP

PATCH 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. Pamiętaj, że to pole jest ignorowane, jeśli żądanie nie zawiera ładunku.
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. Pamiętaj, że to pole jest ignorowane, jeśli żądanie nie zawiera ładunku.
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.
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.