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

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

  • Tạo một tài liệu
  • Sao chép một 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 một 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 cho biết cách tạo một tài liệu trống có tiêu đề được chỉ định:

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 thư mục trên Google Drive

Không có lựa chọn nào để tạo tài liệu ngay trong một thư mục Drive cụ thể bằng cách sử dụ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, bạn có thể lưu tệp vào một thư mục trên Drive theo 2 cách sau:

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

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

Đối với cả hai lựa chọn thay thế, bạn cần thêm các phạm vi Drive API thích hợp để uỷ quyền cho lệnh gọi. Để biết thêm thông tin về các phạm vi của Drive, hãy xem bài viết Chọn phạm vi của Google Drive API.

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

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

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

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, hãy xem phần Mã nhận dạng 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')

Xin lưu ý rằng bạn cần sử dụng một phạm vi Drive API thích hợp để uỷ quyền cho lệnh gọi. Để biết thêm thông tin về các phạm vi của Drive, hãy xem bài viết Chọn phạm vi của Google Drive API.