На этой странице API Документов Google описывается, как выполнять определенные задачи высокого уровня, связанные с документами Документов Google, например:
- Создать документ
- Копирование существующего документа
В следующих параграфах эти задачи описаны подробно.
Создать пустой документ
Чтобы создать документ, используйте метод 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
Drive API. Дополнительную информацию о перемещении файлов см. в разделе Перемещение файлов между папками .Добавьте пустой документ в папку с помощью метода
files.create
Drive API, указавapplication/vnd.google-apps.document
в качествеmimeType
. Дополнительную информацию о создании файлов см. в разделе Создание файла в определенной папке .
В любом случае вам потребуется добавить соответствующие области Drive API для авторизации вызова. Дополнительную информацию об областях действия Диска см. в разделе Выбор областей действия API Google Диска .
Чтобы переместить или создать файл в папке общего диска, см. раздел Реализация поддержки общего диска .
Копирование существующего документа
Чтобы скопировать документ, используйте метод files.copy
Drive API.
В следующем примере кода показано, как скопировать существующий документ. Идентификатор, который будет использоваться для вызова Drive 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')
Обратите внимание, что для авторизации вызова вам необходимо использовать соответствующую область Drive API . Дополнительную информацию об областях действия Диска см. в разделе Выбор областей действия API Google Диска .