Wenn Sie eine Datei ohne Metadaten oder Inhalte erstellen möchten, verwenden Sie die Methode files.create
ohne Parameter.
Die Datei erhält einen kind
von drive.file
, einen id
, einen name
von "Untitled" und einen mimeType
von application/octet-stream
. Das uploadType
ist als erforderlich gekennzeichnet, verwendet aber standardmäßig media
, sodass Sie es nicht angeben müssen.
Weitere Informationen zu Beschränkungen für Drive-Dateien finden Sie unter Limits für Dateien und Ordner.
Dateien erstellen, die ausschließlich Metadaten enthalten
Dateien, die ausschließlich Metadaten enthalten, enthalten keine Inhalte. Metadaten sind Daten (z. B. name
, mimeType
und createdTime
), die die Datei beschreiben. Felder wie name
sind nutzerunabhängig und werden für jeden Nutzer gleich angezeigt, während Felder wie viewedByMeTime
nutzerspezifische Werte enthalten.
Ein Beispiel für eine Datei, die nur Metadaten enthält, ist ein Ordner mit dem MIME-Typ application/vnd.google-apps.folder
. Weitere Informationen finden Sie unter Ordner erstellen und ausfüllen. Ein weiteres Beispiel ist eine Verknüpfung, die auf eine andere Datei in Drive mit dem MIME-Typ application/vnd.google-apps.shortcut
verweist. Weitere Informationen finden Sie unter Verknüpfung für eine Drive-Datei erstellen.
Miniaturansichten hochladen
Drive erstellt automatisch Miniaturansichten für viele gängige Dateitypen wie Google Docs, Google Tabellen und Google Präsentationen. Anhand der Miniaturansichten können Nutzer Drive-Dateien leichter erkennen.
Für Dateitypen, für die Drive keine Standard-Miniaturansicht generieren kann, können Sie eine von Ihrer Anwendung generierte Miniaturansicht bereitstellen. Laden Sie beim Erstellen oder Aktualisieren einer Datei eine Miniaturansicht hoch. Legen Sie dazu das Feld contentHints.thumbnail
in der Ressource files
fest.
Insbesondere:
- Legen Sie im Feld
contentHints.thumbnail.image
die URL und den Dateinamen für ein base64-codiertes Bild fest (siehe RFC 4648, Abschnitt 5). - Legen Sie im Feld
contentHints.thumbnail.mimeType
den entsprechenden MIME-Typ für die Miniaturansicht fest.
Wenn Drive eine Miniaturansicht aus der Datei generieren kann, verwendet es die automatisch generierte und ignoriert diejenigen, die Sie möglicherweise hochgeladen haben. Wenn keine Miniaturansicht generiert werden kann, wird die von Ihnen angegebene verwendet.
Für Thumbnails gelten folgende Regeln:
- Sie können im PNG-, GIF- oder JPG-Format hochgeladen werden.
- Die empfohlene Breite beträgt 1.600 Pixel.
- Die Mindestbreite beträgt 220 Pixel.
- Die maximale Dateigröße beträgt 2 MB.
- Sie sollten von Ihrer Anwendung bei jedem Speichern aktualisiert werden.
Weitere Informationen finden Sie in der Ressource files
.
Weitere Informationen
Hier sind ein paar weitere Schritte, die Sie ausprobieren können:
Informationen zum Hochladen von Dateidaten beim Erstellen oder Aktualisieren einer Datei finden Sie unter Dateidaten hochladen.
Informationen zum Erstellen einer Datei in einem bestimmten Ordner finden Sie unter Datei in einem bestimmten Ordner erstellen.