Dokumente erstellen und verwalten

Auf dieser Google Docs API-Seite wird beschrieben, wie Sie bestimmte Aufgaben auf hoher Ebene im Zusammenhang mit Google Docs-Dokumenten ausführen, z. B.:

  • Dokument erstellen
  • Vorhandenes Dokument kopieren

In den folgenden Abschnitten werden diese Aufgaben im Detail beschrieben.

Leeres Dokument erstellen

Verwenden Sie die documents.create Methode für die documents Sammlung, um ein Dokument zu erstellen.

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());
}

Node.js

const title = 'My Document';
const resource = {
  title,
};
this.service.documents.create({
  resource,
}, (err, response) => {
  if (err) return console.log('The API returned an error: ' + err);
  console.log(`Created document with title: ${response.data.title}`);
});

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

Mit der Docs API können Sie kein Dokument direkt in einem bestimmten Drive-Ordner erstellen. Standardmäßig wird das erstellte Dokument im Stammordner des Nutzers in Drive gespeichert.

Es gibt jedoch zwei Alternativen, um eine Datei in einem Drive-Ordner zu speichern:

Für beide Alternativen 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 die Methode files.copy der Drive API, um ein Dokument zu kopieren.

Die Methode files.copy kann nicht verwendet werden, um ein veröffentlichtes Dokument zu kopieren. Weitere Informationen finden Sie unter Veröffentlichte Dokumente.

Das folgende Codebeispiel zeigt, wie Sie ein vorhandenes Dokument kopieren. Die ID für den Drive API-Aufruf 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(DOCUMENT_ID, copyMetadata).execute();
String documentCopyId = documentCopyFile.getId();

Node.js

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

PHP


$copyTitle = 'Copy Title';
$copy = new Google_Service_Drive_DriveFile(array(
    'name' => $copyTitle
));
$driveResponse = $driveService->files->copy(DOCUMENT_ID, $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.