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 werden möglicherweise einige Felder automatisch geändert, z. B. modifiedDate
. Diese Methode unterstützt die Patch-Semantik.
Diese Methode unterstützt einen /upload-URI und akzeptiert hochgeladene Medien mit den folgenden Merkmalen:
- Maximale Dateigröße:5.120 GB
- Zulässige Medien-MIME-Typen:
*/*
Hinweis: Geben Sie einen gültigen MIME-Typ anstelle des Literalwerts */*
an. Das Literal */*
wird nur verwendet, um anzugeben, dass jeder gültige MIME-Typ hochgeladen werden kann.
Weitere Informationen zum Hochladen von Dateien finden Sie unter Dateidaten hochladen.
HTTP-Anfrage
- Upload-URI für Medien-Uploadanfragen:
PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
- Metadaten-URI, für Anfragen, die nur Metadaten enthalten:
PATCH https://www.googleapis.com/drive/v3/files/{fileId}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
uploadType |
Der Typ der Uploadanfrage an den URI Akzeptable Werte sind:
|
fileId |
Die ID der Datei. |
Abfrageparameter
Parameter | |
---|---|
uploadType |
Der Typ der Uploadanfrage an den URI Akzeptable Werte sind:
|
addParents |
Eine durch Kommas getrennte Liste mit übergeordneten IDs, die hinzugefügt werden sollen. |
enforceSingleParent |
Eingestellt: Das Hinzufügen von Dateien zu mehreren Ordnern wird nicht mehr unterstützt. Verwende stattdessen Tastenkombinationen. |
keepRevisionForever |
Gibt an, ob das Feld "keepForever" in der neuen Head-Revision festgelegt werden soll. Dies gilt nur für Dateien mit binären Inhalten in Google Drive. Es können nur 200 Überarbeitungen für die Datei dauerhaft gespeichert werden. Wenn das Limit erreicht ist, versuchen Sie, angepinnte Überarbeitungen zu löschen. |
ocrLanguage |
Sprachhinweis für die OCR-Verarbeitung während des Bildimports (ISO 639-1-Code). |
removeParents |
Eine durch Kommas getrennte Liste der IDs übergeordneter Elemente, die entfernt werden sollen. |
supportsAllDrives |
Gibt an, ob die Anwendung, die die Anfrage stellt, sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. |
supportsTeamDrives |
Eingestellt: Verwende stattdessen |
useContentAsIndexableText |
Gibt an, ob der hochgeladene Inhalt als indexierbaren Text verwendet werden soll. |
includePermissionsForView |
Gibt an, welche zusätzlichen Ansichtsberechtigungen in der Antwort enthalten sein sollen. Nur „veröffentlicht“ wird unterstützt. |
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/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://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.