Tworzenie dokumentów i zarządzanie nimi

Na tej stronie interfejsu API Dokumentów Google opisujemy, jak wykonywać ogólne zadania dotyczące dokumentów Dokumentów Google, takie jak:

  • Utwórz dokument
  • Kopiowanie istniejącego dokumentu

W kolejnych akapitach opisano 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 o określonym tytule:

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

Nie można utworzyć dokumentu bezpośrednio w określonym folderze Dysku za pomocą interfejsu API Dokumentów. Domyślnie utworzony dokument jest zapisywany w folderze głównym użytkownika na Dysku.

Istnieją jednak dwie możliwości zapisania pliku w folderze na Dysku:

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

Informacje o tym, jak przenieść lub utworzyć plik w obrębie folderu 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 użyty do wywołania interfejsu 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 do autoryzacji wywołania musisz użyć odpowiedniego zakresu interfejsu Drive API. Więcej informacji o zakresach dotyczących Dysku znajdziesz w artykule Wybieranie zakresów interfejsów API Dysku Google.