Dateien erstellen und verwalten

In dieser Anleitung wird beschrieben, wie Sie Dateien in Google Drive erstellen und verwalten.

Datei erstellen

Verwenden Sie die Methode files.create ohne Parameter, um eine Datei in Drive zu erstellen, die keine Metadaten oder Inhalte enthält. Der Datei wird als kind der drive.file, der id, der name-Wert "Untitled" und der mimeType der application/octet-stream zugewiesen. uploadType ist als erforderlich gekennzeichnet, hat aber standardmäßig den Wert media. Sie müssen ihn also nicht angeben.

Weitere Informationen zu Dateilimits in Google Drive finden Sie unter Datei- und Ordnerlimits.

Dateien nur für Metadaten erstellen

Dateien, die nur Metadaten enthalten, enthalten keinen Inhalt. Metadaten sind Daten (z. B. name, mimeType und createdTime), die die Datei beschreiben. Felder wie name sind unabhängig vom Nutzer und werden für jeden Nutzer gleich angezeigt. Felder wie viewedByMeTime enthalten hingegen nutzerspezifische Werte.

Ein Beispiel für eine Datei mit reinen Metadaten ist ein Ordner mit dem MIME-Typ application/vnd.google-apps.folder. Weitere Informationen finden Sie unter Ordner erstellen und befü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 zu einer Drive-Datei erstellen.

Thumbnail-Bilder verwalten

Thumbnails helfen Nutzern, Drive-Dateien zu erkennen. Drive kann automatisch Thumbnails für gängige Dateitypen generieren. Sie können auch ein Thumbnail-Bild bereitstellen, das von Ihrer App generiert wurde. Weitere Informationen finden Sie unter Thumbnails hochladen.

Vorhandene Datei kopieren

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

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

Einschränkungen und Hinweise

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

  • Berechtigungen:

    • Die Dateieinschränkung copyRequiresWriterPermission bestimmt, wer die Datei kopieren kann. Weitere Informationen finden Sie unter Herunterladen, Drucken oder Kopieren von Dateien verhindern.
    • Das Feld capabilities/canCopy einer files-Ressource gibt an, ob der Nutzer eine Datei kopieren kann. Weitere Informationen finden Sie unter Funktionen.
    • Der Nutzer, der die Kopie erstellt hat, ist Inhaber der kopierten Datei. Es werden keine anderen Freigabeeinstellungen aus der Quelldatei repliziert. Wenn die Kopie in einem freigegebenen Ordner erstellt wird, werden die Berechtigungen dieses Ordners übernommen.
    • Die Eigentümerschaft einer kopierten Datei kann sich ändern und die Freigabeeinstellungen der ursprünglichen Datei werden möglicherweise nicht auf die Kopie angewendet. Möglicherweise müssen diese Einstellungen zurückgesetzt werden.

  • Dateiverwaltung:

    • Einige Dateien, z. B. Verknüpfungen von Drittanbietern, können nicht kopiert werden.
    • Sie können eine Datei nur in einen übergeordneten Ordner kopieren. Die Angabe mehrerer übergeordneter Elemente wird nicht unterstützt. Wenn das Feld parents nicht angegeben ist, übernimmt die Datei alle sichtbaren übergeordneten Elemente aus der Quelldatei.
    • Auch wenn ein Ordner ein Dateityp ist, können Sie ihn nicht kopieren. Erstellen Sie stattdessen einen Zielordner und legen Sie das Feld parents der vorhandenen Dateien auf den Zielordner fest. Sie können dann den ursprünglichen Quellordner löschen.
    • Sofern kein neuer Dateiname angegeben ist, erzeugt die Methode files.copy eine Datei mit demselben Namen wie das Original.
    • Eine übermäßige Nutzung von files.copy kann dazu führen, dass Sie Ihr Drive API-Kontingent überschreiten. Weitere Informationen finden Sie unter Nutzungslimits.

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