ज़रूरी अनुरोध पैरामीटर

Maps Datasets API से कोई अनुरोध करने के लिए, आपको ये शामिल करने होंगे:

• अनुरोध के X-Goog-User-Project हेडर में आपके Google Cloud प्रोजेक्ट का नंबर या आईडी. यह वैल्यू, बिलिंग और इस्तेमाल के कोटे का हिसाब लगाने के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट को तय करती है.

  ध्यान दें: अगर पुष्टि करने के लिए किसी सेवा खाते का इस्तेमाल किया जा रहा है, तो X-Goog-User-Project हेडर को छोड़ा जा सकता है. सेवा खातों के बारे में ज़्यादा जानकारी के लिए, Google पर पुष्टि करने की प्रक्रिया देखें.

• अनुरोध के Authorization हेडर में मौजूद OAuth टोकन. Maps Datasets API के साथ OAuth का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, OAuth का इस्तेमाल करना लेख पढ़ें.

• अनुरोध के यूआरएल में Google Cloud प्रोजेक्ट नंबर या आईडी. इस वैल्यू से उस प्रोजेक्ट के बारे में पता चलता है जिसमें डेटासेट मौजूद है. आम तौर पर, यह प्रोजेक्ट X-Goog-User-Project हेडर में बताए गए प्रोजेक्ट जैसा ही होता है. हालांकि, इसका एक जैसा होना ज़रूरी नहीं है.

• अनुरोध के यूआरएल में मौजूद डेटासेट आईडी. जब भी किसी खास डेटासेट पर कोई कार्रवाई की जाती है, तो अनुरोध के यूआरएल के हिस्से के तौर पर डेटासेट का आईडी पास किया जाता है.

ध्यान दें: कुछ अनुरोधों के लिए अतिरिक्त पैरामीटर की ज़रूरत होती है. इनके बारे में उन अनुरोधों के दस्तावेज़ में बताया गया है.

उदाहरण के लिए, किसी डेटासेट को मिटाने के लिए:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

प्रोजेक्ट नंबर पाना

अपने Google Cloud प्रोजेक्ट का PROJECT_NUMBER_OR_ID पाने के लिए:

1. Cloud Console में, प्रोजेक्ट के होम पेज पर जाएं.

2. अगर कहा जाए, तो अपना प्रोजेक्ट चुनें.

3. प्रोजेक्ट नंबर और प्रोजेक्ट आईडी, खास जानकारी वाली स्क्रीन के प्रोजेक्ट की जानकारी सेक्शन में दिखते हैं.

OAuth टोकन पाना

ध्यान दें: OAuth टोकन जनरेट करने के लिए, यहां दी गई प्रोसेस का इस्तेमाल प्रोडक्शन एनवायरमेंट में नहीं किया जाना चाहिए. इस तरीके का इस्तेमाल सिर्फ़ डेवलपमेंट या टेस्टिंग एनवायरमेंट के लिए करें.

पुष्टि करने के लिए, आपके एपीआई अनुरोध के Authorization हेडर में OAuth टोकन होना चाहिए. ज़्यादा जानने के लिए, OAuth का इस्तेमाल करना लेख पढ़ें.

उदाहरण के लिए, टोकन जनरेट करने के लिए, इस gcloud कमांड का इस्तेमाल करें:

gcloud auth application-default print-access-token

हर अनुरोध पर नया टोकन जनरेट करने के लिए, cURL कमांड में Authorization हेडर में सीधे gcloud कमांड को शामिल किया जा सकता है. इसके बारे में ऊपर दिए गए उदाहरण में बताया गया है.

इसके अलावा, टोकन वाला एनवायरमेंट वैरिएबल सेट किया जा सकता है. इसके बाद, अनुरोध के हिस्से के तौर पर एनवायरमेंट वैरिएबल को पास किया जा सकता है:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID