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

Maps डेटासेट एपीआई को कोई अनुरोध करने के लिए, आपको ये चीज़ें शामिल करनी होंगी:

• अनुरोध के 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

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

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

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