Dokumente erstellen und verwalten

Auf dieser Google Docs API-Seite wird beschrieben, wie Sie bestimmte allgemeine Aufgaben mit Google Docs-Dokumenten ausführen, z. B.:

  • Dokument erstellen
  • Vorhandenes Dokument kopieren

In den folgenden Abschnitten werden diese Aufgaben ausführlich beschrieben.

Leeres Dokument erstellen

Verwenden Sie zum Erstellen eines Dokuments die Methode documents.create in der Sammlung documents.

Das folgende Codebeispiel zeigt, wie Sie ein leeres Dokument mit einem bestimmten Titel erstellen:

Java

private static void createDoc(Docs service) throws IOException {
    Document doc = new Document()
            .setTitle("My Document");
    doc = service.documents().create(doc)
            .execute();
    System.out.println("Created document with title: " + doc.getTitle());
}

PHP

$title = 'My Document';
$document = new Google_Service_Docs_Document(array(
    'title' => $title
));

$document = $service->documents->create($document);
printf("Created document with title: %s\n", $document->title);

Python

title = 'My Document'
body = {
    'title': title
}
doc = service.documents() \
    .create(body=body).execute()
print('Created document with title: {0}'.format(
    doc.get('title')))

Mit Google Drive-Ordnern arbeiten

Es gibt keine Möglichkeit, mit der Docs API ein Dokument direkt in einem bestimmten Drive-Ordner zu erstellen. Standardmäßig wird das erstellte Dokument im Stammordner des Nutzers auf Google Drive gespeichert.

Es gibt jedoch zwei Möglichkeiten, eine Datei in einem Drive-Ordner zu speichern:

  • Nachdem das Dokument erstellt wurde, können Sie es mit der Methode files.update der Drive API in einen bestimmten Ordner verschieben. Weitere Informationen zum Verschieben von Dateien finden Sie unter Dateien zwischen Ordnern verschieben.

  • Fügen Sie einem Ordner mit der Methode files.create der Drive API ein leeres Dokument hinzu und geben Sie application/vnd.google-apps.document als mimeType an. Weitere Informationen zum Erstellen von Dateien finden Sie unter Datei in einem bestimmten Ordner erstellen.

In beiden Fällen müssen Sie die entsprechenden Drive API-Bereiche hinzufügen, um den Aufruf zu autorisieren. Weitere Informationen zu Drive-Bereichen finden Sie unter Google Drive-API-Bereiche auswählen.

Informationen zum Verschieben oder Erstellen einer Datei in einem Ordner einer geteilten Ablage finden Sie unter Unterstützung für geteilte Ablagen implementieren.

Vorhandenes Dokument kopieren

Verwenden Sie zum Kopieren eines Dokuments die Methode files.copy der Drive API.

Das folgende Codebeispiel zeigt, wie Sie ein vorhandenes Dokument kopieren. Die ID, die für den Drive API-Aufruf verwendet werden soll, finden Sie in der Dokument-URL. Weitere Informationen finden Sie unter Dokument-ID.

https://docs.google.com/document/d/DOCUMENT_ID/edit

Java

String copyTitle = "Copy Title";
File copyMetadata = new File().setName(copyTitle);
File documentCopyFile =
        driveService.files().copy(documentId, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();

Node.js

var copyTitle = "Copy Title";
let request = {
  name: copyTitle,
};
this.driveService.files.copy({
  fileId: documentId,
  resource: request,
}, (err, driveResponse) => {
  let documentCopyId = driveResponse.id;
});

PHP

<?php
$copyTitle = 'Copy Title';
$copy = new Google_Service_Drive_DriveFile(array(
    'name' => $copyTitle
));
$driveResponse = $driveService->files->copy($documentId, $copy);
$documentCopyId = $driveResponse->id;

Python

copy_title = 'Copy Title'
body = {
    'name': copy_title
}
drive_response = drive_service.files().copy(
    fileId=document_id, body=body).execute()
document_copy_id = drive_response.get('id')

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.