Dateien erstellen und verwalten

In diesem Leitfaden erfahren Sie, wie Sie Dateien in Google Drive erstellen und verwalten.

Datei erstellen

Wenn Sie in Drive 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. uploadType ist als erforderlich gekennzeichnet, wird aber standardmäßig auf media gesetzt, sodass Sie sie 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 verwalten

Anhand von Miniaturansichten können Nutzer Drive-Dateien leichter erkennen. Drive kann automatisch Miniaturansichten für gängige Dateitypen erstellen oder eine von Ihrer Anwendung generierte Miniaturansicht bereitstellen. Weitere Informationen finden Sie unter Miniaturansichten hochladen.

Vorhandene Datei kopieren

Verwenden Sie die Methode files.copy, um eine Datei zu kopieren und alle angeforderten Aktualisierungen anzuwenden. Verwenden Sie die Methode files.list, um die zu kopierende fileId zu finden.

Sie müssen einen entsprechenden Drive API-Bereich verwenden, um den Aufruf zu autorisieren. Weitere Informationen zu Drive-Bereichen finden Sie unter Google Drive-API-Bereiche auswählen.

Limits und Überlegungen

Beachten Sie beim Kopieren von Dateien die folgenden Einschränkungen und Hinweise:

  • Berechtigungen:

    • Mit der Dateieinschränkung copyRequiresWriterPermission wird festgelegt, wer die Datei kopieren darf. Weitere Informationen finden Sie unter Verhindern, dass Nutzer Dateien herunterladen, drucken oder kopieren.
    • Mit dem Feld capabilities/canCopy einer files-Ressource wird festgelegt, ob der Nutzer eine Datei kopieren kann. Weitere Informationen finden Sie unter Funktionen.
    • Der Nutzer, der die Kopie erstellt hat, ist Eigentümer der kopierten Datei. Es werden keine anderen Freigabeeinstellungen aus der Quelldatei repliziert. Wenn die Kopie in einem freigegebenen Ordner erstellt wird, übernimmt sie die Berechtigungen dieses Ordners.
    • Die Eigentümerschaft einer kopierten Datei kann sich ändern und die Freigabeeinstellungen der Originaldatei werden möglicherweise nicht übernommen. Diese Einstellungen müssen möglicherweise zurückgesetzt werden.

  • Dateiverwaltung:

    • Einige Dateien, wie z. B. Verknüpfungen von Drittanbietern, können nicht kopiert werden.
    • Sie können eine Datei nur in einen übergeordneten Ordner kopieren. Es können nicht mehrere übergeordnete Elemente angegeben werden. Wenn das Feld parents nicht angegeben ist, übernimmt die Datei alle erkennbaren übergeordneten Elemente aus der Quelldatei.
    • Ordner sind zwar ein Dateityp, Sie können sie aber nicht kopieren. Erstellen Sie stattdessen einen Zielordner und legen Sie für das Feld parents der vorhandenen Dateien den Zielordner fest. Anschließend können Sie den ursprünglichen Quellordner löschen.
    • Sofern kein neuer Dateiname angegeben ist, erzeugt die Methode files.copy eine Datei mit dem gleichen Namen wie das Original.
    • Die übermäßige Nutzung von files.copy kann zur Überschreitung Ihres Kontingentlimits für die Drive API führen. Weitere Informationen finden Sie unter Nutzungslimits.

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