Tworzenie dokumentów i zarządzanie nimi

Na tej stronie interfejsu Google Docs API znajdziesz informacje o tym, jak wykonywać niektóre zadania wysokiego poziomu związane z dokumentami Google, takie jak:

  • Utwórz dokument
  • Kopiowanie istniejącego dokumentu

W kolejnych akapitach opisujemy te zadania szczegółowo.

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

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

Praca z folderami na Dysku Google

Interfejs API Dokumentów 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 aby autoryzować wywołanie, musisz użyć odpowiedniego zakresu interfejsu Drive API. Więcej informacji o zakresach Dysku znajdziesz w artykule Wybieranie zakresów interfejsu Google Drive API.