Method: projects.databases.documents.createDocument

Membuat dokumen baru.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib. Resource induk. Misalnya: projects/{projectId}/databases/{databaseId}/documents atau projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}

collectionId

string

Wajib. ID koleksi, yang terkait dengan parent, ke daftar. Contoh: chatrooms.

Parameter kueri

Parameter
documentId

string

ID dokumen yang ditetapkan klien untuk digunakan untuk dokumen ini.

Opsional. Jika tidak ditentukan, ID akan ditetapkan oleh layanan.

mask

object (DocumentMask)

Kolom yang akan ditampilkan. Jika tidak ditetapkan, semua kolom akan ditampilkan.

Jika dokumen memiliki kolom yang tidak ada dalam mask ini, kolom tersebut tidak akan ditampilkan dalam respons.

Isi permintaan

Isi permintaan memuat instance Document.

Isi respons

Jika berhasil, isi respons akan berisi instance Document.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.