Method: files.insert

Hiermit wird eine neue Datei eingefügt.

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

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

Hinweis: Geben Sie einen gültigen MIME-Typ an, anstatt den Literalwert */*. Der Literalwert */* gibt nur an, 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.insert 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 title angeben. Bei einem Vorgang zum Einfügen einer JPEG-Datei sollte beispielsweise "title": "cat.jpg" in den Metadaten angegeben werden.

Nachfolgende GET-Anfragen enthalten die schreibgeschützte Property fileExtension, die mit der Erweiterung ausgefüllt ist, die ursprünglich in der Property title angegeben wurde. Wenn ein Google Drive-Nutzer den Download einer Datei anfordert oder die Datei über den Synchronisierungsclient heruntergeladen wird, erstellt Google Drive anhand des Titels einen vollständigen Dateinamen (mit Endung). Wenn die Erweiterung fehlt, versucht Google Drive, sie anhand des MIME-Typs der Datei zu ermitteln.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
convert

boolean

Ob diese Datei in das entsprechende Docs-Editoren-Format konvertiert werden soll.
enforceSingleParent
(deprecated)

boolean

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

boolean

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

string

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

boolean

Ob die Hauptversion der hochgeladenen Datei angepinnt werden soll. Eine Datei kann maximal 200 angepinnte Versionen haben.
supportsAllDrives

boolean

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

boolean

Verworfen. Verwenden Sie stattdessen supportsAllDrives.
timedTextLanguage

string

Die Sprache des synchronisierten Textes.
timedTextTrackName

string

Der Name des Zeitgeber-Texttracks.
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 mit reinen 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. Lade nur die Medien ohne Metadaten hoch.
  • multipart – Mehrteiliger Upload. Lade sowohl die Medien als auch die zugehörigen Metadaten in einer einzigen Anfrage hoch.
  • resumable – Fortsetzbarer Upload Laden Sie die Datei mit einer Reihe von mindestens zwei Anfragen hoch, wobei die erste Anfrage die Metadaten enthält.
useContentAsIndexableText

boolean

Gibt an, ob die Inhalte als indexierbarer Text verwendet werden sollen.
visibility

enum (Visibility)

Die Sichtbarkeit der neuen Datei. Dieser Parameter ist nur relevant, wenn „convert“ auf „false“ gesetzt ist.
includePermissionsForView

string

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

string

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

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