Tổng quan về API Google Tài liệu

API Google Tài liệu cho phép bạn tạo và sửa đổi tài liệu trong Google Tài liệu.

Các ứng dụng có thể tích hợp với API Tài liệu để tạo tài liệu hoàn chỉnh từ cả dữ liệu do người dùng và hệ thống cung cấp. API Tài liệu cho phép bạn:

  • Tự động hoá quy trình
  • Tạo tài liệu hàng loạt
  • Định dạng tài liệu
  • Tạo hoá đơn hoặc hợp đồng
  • Truy xuất các thuộc tính cụ thể của đối tượng

Sau đây là danh sách các thuật ngữ phổ biến được dùng trong API Tài liệu:

Mã số giấy tờ

Giá trị nhận dạng duy nhất của một tài liệu. Đây là một chuỗi cụ thể chứa chữ cái, số và một số ký tự đặc biệt tham chiếu đến một tài liệu và có thể được lấy từ URL của tài liệu. Mã tài liệu luôn ổn định, ngay cả khi tên tài liệu thay đổi. Để biết thêm thông tin về cách tìm mã nhận dạng, hãy xem phần Mã nhận dạng tài liệu.

https://docs.google.com/document/d/DOCUMENT_ID/edit
Phần tử

Cấu trúc tạo nên một tài liệu. Các phần tử cấp cao nhất của tài liệu bao gồm Body, DocumentStyle và List.

Tài liệu trên Google Workspace

Tệp mà một ứng dụng Google Workspace (chẳng hạn như Google Tài liệu) tạo ra. Định dạng loại MIME cho Tài liệu là application/vnd.google-apps.document. Để biết danh sách các loại MIME, hãy xem bài viết Các loại MIME được Google Workspace và Google Drive hỗ trợ.

Chỉ mục

Hầu hết phần tử trong phần nội dung đều có thuộc tính startIndex và endIndex. Các giá trị này cho biết độ dời của phần đầu và phần cuối của một phần tử, tương ứng với phần đầu của phân đoạn bao hàm phần tử đó.

Hình ảnh nội tuyến

Hình ảnh xuất hiện trong dòng văn bản của một tài liệu. Đây không phải là tệp đính kèm.

Dải ô được đặt tên

Một dải văn bản liền kề. NamedRange là một tập hợp các dải ô có cùng namedRangeId. Dải ô được đặt tên cho phép nhà phát triển liên kết các phần của tài liệu với một nhãn do người dùng xác định tuỳ ý để có thể đọc hoặc chỉnh sửa nội dung của các phần đó theo phương thức lập trình sau này. Một tài liệu có thể chứa nhiều dải ô được đặt tên có cùng tên, nhưng mỗi dải ô được đặt tên đều có mã nhận dạng duy nhất.

Segment

Body, Header, Footer hoặc Footnote chứa các phần tử cấu trúc hoặc nội dung. Chỉ mục của các phần tử trong một phân đoạn tương ứng với vị trí bắt đầu của phân đoạn đó.

Đề xuất

Nội dung thay đổi đối với một tài liệu mà không thay đổi văn bản gốc. Nếu chủ sở hữu chấp thuận đề xuất của bạn, nội dung đề xuất sẽ thay thế văn bản gốc.

  • Để tìm hiểu về cách phát triển bằng API Google Workspace, bao gồm cả việc xử lý xác thực và uỷ quyền, hãy tham khảo bài viết Phát triển trên Google Workspace.

  • Để biết thông tin tổng quan về khái niệm của một tài liệu, hãy xem phần Tài liệu.

  • Để tìm hiểu cách định cấu hình và chạy ứng dụng Docs API, hãy thử hướng dẫn nhanh về JavaScript.