Aktualisiert die Metadaten und/oder den Inhalt einer Datei. Wenn Sie diese Methode aufrufen, füllen Sie nur die Felder in der Anfrage aus, die Sie ändern möchten. Beim Aktualisieren von Feldern ändern sich einige Felder möglicherweise automatisch, z. B. „modifiedDate“. Diese Methode unterstützt die Patch-Semantik.
HTTP-Anfrage
PATCH https://www.googleapis.com/drive/v2/files/{fileId}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter | |
|---|---|
fileId |
Die ID der Datei, die aktualisiert werden soll. |
Abfrageparameter
| Parameter | |
|---|---|
addParents |
Durch Kommas getrennte Liste der zu addierenden übergeordneten IDs. |
convert |
Eingestellt: Dieser Parameter hat keine Funktion. |
enforceSingleParent |
Einstellung: Das Hinzufügen von Dateien zu mehreren Ordnern wird nicht mehr unterstützt. Verwenden Sie stattdessen |
modifiedDateBehavior |
Bestimmt das Verhalten, mit dem |
newRevision |
Gibt an, ob durch einen Blob-Upload eine neue Version erstellt werden soll. Wenn „false“ festgelegt ist, werden die Blob-Daten in der aktuellen Head-Version ersetzt. Wenn „true“ oder nicht festgelegt ist, wird ein neues Blob als Head-Version erstellt und vorherige nicht angepinnte Versionen werden für einen kurzen Zeitraum beibehalten. Angepinnte Versionen werden unbegrenzt gespeichert und belegen ein zusätzliches Speicherkontingent von maximal 200 Versionen. Weitere Informationen dazu, wie Überarbeitungen aufbewahrt werden, finden Sie in der Google Drive-Hilfe. Dieses Feld wird ignoriert, wenn die Anfrage keine Nutzlast enthält. |
ocr |
Ob OCR für JPG-, PNG-, GIF- oder PDF-Uploads versucht werden soll. |
ocrLanguage |
Wenn „ocr“ auf „wahr“ gesetzt ist, wird die zu verwendende Sprache angegeben. Gültige Werte sind BCP 47-Codes. |
pinned |
Ob die neue Version angepinnt werden soll. Eine Datei kann maximal 200 angepinnte Versionen haben. Dieses Feld wird ignoriert, wenn die Anfrage keine Nutzlast enthält. |
removeParents |
Durch Kommas getrennte Liste der zu entfernenden übergeordneten IDs. |
setModifiedDate |
Gibt an, ob das Änderungsdatum mit dem im Anfragetext angegebenen Wert festgelegt werden soll. Wenn Sie dieses Feld auf |
supportsAllDrives |
Ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. |
supportsTeamDrives |
Verworfen. Verwenden Sie stattdessen |
timedTextLanguage |
Die Sprache des synchronisierten Textes. |
timedTextTrackName |
Der Name des Zeitgeber-Texttracks. |
updateViewedDate |
Gibt an, ob das Datum der Datenansicht nach der erfolgreichen Aktualisierung der Datei aktualisiert werden soll. |
useContentAsIndexableText |
Gibt an, ob die Inhalte als indexierbarer Text verwendet werden sollen. |
includePermissionsForView |
Gibt an, welche Berechtigungen der zusätzlichen Ansicht in der Antwort enthalten sein sollen. Nur |
includeLabels |
Eine durch Kommas getrennte Liste von IDs von Labels, die in den Teil |
Anfragetext
Der Anfragetext enthält eine Instanz von File.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von File.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/docshttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.apps.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.scripts
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.