Dateien erstellen

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.

Hier sind ein paar weitere Schritte, die Sie ausprobieren können: