Method: files.create

Erstellt eine Datei. Weitere Informationen finden Sie unter Dateien erstellen und verwalten.

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 in Google Workspace und Google Drive.

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

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

Apps sollten beim Einfügen von Dateien mit der API eine Dateiendung im Attribut name angeben. Bei einem Vorgang zum Einfügen einer JPEG-Datei sollte in den Metadaten beispielsweise "name": "cat.jpg" angegeben werden.

Nachfolgende GET-Anfragen enthalten das schreibgeschützte Attribut fileExtension, das mit der Erweiterung gefüllt ist, die ursprünglich im Attribut name angegeben wurde. Wenn ein Google Drive-Nutzer eine Datei herunterlädt oder die Datei über den Synchronisierungsclient heruntergeladen wird, wird in Drive anhand des Namens ein vollständiger Dateiname (mit Erweiterung) erstellt. Wenn die Erweiterung fehlt, versucht Drive, sie anhand des MIME-Typs der Datei zu ermitteln.

HTTP-Anfrage

  • Upload-URI für Media-Uploadanfragen:
    POST https://www.googleapis.com/upload/drive/v3/files
  • Metadaten-URI für reine Metadatenanfragen:
    POST https://www.googleapis.com/drive/v3/files

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
enforceSingleParent
(deprecated)

boolean

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

boolean

Gibt an, ob die Standardeinstellungen für die Sichtbarkeit der Domain für die erstellte Datei ignoriert werden sollen. Domain-Administratoren können festlegen, dass alle hochgeladenen Dateien standardmäßig für die Domain sichtbar sind. Dieser Parameter umgeht dieses Verhalten für die Anfrage. Berechtigungen werden weiterhin von übergeordneten Ordnern übernommen.
keepRevisionForever

boolean

Gibt an, ob das Feld keepForever in der neuen Head-Revision festgelegt werden soll. Das gilt nur für Dateien mit binären Inhalten in Google Drive. Es können nur 200 Überarbeitungen der Datei dauerhaft gespeichert werden. Wenn das Limit erreicht ist, können Sie versuchen, angepinnte Überarbeitungen zu löschen.
ocrLanguage

string

Ein Sprachhinweis für die OCR-Verarbeitung beim Importieren von Bildern (ISO 639-1-Code).
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 nur mit 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 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 die hochgeladenen Inhalte als indexierbarer Text verwendet werden sollen.
includePermissionsForView

string

Gibt an, welche Berechtigungen für zusätzliche Ansichten 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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

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.