Method: files.patch

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 z nich mogą ulec zmianie automatycznie, np.ModifiedDate. 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 aktualizacji.

Parametry zapytania

Parametry
addParents

string

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

boolean

Wycofany: 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 działanie, w ramach którego aktualizowane jest modifiedDate. Spowoduje to zastąpienie kolumny setModifiedDate.
newRevision

boolean

Określa, czy przesłanie obiektu blob ma utworzyć nową wersję. Jeśli ma wartość false (fałsz), dane bloba w bieżącej wersji nagłówka zostaną zastąpione. Jeśli zasada ma wartość Prawda lub jest nieskonfigurowana, jako wersja nagłówka tworzony jest nowy obiekt blob, a poprzednie nieprzypięte wersje są zachowywane przez krótki czas. Przypięte wersje są przechowywane bez ograniczeń czasowych z wykorzystaniem dodatkowego miejsca na dane – maksymalnie 200 wersji. Więcej informacji o przechowywaniu wersji znajdziesz w Centrum pomocy Dysku. Pamiętaj, że to pole jest ignorowane, jeśli w żądaniu nie ma ładunku.
ocr

boolean

Określa, czy ma zostać podjęta próba użycia OCR w przypadku plików .jpg, .png, .gif, czy .pdf.
ocrLanguage

string

Jeśli ocr ma wartość true (prawda), wskazówki dotyczące języka, którego należy użyć. Prawidłowe wartości to kody BCP 47.
pinned

boolean

Określa, czy chcesz przypiąć nową wersję. Plik może zawierać maksymalnie 200 przypiętych wersji. Pamiętaj, że to pole jest ignorowane, jeśli w żądaniu nie ma ładunku.
removeParents

string

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

boolean

Określa, czy datę modyfikacji należy ustawić przy użyciu wartości podanej w treści żądania. Ustawienie tego pola na true jest równoważne z wartością modifiedDateBehavior=fromBodyOrNow, a false jest równoważne z modifiedDateBehavior=now. Aby zapobiec zmianie daty modyfikacji, ustaw modifiedDateBehavior=noChange.
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.
timedTextLanguage

string

Język tekstu wskazywanego przez funkcję czasu.
timedTextTrackName

string

Nazwa ścieżki tekstowej z licznikiem czasu.
updateViewedDate

boolean

Określa, czy zaktualizować datę widoku po zaktualizowaniu pliku.
useContentAsIndexableText

boolean

Określa, czy 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ść published.
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/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, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.