Tạo và quản lý tài liệu

Trang API Google Tài liệu này mô tả cách thực hiện một số tác vụ cấp cao nhất định liên quan đến các tài liệu trong Google Tài liệu, chẳng hạn như:

  • Tạo một tài liệu
  • Sao chép tài liệu hiện có

Các đoạn sau đây mô tả chi tiết những việc cần làm này.

Tạo tài liệu trống

Để tạo tài liệu, hãy sử dụng Phương thức documents.create trên Bộ sưu tập documents.

Mã mẫu sau đây minh hoạ cách tạo một tài liệu trống bằng tiêu đề:

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

Làm việc với các thư mục trên Google Drive

Không thể tạo tài liệu trực tiếp trong một tệp đã chỉ định Thư mục Drive bằng API Tài liệu. Theo mặc định, tài liệu được tạo sẽ được lưu vào thư mục gốc của người dùng trên Drive.

Tuy nhiên, có hai lựa chọn thay thế để lưu tệp vào Drive thư mục:

  • Sau khi tạo tài liệu, hãy di chuyển tài liệu đó vào một thư mục cụ thể bằng cách sử dụng files.update của API Drive . Để biết thêm thông tin về việc di chuyển các tệp, hãy xem phần Di chuyển tệp giữa các thư mục.

  • Thêm tài liệu trống vào thư mục bằng API Drive Phương thức files.create, chỉ định application/vnd.google-apps.document làm mimeType. Để biết thêm về cách tạo tệp, hãy xem Tạo tệp trong thư mục.

Đối với một trong hai cách thay thế, bạn cần thêm API Drive thích hợp phạm vi để cấp phép cuộc gọi. Để biết thêm thông tin về phạm vi trên Drive, hãy xem phần Chọn Các phạm vi của API Google Drive.

Để di chuyển hoặc tạo một tệp trong thư mục bộ nhớ dùng chung, hãy xem phần Triển khai bộ nhớ dùng chung hỗ trợ Drive.

Sao chép tài liệu hiện có

Để sao chép tài liệu, hãy sử dụng API Drive Phương thức files.copy.

Mã mẫu sau đây cho biết cách sao chép một tài liệu hiện có. Bạn có thể tìm thấy mã nhận dạng để sử dụng cho lệnh gọi API Drive trong URL của tài liệu. Để biết thêm thông tin khác, xem ID tài liệu.

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

Lưu ý rằng bạn cần sử dụng API Drive thích hợp để cấp quyền cho . Để biết thêm thông tin về phạm vi trên Drive, hãy xem phần Chọn Các phạm vi của API Google Drive.