Dateien erstellen und verwalten

In diesem Leitfaden wird beschrieben, wie Sie Dateien in Google Drive mit der Google Drive API 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. Der Datei wird ein kind von drive.file, ein id, ein name von „Unbenannt“ und ein mimeType von application/octet-stream zugewiesen. Die uploadType ist als erforderlich gekennzeichnet, wird aber standardmäßig auf media gesetzt. Sie müssen sie also nicht angeben.

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

Nur Metadaten enthaltende Dateien erstellen

Dateien, die nur Metadaten enthalten, haben keinen Inhalt. 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 mit Inhalten fü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 identifizieren. Drive kann automatisch Thumbnails für gängige Dateitypen generieren. Sie können aber auch ein von Ihrer App generiertes Thumbnailbild bereitstellen. Weitere Informationen finden Sie unter Thumbnails 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 fileId zu finden, die Sie kopieren möchten.

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 Überlegungen

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

  • Berechtigungen:

    • Das DownloadRestrictionsMetadata-Objekt der files-Ressource bestimmt, wer die Datei kopieren kann. Weitere Informationen finden Sie unter Herunterladen, Drucken oder Kopieren von Dateien verhindern.
    • Die Ressourcen des Felds capabilities.canCopy legen fest, 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. Andere Freigabeeinstellungen der Quelldatei werden nicht 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 Kopie erbt möglicherweise nicht die Freigabeeinstellungen der Originaldatei. Möglicherweise müssen diese Einstellungen zurückgesetzt werden.

  • Dateiverwaltung:

    • Einige Dateien, z. B. Drittanbieter-Verknüpfungen, können nie 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, erbt die Datei alle auffindbaren übergeordneten Elemente aus der Quelldatei.
    • Obwohl ein Ordner eine Art von Datei ist, können Sie keinen Ordner kopieren. Erstellen Sie stattdessen einen Zielordner und legen Sie das Feld parents der vorhandenen Dateien auf den Zielordner fest. Anschließend können Sie den ursprünglichen Quellordner löschen.
    • Sofern kein neuer Dateiname angegeben wird, wird mit der Methode files.copy eine Datei mit demselben Namen wie die Originaldatei erstellt.
    • Eine übermäßige Nutzung von files.copy kann dazu führen, dass Sie Ihre Drive API-Kontingentlimits überschreiten. Weitere Informationen finden Sie unter Nutzungslimits.

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