Method: files.create

Erstellt eine neue Datei.

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.

Für Apps, die Verknüpfungen mit files.create erstellen, muss der MIME-Typ application/vnd.google-apps.shortcut angegeben werden.

Apps sollten beim Einfügen von Dateien über die API eine Dateiendung in der Eigenschaft name angeben. Beispielsweise sollte bei einem Vorgang zum Einfügen einer JPEG-Datei in den Metadaten "name": "cat.jpg" angegeben werden.

Die nachfolgenden GET-Anfragen enthalten das schreibgeschützte Attribut fileExtension, in dem die Erweiterung angegeben ist, die ursprünglich in der Eigenschaft title angegeben wurde. Wenn ein Google Drive-Nutzer eine Downloadanfrage für eine Datei anfordert oder die Datei über den Synchronisierungsclient heruntergeladen wird, wird in Drive basierend auf dem Titel ein vollständiger Dateiname (mit Erweiterung) erstellt. Falls die Erweiterung fehlt, versucht Google Drive, sie anhand des MIME-Typs der Datei zu ermitteln.

HTTP-Anfrage

  • Upload-URI für Medien-Uploadanfragen:
    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 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.
enforceSingleParent

boolean

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

ignoreDefaultVisibility

boolean

Gibt an, ob die standardmäßigen Sichtbarkeitseinstellungen 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 sein sollen. 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. 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, versuchen Sie, angepinnte Überarbeitungen zu löschen.

ocrLanguage

string

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

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.

useContentAsIndexableText

boolean

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

includePermissionsForView

string

Gibt an, welche zusätzlichen Ansichtsberechtigungen in der Antwort enthalten sein sollen. Nur „veröffentlicht“ 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/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, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.