Method: projects.databases.documents.createDocument

Tạo 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

Thông 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, so với parent, so với danh sách. Ví dụ: chatrooms.

Tham số truy vấn

Thông 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 bạn không chỉ định, dịch vụ sẽ gán một mã nhận dạng.
mask	object (DocumentMask) Các trường cần trả về. Nếu bạn không đặt chính sách này, hệ thống sẽ trả về tất cả các trường. Nếu tài liệu có một trường không có 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

Phần nội dung yêu cầu chứa một thực thể 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 thực thể của Document.

Phạm vi uỷ quyền

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

• 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ề việc xác thực.