Tworzenie dokumentów i zarządzanie nimi

Na tej stronie interfejsu Google Docs API opisaliśmy, jak wykonywać niektóre zadania na poziomie dokumentu dotyczące dokumentów Dokumentów Google, takie jak:

• Utwórz dokument
• Kopiowanie istniejącego dokumentu

W dalszej części artykułu znajdziesz szczegółowy opis tych zadań.

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 na 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 2 alternatywne sposoby zapisywania plików w folderze na Dysku:

• Po utworzeniu dokumentu przenieś go do określonego folderu za pomocą metody files.update interfejsu Drive API. Więcej informacji o przenoszeniu plików znajdziesz w artykule Przenoszenie plików między folderami.

• Dodaj pusty dokument do folderu, używając metody files.create interfejsu Drive API, podając application/vnd.google-apps.document jako mimeType. Więcej informacji o tworzeniu plików znajdziesz w artykule Tworzenie pliku w określonym folderze.

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

Informacje o tym, jak przenieść lub utworzyć plik w obrębie folderu dysku współdzielonego, znajdziesz w artykule Implementowanie 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 do użycia w wywołaniu interfejsu Drive API znajdziesz w adresie URL dokumentu. Więcej informacji znajdziesz w artykule Document 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(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.

Powiązane artykuły

• Wstawianie, usuwanie i przenoszenie tekstu
• Scalanie tekstu z dokumentem
• Pojęcia związane z dokumentami