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

Maps Datas API को कोई भी अनुरोध करने के लिए आपको यह जानकारी शामिल करनी होगी:

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

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

• अनुरोध के Authorization हेडर में OAuth टोकन मौजूद है. Maps Datas 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