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

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 निर्देश में gcloud निर्देश को सीधे Authorization हेडर में शामिल किया जा सकता है.

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

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