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 können sich einige Felder automatisch ändern, z. B. „GeändertDate“. 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 zu aktualisierenden Datei. |
Abfrageparameter
| Parameter | |
|---|---|
addParents |
Kommagetrennte Liste mit übergeordneten IDs, die hinzugefügt werden sollen. |
convert |
Eingestellt: Dieser Parameter hat keine Funktion. |
enforceSingleParent |
Eingestellt: 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 Überarbeitung erstellt werden soll. Bei „false“ werden die Blob-Daten in der aktuellen Head-Überarbeitung ersetzt. Ist die Richtlinie auf „true“ gesetzt oder nicht festgelegt, wird ein neues Blob als Hauptüberarbeitung erstellt. Vorherige losgelöste Überarbeitungen werden für kurze Zeit beibehalten. Angepinnte Überarbeitungen werden auf unbestimmte Zeit und mit einem zusätzlichen Speicherkontingent bis zu maximal 200 Überarbeitungen gespeichert. Weitere Informationen dazu, wie Überarbeitungen aufbewahrt werden, finden Sie in der Google Drive-Hilfe. Beachten Sie, dass dieses Feld ignoriert wird, wenn die Anfrage keine Nutzlast enthält. |
ocr |
Gibt an, ob die optische Zeichenerkennung bei Uploads im JPG-, PNG-, GIF- oder PDF-Format durchgeführt werden soll. |
ocrLanguage |
Falls „ocr“ auf „true“ gesetzt ist, wird die zu verwendende Sprache angegeben. Gültige Werte sind BCP 47-Codes. |
pinned |
Gibt an, ob die neue Überarbeitung angepinnt werden soll. Eine Datei kann maximal 200 angepinnte Überarbeitungen enthalten. Beachten Sie, dass dieses Feld ignoriert wird, wenn die Anfrage keine Nutzlast enthält. |
removeParents |
Durch Kommas getrennte Liste der IDs übergeordneter Elemente, die entfernt werden sollen. |
setModifiedDate |
Gibt an, ob das Änderungsdatum mithilfe des im Anfragetext angegebenen Werts festgelegt werden soll. Das Festlegen dieses Felds auf |
supportsAllDrives |
Gibt an, ob die Anwendung, die die Anfrage stellt, sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. |
supportsTeamDrives |
Eingestellt: Verwende stattdessen |
timedTextLanguage |
Die Sprache des zeitgesteuerten Textes. |
timedTextTrackName |
Der Name des zeitgesteuerten Text-Tracks. |
updateViewedDate |
Gibt an, ob das Ansichtsdatum aktualisiert werden soll, nachdem die Datei erfolgreich aktualisiert wurde. |
useContentAsIndexableText |
Gibt an, ob der Inhalt als indexierbaren Text verwendet werden soll. |
includePermissionsForView |
Gibt an, welche zusätzlichen Ansichtsberechtigungen in der Antwort enthalten sein sollen. Nur |
includeLabels |
Eine durch Kommas getrennte Liste mit IDs von Labels, die in den |
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.