Tworzenie dokumentów i zarządzanie nimi

Na tej stronie interfejsu Google Docs API znajdziesz opis wykonywania niektórych zadań wysokiego poziomu związanych z dokumentami Google, takich jak:

  • Utwórz dokument
  • Kopiowanie istniejącego dokumentu

Szczegółowe opisy tych zadań znajdziesz w kolejnych akapitach.

Tworzenie pustego dokumentu

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 na Dysku Google

Interfejs Docs API nie umożliwia tworzenia dokumentu bezpośrednio w określonym folderze na Dysku. Domyślnie utworzony dokument jest zapisywany w folderze głównym użytkownika na Dysku.

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

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

Informacje o przenoszeniu i tworzeniu plików w folderze dysku współdzielonego znajdziesz w artykule Wdrażanie obsługi dysków współdzielonych.

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, którego należy użyć do wywołania interfejsu Drive API, znajdziesz w adresie URL dokumentu. Więcej informacji znajdziesz w sekcji 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 do autoryzacji wywołania musisz użyć odpowiedniego zakresu interfejsu Drive API. Więcej informacji o zakresach Dysku znajdziesz w artykule Wybieranie zakresów interfejsu Google Drive API.