Method: projects.databases.importDocuments

Google Cloud Firestore में दस्तावेज़ इंपोर्ट करता है. समान नाम वाले मौजूदा दस्तावेज़ों को ओवरराइट कर दिया जाता है. इंपोर्ट बैकग्राउंड में होता है और उसकी प्रोग्रेस को, बनाए गए ऑपरेशन संसाधन के ज़रिए मॉनिटर और मैनेज किया जा सकता है. अगर Databases.ImportDocuments की कार्रवाई रद्द कर दी जाती है, तो हो सकता है कि डेटा के किसी सबसेट को पहले ही Cloud Firestore में इंपोर्ट कर लिया गया हो.

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

POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:importDocuments

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. डेटाबेस जिसमें इंपोर्ट करना है. इसका फ़ॉर्मैट ऐसा होना चाहिए: projects/{projectId}/databases/{databaseId}.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
फ़ील्ड
collectionIds[]

string

कौनसे कलेक्शन आईडी इंपोर्ट करने हैं. वैल्यू सेट न होने का मतलब है कि इंपोर्ट में शामिल सभी कलेक्शन.

inputUriPrefix

string

एक्सपोर्ट की गई फ़ाइलों की जगह. यह किसी ऐसे एक्सपोर्ट के ExportDocumentsResponse के आउटपुटUriPrefix से मेल खाना चाहिए जो पूरी तरह पूरा हो चुका है. देखें: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix.

namespaceIds[]

string

एक खाली सूची सभी नेमस्पेस को दिखाती है. यह उन डेटाबेस के लिए पसंदीदा इस्तेमाल है जो नेमस्पेस का इस्तेमाल नहीं करते.

खाली स्ट्रिंग एलिमेंट, डिफ़ॉल्ट नेमस्पेस को दिखाता है. इसका इस्तेमाल तब किया जाना चाहिए, जब डेटाबेस में ऐसे नेमस्पेस में डेटा हो जो डिफ़ॉल्ट न हों, लेकिन उन्हें शामिल न करना चाहता हो. इस सूची में मौजूद हर नेमस्पेस यूनीक होना चाहिए.

जवाब का लेख

कामयाब होने पर, जवाब के मुख्य हिस्से में Operation का एक इंस्टेंस शामिल होता है.

अनुमति के दायरे

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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