Tạo một tài liệu trống bằng tiêu đề đã cung cấp trong yêu cầu. Các trường khác trong yêu cầu (bao gồm cả mọi nội dung đã cung cấp) đều bị bỏ qua.
Trả về tài liệu đã tạo.
Yêu cầu HTTP
POST https://docs.googleapis.com/v1/documents
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu với cấu trúc như sau:
Biểu diễn dưới dạng JSON |
---|
{ "documentId": string, "title": string, "body": { object ( |
Các trường | |
---|---|
documentId |
Chỉ đầu ra. Mã nhận dạng tài liệu. |
title |
Tiêu đề tài liệu. |
body |
Chỉ đầu ra. Nội dung chính của tài liệu. |
headers |
Chỉ đầu ra. Các tiêu đề trong tài liệu, được khóa theo mã tiêu đề. |
footers |
Chỉ đầu ra. Các chân trang trong tài liệu, có mã là chân trang. |
footnotes |
Chỉ đầu ra. Chú thích cuối trang trong tài liệu, được đặt theo ID chú thích cuối trang. |
documentStyle |
Chỉ đầu ra. Kiểu tài liệu. |
suggestedDocumentStyleChanges |
Chỉ đầu ra. Các thay đổi được đề xuất đối với kiểu tài liệu, có mã đề xuất là chính. |
namedStyles |
Chỉ đầu ra. Các kiểu được đặt tên của tài liệu. |
suggestedNamedStylesChanges |
Chỉ đầu ra. Các thay đổi được đề xuất đối với kiểu được đặt tên của tài liệu, được xác định bằng ID đề xuất. |
lists |
Chỉ đầu ra. Các danh sách trong tài liệu, được sắp xếp theo mã danh sách. |
namedRanges |
Chỉ đầu ra. Dải ô được đặt tên trong tài liệu, được khóa theo tên. |
revisionId |
Chỉ đầu ra. ID sửa đổi của tài liệu. Có thể được sử dụng trong các yêu cầu cập nhật để chỉ định bản chỉnh sửa nào của tài liệu để áp dụng các bản cập nhật và cách xử lý yêu cầu nếu tài liệu đã được chỉnh sửa kể từ bản sửa đổi đó. Chỉ được điền sẵn nếu người dùng có quyền chỉnh sửa tài liệu. ID sửa đổi không phải là số thứ tự mà là một chuỗi mờ. Định dạng của ID sửa đổi có thể thay đổi theo thời gian. ID bản sửa đổi được trả lại chỉ được đảm bảo có hiệu lực trong 24 giờ sau khi được trả lại và không được chia sẻ cho người dùng. Nếu ID sửa đổi không thay đổi giữa các cuộc gọi thì tài liệu vẫn không thay đổi. Ngược lại, ID được thay đổi (cho cùng một tài liệu và người dùng) thường có nghĩa là tài liệu đã được cập nhật. Tuy nhiên, giấy tờ tùy thân đã thay đổi cũng có thể do các yếu tố nội bộ như thay đổi định dạng giấy tờ tùy thân. |
suggestionsViewMode |
Chỉ đầu ra. Chế độ xem đề xuất đã áp dụng cho tài liệu. Lưu ý: Khi chỉnh sửa tài liệu, các thay đổi phải dựa trên tài liệu có |
inlineObjects |
Chỉ đầu ra. Các đối tượng cùng dòng trong tài liệu, được xác định theo mã đối tượng. |
positionedObjects |
Chỉ đầu ra. Các đối tượng đã được định vị trong tài liệu, được xác định bằng mã đối tượng. |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản mới được tạo của Document
.
Phạm vi ủy quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Để biết thêm thông tin, hãy xem Hướng dẫn ủy quyền.