Fügt eine neue Datei ein.
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.insert
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 title
angeben. Beispielsweise sollte bei einem Vorgang zum Einfügen einer JPEG-Datei in den Metadaten "title": "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/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 | |
---|---|
uploadType |
Der Typ der Uploadanfrage an den URI Akzeptable Werte sind:
|
convert |
Gibt an, ob diese Datei in das entsprechende Docs-Editoren-Format konvertiert werden soll. |
enforceSingleParent |
Eingestellt: Das Erstellen von Dateien in mehreren Ordnern wird nicht mehr unterstützt. |
ocr |
Gibt an, ob die optische Zeichenerkennung bei Uploads im JPG-, PNG-, GIF- oder PDF-Format durchgeführt werden soll. |
ocrLanguage |
Falls „ocr“ auf „true“ gesetzt ist, wird die zu verwendende Sprache angegeben. Gültige Werte sind BCP 47-Codes. |
pinned |
Gibt an, ob die Hauptversion der hochgeladenen Datei angepinnt werden soll. Eine Datei kann maximal 200 angepinnte Überarbeitungen enthalten. |
supportsAllDrives |
Gibt an, ob die Anwendung, die die Anfrage stellt, sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. |
supportsTeamDrives |
Eingestellt: Verwende stattdessen |
timedTextLanguage |
Die Sprache des zeitgesteuerten Textes. |
timedTextTrackName |
Der Name des zeitgesteuerten Text-Tracks. |
useContentAsIndexableText |
Gibt an, ob der Inhalt als indexierbaren Text verwendet werden soll. |
visibility |
Die Sichtbarkeit der neuen Datei. Dieser Parameter ist nur relevant, wenn „convert=false“ verwendet wird. |
includePermissionsForView |
Gibt an, welche zusätzlichen Ansichtsberechtigungen in der Antwort enthalten sein sollen. Nur |
includeLabels |
Eine durch Kommas getrennte Liste mit IDs von Labels, die in den |
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.