Tworzenie dokumentów i zarządzanie nimi

Na tej stronie interfejsu API Dokumentów Google opisano, jak wykonywać określone ogólne zadania związane z dokumentami Google, takie jak:

  • Utwórz dokument
  • Kopiowanie istniejącego dokumentu

W poniższych akapitach opisano te zadania szczegółowo.

Utwórz pusty dokument

Aby utworzyć dokument, użyj metody documents.create w kolekcji documents.

Poniższy przykładowy kod pokazuje, jak utworzyć pusty dokument z określonym tytułem:

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')))

Praca z folderami Dysku Google

Za pomocą interfejsu API Dokumentów nie można utworzyć dokumentu bezpośrednio w określonym folderze na Dysku. Utworzony dokument domyślnie jest zapisywany w folderze głównym użytkownika na Dysku.

Istnieją jednak 2 alternatywne sposoby zapisu pliku w folderze na Dysku:

W obu przypadkach musisz dodać odpowiednie zakresy interfejsu Drive API, aby autoryzować wywołanie. Więcej informacji o zakresach interfejsu Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.

Informacje o tym, jak przenieść lub utworzyć plik w folderze na dysku współdzielonym, znajdziesz w artykule Implementowanie obsługi dysku współdzielonego.

Kopiowanie istniejącego dokumentu

Aby skopiować dokument, użyj metody files.copy interfejsu Drive API.

Poniższy przykładowy kod pokazuje, jak skopiować istniejący dokument. Identyfikator używany przez interfejs Drive API znajdziesz w adresie URL dokumentu. Więcej informacji znajdziesz w artykule Identyfikator dokumentu.

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')

Pamiętaj, że aby autoryzować wywołanie, musisz użyć odpowiedniego zakresu interfejsu Drive API. Więcej informacji o zakresach interfejsu Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.