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 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:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • Metadaten-URI, für Anfragen, die nur Metadaten enthalten:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
uploadType

string

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

Akzeptable Werte sind:

  • media: Einfacher Upload Laden Sie nur die Medien ohne Metadaten hoch.
  • multipart: Mehrteiliger Upload Laden Sie sowohl die Medien als auch die zugehörigen Metadaten in einer einzigen Anfrage hoch.
  • resumable: Fortsetzbarer Upload Laden Sie die Datei fortsetzbar hoch. Verwenden Sie dazu eine Reihe von mindestens zwei Anfragen, wobei die erste Anfrage die Metadaten enthält.
fileId

string

Die ID der zu aktualisierenden Datei.

Abfrageparameter

Parameter
uploadType

string

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

Akzeptable Werte sind:

  • media: Einfacher Upload Laden Sie nur die Medien ohne Metadaten hoch.
  • multipart: Mehrteiliger Upload Laden Sie sowohl die Medien als auch die zugehörigen Metadaten in einer einzigen Anfrage hoch.
  • resumable: Fortsetzbarer Upload Laden Sie die Datei fortsetzbar hoch. Verwenden Sie dazu eine Reihe von mindestens zwei Anfragen, wobei die erste Anfrage die Metadaten enthält.
addParents

string

Kommagetrennte Liste mit übergeordneten IDs, die hinzugefügt werden sollen.

convert
(deprecated)

boolean

Eingestellt: Dieser Parameter hat keine Funktion.

enforceSingleParent
(deprecated)

boolean

Eingestellt: Das Hinzufügen von Dateien zu mehreren Ordnern wird nicht mehr unterstützt. Verwenden Sie stattdessen shortcuts.

modifiedDateBehavior

enum (ModifiedDateBehavior)

Bestimmt das Verhalten, mit dem modifiedDate aktualisiert wird. Dadurch wird setModifiedDate überschrieben.

newRevision

boolean

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.

ocr

boolean

Gibt an, ob die optische Zeichenerkennung bei Uploads im JPG-, PNG-, GIF- oder PDF-Format durchgeführt werden soll.

ocrLanguage

string

Falls „ocr“ auf „true“ gesetzt ist, wird die zu verwendende Sprache angegeben. Gültige Werte sind BCP 47-Codes.

pinned

boolean

Gibt an, ob die neue Überarbeitung angepinnt werden soll. Eine Datei kann maximal 200 angepinnte Überarbeitungen enthalten.

removeParents

string

Durch Kommas getrennte Liste der IDs übergeordneter Elemente, die entfernt werden sollen.

setModifiedDate

boolean

Gibt an, ob das Änderungsdatum mithilfe des im Anfragetext angegebenen Werts festgelegt werden soll. Das Festlegen dieses Felds auf true entspricht modifiedDateBehavior=fromBodyOrNow und false entspricht modifiedDateBehavior=now. Damit keine Änderungen am Änderungsdatum vorgenommen werden, legen Sie den modifiedDateBehavior=noChange fest.

supportsAllDrives

boolean

Gibt an, ob die Anwendung, die die Anfrage stellt, sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt.

supportsTeamDrives
(deprecated)

boolean

Eingestellt: Verwende stattdessen supportsAllDrives.

timedTextLanguage

string

Die Sprache des zeitgesteuerten Textes.

timedTextTrackName

string

Der Name des zeitgesteuerten Text-Tracks.

updateViewedDate

boolean

Gibt an, ob das Ansichtsdatum aktualisiert werden soll, nachdem die Datei erfolgreich aktualisiert wurde.

useContentAsIndexableText

boolean

Gibt an, ob der Inhalt als indexierbaren Text verwendet werden soll.

includePermissionsForView

string

Gibt an, welche zusätzlichen Ansichtsberechtigungen in der Antwort enthalten sein sollen. Nur published wird unterstützt.

includeLabels

string

Eine durch Kommas getrennte Liste mit IDs von Labels, die in den labelInfo-Teil 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/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

Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.