Dateien erstellen und verwalten

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

Datei erstellen

Wenn Sie eine Datei in Drive erstellen möchten, die keine Metadaten oder Inhalte enthält, verwenden Sie die Methode files.create() ohne Parameter. Die Datei erhält die kind drive.file, die id, die name „Ohne Titel“ und die mimeType application/octet-stream. 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 mit Metadaten erstellen

Dateien, die nur Metadaten enthalten, enthalten keine Inhalte. 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:

    • Mit der Dateieinschränkung copyRequiresWriterPermission wird festgelegt, 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 Dateifunktionen.
    • Der Nutzer, der die Kopie erstellt hat, ist der 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 übernommen. Diese Einstellungen müssen möglicherweise 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, werden alle auffindbaren übergeordneten Elemente aus der Quelldatei übernommen.
    • 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 wird, wird mit der Methode files.copy() eine Datei mit demselben Namen wie das Original erstellt.
    • Eine übermäßige Nutzung von files.copy() kann dazu führen, dass Sie die Kontingentlimits der Drive API überschreiten. Weitere Informationen finden Sie unter Nutzungslimits.

Als Nächstes können Sie unter anderem Folgendes tun: