Method: files.update

Aktualisiert die Metadaten, den Inhalt oder beides 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 Merkmalen:

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

    Geben Sie einen gültigen MIME-Typ an und nicht den Literalwert */*. Das Literal */* wird nur verwendet, um anzugeben, dass ein beliebiger gültiger MIME-Typ hochgeladen werden kann. Weitere Informationen finden Sie unter Unterstützte MIME-Typen für Google Workspace und Google Drive.)

Weitere Informationen zum Hochladen von Dateien finden Sie unter Dateidaten hochladen.

HTTP-Anfrage

  • Upload-URI für Media-Uploadanfragen:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • Metadaten-URI für Anfragen mit ausschließlich Metadaten:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Die ID der zu aktualisierenden Datei.

Suchparameter

Parameter
addParents

string

Durch Kommas getrennte Liste der hinzuzufügenden übergeordneten IDs.
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, bei dem modifiedDate aktualisiert wird. Dadurch wird setModifiedDate überschrieben.
newRevision

boolean

Gibt an, ob beim Hochladen eines Blobs eine neue Überarbeitung erstellt werden soll. Wenn „false“, werden die Blob-Daten in der aktuellen Head-Revision ersetzt. Wenn „true“ oder nicht festgelegt, wird ein neues Blob als Head-Revision erstellt und vorherige nicht angepinnte Revisionen werden für einen kurzen Zeitraum beibehalten. Angepinnte Versionen werden unbegrenzt gespeichert. Dabei wird zusätzliches Speicherkontingent verwendet, bis zu maximal 200 Versionen. Weitere Informationen dazu, wie Überarbeitungen beibehalten werden, finden Sie in der Drive-Hilfe.
ocr

boolean

Ob OCR für JPG-, PNG-, GIF- oder PDF-Uploads versucht werden soll.
ocrLanguage

string

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

boolean

Ob die neue Überarbeitung angepinnt werden soll. Eine Datei kann maximal 200 angepinnte Überarbeitungen haben.
removeParents

string

Durch Kommas getrennte Liste der zu entfernenden übergeordneten IDs.
setModifiedDate

boolean

Gibt an, ob das Änderungsdatum mit dem im Anfragetext angegebenen Wert festgelegt werden soll. Wenn Sie dieses Feld auf true setzen, entspricht das modifiedDateBehavior=fromBodyOrNow. false entspricht modifiedDateBehavior=now. So verhindern Sie Änderungen am geänderten Datumsbereich modifiedDateBehavior=noChange.
supportsAllDrives

boolean

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

boolean

Nicht mehr unterstützt: Verwenden Sie stattdessen supportsAllDrives.
timedTextLanguage

string

Die Sprache des Timed Text.
timedTextTrackName

string

Der Name des Timed-Text-Tracks.
updateViewedDate

boolean

Gibt an, ob das Ansichtsdatum nach dem erfolgreichen Aktualisieren der Datei aktualisiert werden soll.
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 reine Metadatendatei erstellen, ist dieses Feld nicht erforderlich. Außerdem wird dieses Feld nicht im Widget „Diese Methode ausprobieren“ angezeigt, da das Widget keine Daten-Uploads 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 mindestens zwei Anfragen, wobei die erste Anfrage die Metadaten enthält.
useContentAsIndexableText

boolean

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

string

Gibt an, welche zusätzlichen Berechtigungen der Ansicht in die Antwort aufgenommen werden sollen. Nur published wird unterstützt.
includeLabels

string

Eine durch Kommas getrennte Liste mit IDs von Labels, die im labelInfo-Teil der Antwort enthalten sein 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 für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.