На этой странице API Google Docs описывается, как выполнять определенные высокоуровневые задачи с документами Google Docs, например:
- Создать документ
- Копировать существующий документ
В следующих параграфах эти задачи описываются подробно.
Создать пустой документ
Чтобы создать документ, используйте метод documents.create
в коллекции documents
.
В следующем примере кода показано, как создать пустой документ с указанным заголовком:
Ява
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);
Питон
title = 'My Document' body = { 'title': title } doc = service.documents() \ .create(body=body).execute() print('Created document with title: {0}'.format( doc.get('title')))
Работа с папками Google Диска
Возможность создания документа непосредственно в указанной папке Диска с помощью API Документов отсутствует. По умолчанию созданный документ сохраняется в корневой папке пользователя на Диске.
Однако есть два альтернативных варианта сохранения файла в папке Диска:
После создания документа переместите его в определённую папку с помощью метода
files.update
API Диска. Подробнее о перемещении файлов см. в статье Перемещение файлов между папками .Добавьте пустой документ в папку с помощью метода
files.create
API Диска, указавapplication/vnd.google-apps.document
в качествеmimeType
. Подробнее о создании файлов см. в статье Создание файла в указанной папке .
В любом случае вам потребуется добавить соответствующие области действия API Диска для авторизации вызова. Подробнее об областях действия Диска см. в статье Выбор областей действия API Google Диска .
Чтобы переместить или создать файл в папке общего диска, см. раздел Реализация поддержки общего диска .
Копировать существующий документ
Чтобы скопировать документ, используйте метод files.copy
API Диска.
В следующем примере кода показано, как скопировать существующий документ. Идентификатор для вызова API Диска можно найти в URL-адресе документа. Подробнее см. в разделе Идентификатор документа .
https://docs.google.com/document/d/DOCUMENT_ID/edit
Ява
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;
Питон
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')
Обратите внимание, что для авторизации вызова необходимо использовать соответствующую область действия API Диска . Подробнее об областях действия Диска см. в статье Выбор областей действия API Google Диска .