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}.

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

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

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

string

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

string

एक्सपोर्ट की गई फ़ाइलों की जगह. यह सही से पूरा हो चुके किसी एक्सपोर्ट से एक्सपोर्ट किए गए ExportDocumentsResponse के reportUriPreFix से मेल खाना चाहिए. देखें: 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

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