Method: projects.databases.documents.createDocument

ينشئ مستندًا جديدًا.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
parent

string

مطلوبة. المورد الرئيسي. على سبيل المثال: السمة projects/{projectId}/databases/{databaseId}/documents أو السمة projects/{projectId}/databases/{databaseId}/documents/chatrooms/{chatroom_id}
collectionId

string

مطلوبة. رقم تعريف المجموعة المرتبط بـ parent في القائمة مثلاً: chatrooms

معلمات طلب البحث

المَعلمات
documentId

string

رقم تعريف المستند الذي عيّنه العميل لاستخدامه في هذا المستند.

اختياريّ. في حال عدم تحديد ذلك، ستعيّن الخدمة معرّفًا.
mask

object (DocumentMask)

الحقول المطلوب عرضها. وفي حال تم ترك السياسة بدون ضبط، سيتم عرض جميع الحقول.

إذا كان المستند يحتوي على حقل غير متوفّر في هذا القناع، لن يتم عرض هذا الحقل في الاستجابة.

نص الطلب

يحتوي نص الطلب على مثال Document.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Document.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.