Method: files.create

Erstellt eine neue Datei.

Diese Methode unterstützt einen URI vom Typ /upload und akzeptiert hochgeladene Medien mit den folgenden Eigenschaften:

  • Maximale Dateigröße:5.120 GB
  • Akzeptierte Media-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.

Apps, die Verknüpfungen mit files.create erstellen, müssen den MIME-Typ application/vnd.google-apps.shortcut angeben.

Apps sollten beim Einfügen von Dateien mit der API eine Dateierweiterung im Attribut name angeben. Wenn Sie beispielsweise eine JPEG-Datei einfügen, muss in den Metadaten der Wert "name": "cat.jpg" angegeben werden.

Die nachfolgenden GET-Anfragen enthalten die schreibgeschützte fileExtension-Property, die mit der ursprünglich in der title-Property angegebenen Erweiterung gefüllt wird. Wenn ein Google Drive-Nutzer anfordert, eine Datei herunterzuladen, oder wenn die Datei über den Synchronisierungsclient heruntergeladen wird, erstellt Drive einen vollständigen Dateinamen (mit Erweiterung) basierend auf dem Titel. Wenn die Erweiterung fehlt, wird in Drive versucht, die Erweiterung anhand des MIME-Typs der Datei zu ermitteln.

HTTP-Anfrage

  • Upload-URI für Uploadanfragen für Medien:
    POST https://www.googleapis.com/upload/drive/v3/files
  • Metadaten-URI für Anfragen, die nur Metadaten enthalten:
    POST https://www.googleapis.com/drive/v3/files

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
uploadType

string

Der Typ der Uploadanfrage an den URI /upload. Wenn Sie Daten mit dem URI /upload hochladen, ist dieses Feld erforderlich. Wenn Sie eine reine Metadatendatei erstellen, ist dieses Feld nicht erforderlich. Außerdem wird das Feld nicht im Widget „Diese Methode ausprobieren“ angezeigt, weil es 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 ihre Metadaten in einer einzigen Anfrage hoch.
  • resumable: Fortsetzbarer Upload Die Datei auf wiederholbare Weise hochladen. Verwenden Sie dazu eine Reihe von mindestens zwei Anfragen, wobei die erste Anfrage die Metadaten enthält.
enforceSingleParent

boolean

Veraltet. Das Erstellen von Dateien in mehreren Ordnern wird nicht mehr unterstützt.
ignoreDefaultVisibility

boolean

Gibt an, ob die Standardeinstellungen der Domain für die erstellte Datei ignoriert werden sollen. Domainadministratoren können festlegen, dass alle hochgeladenen Dateien standardmäßig für die Domain sichtbar sind. Mit diesem Parameter wird das Verhalten für die Anfrage umgangen. Berechtigungen werden weiterhin von übergeordneten Ordnern übernommen.
keepRevisionForever

boolean

Gibt an, ob das Feld „keepForever“ in der neuen Head-Überarbeitung 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, löschen Sie angepinnte Überarbeitungen.
ocrLanguage

string

Sprachhinweis für die OCR-Verarbeitung während des Bildimports (ISO 639-1-Code).
supportsAllDrives

boolean

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

boolean

Eingestellt: Verwenden Sie stattdessen supportsAllDrives.
useContentAsIndexableText

boolean

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

string

Gibt an, welche Berechtigungen für die zusätzliche Ansicht in die Antwort aufgenommen werden sollen. Es wird nur „veröffentlicht“ unterstützt.
includeLabels

string

Eine durch Kommas getrennte Liste von IDs der 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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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