প্রয়োজনীয় অনুরোধের পরামিতি

Maps Datasets API-তে যেকোনো অনুরোধ করতে হলে, আপনাকে অবশ্যই নিম্নলিখিত বিষয়গুলো অন্তর্ভুক্ত করতে হবে:

• অনুরোধের X-Goog-User-Project হেডারে থাকা আপনার গুগল ক্লাউড প্রজেক্টের নম্বর বা আইডি। এই মানটি বিলিং এবং ব্যবহারের কোটা গণনার জন্য ব্যবহৃত প্রজেক্ট নির্ধারণ করে।

  দ্রষ্টব্য: আপনি যদি প্রমাণীকরণের জন্য একটি সার্ভিস অ্যাকাউন্ট ব্যবহার করেন, তাহলে আপনি X-Goog-User-Project হেডারটি বাদ দিতে পারেন। সার্ভিস অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, Google-এ প্রমাণীকরণ দেখুন।

• অনুরোধের Authorization হেডারে একটি OAuth টোকেন থাকে। Maps Datasets API-এর সাথে OAuth ব্যবহার সম্পর্কে আরও তথ্যের জন্য, Use OAuth দেখুন।

• অনুরোধ URL-এ একটি গুগল ক্লাউড প্রজেক্ট নম্বর বা আইডি থাকে। এই মানটি ডেটাসেট ধারণকারী প্রজেক্টটিকে নির্দিষ্ট করে। যদিও এই প্রজেক্টটি সাধারণত X-Goog-User-Project হেডারে উল্লেখিত প্রজেক্টের মতোই হয়, তবে এটি একই হওয়া আবশ্যক নয়।

• রিকোয়েস্ট URL-এ ডেটাসেট আইডি। যখনই আপনি কোনো নির্দিষ্ট ডেটাসেটের উপর কোনো অ্যাকশন সম্পাদন করেন, তখন রিকোয়েস্ট URL-এর অংশ হিসেবে ডেটাসেটটির আইডি পাস করতে হয়।

দ্রষ্টব্য: কিছু অনুরোধের জন্য অতিরিক্ত প্যারামিটার প্রয়োজন হয়, যা সেই অনুরোধগুলোর ডকুমেন্টেশনে বর্ণনা করা আছে।

উদাহরণস্বরূপ, একটি ডেটাসেট মুছে ফেলতে:

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

প্রকল্প নম্বরটি নিন

আপনার গুগল ক্লাউড প্রজেক্টের PROJECT_NUMBER_OR_ID পেতে:

1. ক্লাউড কনসোলে প্রজেক্টটির ওভারভিউ পেজে যান।

2. অনুরোধ করা হলে, আপনার প্রজেক্টটি নির্বাচন করুন।

3. ওভারভিউ স্ক্রিনের প্রজেক্ট তথ্য অংশে প্রজেক্ট নম্বর এবং প্রজেক্ট আইডি দেখা যায়।

একটি OAuth টোকেন পান

দ্রষ্টব্য: OAuth টোকেন তৈরি করার জন্য নিচের পদ্ধতিটি প্রোডাকশন এনভায়রনমেন্টে ব্যবহারের জন্য নয়। এই পদ্ধতিটি শুধুমাত্র ডেভেলপমেন্ট বা টেস্টিং এনভায়রনমেন্টের জন্য ব্যবহার করুন।

প্রমাণীকরণের জন্য, আপনার API অনুরোধের Authorization হেডারে অবশ্যই একটি OAuth টোকেন থাকতে হবে। আরও জানতে, Use 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