Method: projects.databases.documents.createDocument

Tạo một tài liệu mới.

Yêu cầu HTTP

POST https://firestore.googleapis.com/v1/{parent=projects/*/databases/*/documents/**}/{collectionId}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Tài nguyên mẹ. Ví dụ: projects/{projectId}/databases/{databaseId}/documents hoặc projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}
collectionId

string

Bắt buộc. Mã bộ sưu tập (tương ứng với parent) trong danh sách. Ví dụ: chatrooms.

Tham số truy vấn

Tham số
documentId

string

Mã tài liệu do khách hàng chỉ định để sử dụng cho tài liệu này.

Không bắt buộc. Nếu không chỉ định, dịch vụ sẽ chỉ định một mã nhận dạng.
mask

object (DocumentMask)

Các trường cần trả về. Nếu không được đặt, hàm sẽ trả về tất cả các trường.

Nếu tài liệu có một trường không xuất hiện trong mặt nạ này, thì trường đó sẽ không được trả về trong phản hồi.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Document.

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 của Document.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem bài viết Tổng quan về hoạt động xác thực.