Method: projects.databases.documents.createDocument

नया दस्तावेज़ बनाता है.

एचटीटीपी अनुरोध

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

यह यूआरएल 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

ज़्यादा जानकारी के लिए, पुष्टि करने से जुड़ी खास जानकारी देखें.