Method: files.update

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 einige Felder möglicherweise 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 Eigenschaften:

  • Maximale Dateigröße:5.120 GB
  • Zulässige Medien-MIME-Typen:*/*

Hinweis: Geben Sie einen gültigen MIME-Typ an, anstatt den Literalwert */*. Der Literalwert */* gibt nur an, 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 Anfragen zum Hochladen von Medien:
    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
fileId

string

Die ID der Datei.

Abfrageparameter

Parameter
addParents

string

Eine durch Kommas getrennte Liste der zugehörigen IDs.
enforceSingleParent
(deprecated)

boolean

Einstellung: Das Hinzufügen von Dateien zu mehreren Ordnern wird nicht mehr unterstützt. Verwenden Sie stattdessen Tastenkombinationen.
keepRevisionForever

boolean

Gibt an, ob das Feld „keepForever“ in der neuen Hauptversion festgelegt werden soll. Dies gilt nur für Dateien mit Binärinhalten in Google Drive. Es können nur 200 Versionen der Datei dauerhaft gespeichert werden. Wenn das Limit erreicht ist, löschen Sie angepinnte Überarbeitungen.
ocrLanguage

string

Ein Sprachhinweis für die OCR-Verarbeitung beim Bildimport (ISO 639-1-Code).
removeParents

string

Eine durch Kommas getrennte Liste der zu entfernenden übergeordneten IDs.
supportsAllDrives

boolean

Ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.
supportsTeamDrives
(deprecated)

boolean

Verworfen. Verwenden Sie stattdessen supportsAllDrives.
uploadType

string

Der Typ der Uploadanfrage an den /upload-URI. Wenn Sie Daten mit einem /upload-URI hochladen, ist dieses Feld erforderlich. Wenn Sie eine Datei mit reinen Metadaten erstellen, ist dieses Feld nicht erforderlich. Außerdem wird dieses Feld nicht im Widget „Diese Methode ausprobieren“ angezeigt, da das Widget keine Datenuploads unterstützt.

Akzeptable Werte sind:

  • media – Einfacher Upload. Lade nur die Medien ohne Metadaten hoch.
  • multipart – Mehrteiliger Upload. Lade sowohl die Medien als auch die zugehörigen Metadaten in einer einzigen Anfrage hoch.
  • resumable – Fortsetzbarer Upload Laden Sie die Datei mit einer Reihe von mindestens zwei Anfragen hoch, wobei die erste Anfrage die Metadaten enthält.
useContentAsIndexableText

boolean

Ob die hochgeladenen Inhalte als indexierbarer Text verwendet werden sollen.
includePermissionsForView

string

Gibt an, welche Berechtigungen der zusätzlichen Ansicht in der Antwort enthalten sein sollen. Nur „veröffentlicht“ wird unterstützt.
includeLabels

string

Eine durch Kommas getrennte Liste der IDs der Labels, die in den Teil labelInfo der Antwort aufgenommen werden sollen.

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.