API অ্যাক্সেস সেট-আপ করা

SDK বা REST-এর মাধ্যমে Data Manager API-তে অ্যাক্সেস কীভাবে সেট-আপ করবেন তা এখানে দেওয়া হল।

পূর্বশর্ত

1. Google Cloud প্রোজেক্ট অথবা Google অ্যাকাউন্ট যার মালিকানা আপনি পেতে চান।

   • আপনার কোনও প্রোজেক্ট না থাকলে, পরবর্তী বিভাগে সেট-আপ প্রসেস আপনার জন্য একটি তৈরি করে।

   • আপনার আগে থেকেই কোনও প্রোজেক্ট থাকলে, আপনার Google অ্যাকাউন্টে এমন ভূমিকা আছে কিনা তা নিশ্চিত করুন যা প্রোজেক্টে API চালু করতে পারে, যেমন মালিক, এডিটর, বা পরিষেবা ব্যবহার অ্যাডমিন। আপনার ভূমিকা চেক করতে, Google Cloud কনসোলে IAM পৃষ্ঠা খুলুন, আপনার প্রোজেক্ট বেছে নিন এবং তালিকায় আপনার Google অ্যাকাউন্ট খুঁজুন।

     আরও বিবরণের জন্য, বর্তমান অ্যাক্সেস দেখুন।

2. Google Cloud CLI ইনস্টল করা আছে।

API চালু করুন

আপনি আগে থেকে না করে থাকলে, আপনার Google Cloud প্রোজেক্টে Data Manager API চালু করুন বিকল্পে ক্লিক করে অথবা এই ধাপটি ম্যানুয়ালি সম্পূর্ণ করতে নির্দেশাবলী ফলো করে Data Manager API চালু করুন।

পরামর্শ: আপনার আগে থেকে কোনও Google Cloud প্রোজেক্ট না থাকলে, Data Manager API চালু করলে আপনার জন্য একটি তৈরি হয়ে যাবে।

Data Manager API চালু করুন

আপনি Data Manager API খুঁজে না পেলে অথবা Data Manager API চালু করতে না পারলে, আপনার Google অ্যাকাউন্ট পূর্বশর্ত পূরণ করছে কিনা তা যাচাই করুন।

যাচাইকরণ সেট-আপ করা

API কী ছাড়াও, আপনি Google-এ যাচাইকরণের পদ্ধতি ব্যবহার করতে পারবেন। আপনার ব্যবহারের ক্ষেত্রে কোন পদ্ধতি উপযুক্ত হবে তা ঠিক করতে, কীভাবে আপনার ব্যবহারের ক্ষেত্রে সঠিক যাচাইকরণ পদ্ধতি বেছে নিতে হয় তা পর্যালোচনা করে দেখার জন্য আমরা সুপারিশ করি।

দুটি সাধারণ যাচাইকরণ পদ্ধতি হল ব্যবহারকারীর অ্যাকাউন্ট ও পরিষেবার অ্যাকাউন্ট:

• ব্যবহারকারীর অ্যাকাউন্ট: এমন লোকজনকে বোঝায় যারা সরাসরি Google API ও পরিষেবার সাথে ইন্টার‍্যাক্ট করেন।
• পরিষেবা অ্যাকাউন্ট: ব্যবহারকারী হিসেবে কোনও অ্যাপকে প্রতিনিধিত্ব করে, কোনও ব্যক্তিকে নয়। এগুলি আপনার অ্যাপকে যাচাইকরণ ও অনুমোদন ম্যানেজ করতে দেয়। যেমন, কোনও অ্যাপকে Google Cloud রিসোর্স অ্যাক্সেস করতে হলে।

আপনার ইন্টিগ্রেশন অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল (ADC) ব্যবহার করে পরিবেশ থেকে অটোমেটিক ক্রেডেনশিয়াল খুঁজে নিতে পারে, ফলে আপনাকে যাচাইকরণের জন্য ক্লায়েন্ট কোড পরিবর্তন করতে হবে না।

ADC সেট-আপ করতে ব্যবহারকারীর অ্যাকাউন্ট বা পরিষেবা অ্যাকাউন্ট বেছে নিন:

ব্যবহারকারীর অ্যাকাউন্ট

ব্যবহারকারীর অ্যাকাউন্ট ক্রেডেনশিয়াল ব্যবহার করে যাচাই করার ধাপগুলি এখানে দেওয়া হল:

1. আপনার প্রোজেক্টের জন্য Google Auth প্ল্যাটফর্ম সেটিংস কনফিগার করুন।

   গুরুত্বপূর্ণ: ডেটা ম্যানেজার API স্কোপের জন্য ব্যবহারকারীর ক্রেডেনশিয়াল পাওয়ার জন্য ব্যবহৃত যেকোনও Google Cloud অ্যাপকে অবশ্যই Google OAuth যাচাইকরণ প্রক্রিয়ার মধ্য দিয়ে যেতে হবে, যাতে ব্যবহারকারীদের যাচাই না করা UI স্ক্রিন দেখানো না হয়। প্রাথমিক ডেভেলপমেন্ট ও টেস্টিংয়ের সময়, আপনি টেস্ট ব্যবহারকারী যোগ করে যাচাইকরণ ছাড়াই অ্যাপ ব্যবহার করতে পারবেন। যাচাইকরণ প্রক্রিয়া ও প্রোডাকশন সংক্রান্ত পরামর্শের বিস্তারিত জানতে, OAuth অ্যাপ যাচাইকরণ লিঙ্ক দেখুন। পরিষেবা অ্যাকাউন্ট বা অভ্যন্তরীণ অ্যাপ্লিকেশনের মতো নির্দিষ্ট কিছু ক্ষেত্রে যাচাইকরণ প্রয়োজন হয় না। বিবরণের জন্য কখন যাচাইকরণ করার প্রয়োজন হয় না দেখুন।

   1. Google Cloud কনসোলে ব্র্যান্ডিং পৃষ্ঠা খুলুন।

   2. আপনার প্রোজেক্ট বেছে নিন।

   3. ফর্ম পূরণ করে তৈরি করুন বিকল্পে ক্লিক করুন।

2. যেহেতু Data Manager API স্কোপ একটি সংবেদনশীল স্কোপ, তাই নিম্নলিখিত ধাপগুলি প্রয়োজন:

   1. আপনার প্রোজেক্টের ডেটা অ্যাক্সেস সেটিংসে যান।

   2. স্কোপ যোগ করুন বা সরিয়ে দিন বিকল্পে ক্লিক করুন।

   3. স্কোপের তালিকায় Data Manager API-এর পাশে থাকা বক্সে টিকচিহ্ন দিন এবং আপডেট করুন বিকল্পে ক্লিক করুন।

   4. সেভ করুন বিকল্পে ক্লিক করুন।

   5. Google Cloud Console-এ গিয়ে দর্শক বিকল্পে যান এবং প্রাথমিক ডেভেলপমেন্টের জন্য সেটিংস কনফিগার করুন:

      • প্রকাশনার স্ট্যাটাস টেস্টিং হিসেবে সেট করুন।
      • ব্যবহারকারীর ধরন অভ্যন্তরীণ (আপনার প্রোজেক্ট কোনও Google Workspace সংস্থার মধ্যে থাকলে) অথবা বাহ্যিক (না থাকলে) হিসেবে সেট করুন।
      • এক্সটার্নাল ব্যবহার করলে, টেস্ট ব্যবহারকারী হিসেবে ক্রেডেনশিয়াল তৈরি করতে আপনার ব্যবহার করা Google অ্যাকাউন্ট যোগ করুন।

      অ্যাপের দর্শক ম্যানেজ করুন থেকে এইসব সেটিংস সম্পর্কে আরও জানুন।

3. প্রোজেক্টে OAuth2 ক্লায়েন্ট তৈরি করতে, OAuth2 ক্লায়েন্ট তৈরি করুন বিকল্পে ক্লিক করুন অথবা ডেস্কটপ OAuth2 ক্লায়েন্ট তৈরি করতে নির্দেশাবলী অনুসরণ করুন। আপনার কাছে যদি আগে থেকেই ডেস্কটপ OAuth2 ক্লায়েন্ট থাকে এবং আপনি সেটি Data Manager API-এর জন্য ব্যবহার করতে চান, তাহলে এই ধাপটি এড়িয়ে যেতে পারেন।

   আপনি OAuth2 ক্লায়েন্ট তৈরি করুন বিকল্পে ক্লিক করলে, আপনার OAuth ক্লায়েন্ট কনফিগার করুন প্রম্পট করা হলে ডেস্কটপ অ্যাপ বিকল্প বেছে নিন, যাতে আপনি বাকি ধাপগুলিতে ক্লায়েন্ট ব্যবহার করতে পারেন।

   মনে রাখবেন: আপনি যদি একজন ডেটা পার্টনার হন এবং পার্টনার লিঙ্ক তৈরি করার জন্য বিজ্ঞাপনদাতার কাছ থেকে ক্রেডেনশিয়াল পাওয়ার জন্য বিশেষভাবে OAuth ক্লায়েন্ট চান, তাহলে আপনার OAuth ক্লায়েন্ট কনফিগার করুন প্রম্পট করা হলে ওয়েব সার্ভার বা ওয়েব ব্রাউজার বেছে নিন এবং বিজ্ঞাপনদাতার অ্যাকাউন্টের জন্য ক্রেডেনশিয়াল পান নির্দেশাবলী অনুসরণ করুন।
   OAuth2 ক্লায়েন্ট তৈরি করুন

   শেষ ধাপে, ক্লায়েন্ট কনফিগারেশন ডাউনলোড করুন বিকল্পে ক্লিক করুন এবং আপনার বেছে নেওয়া ডাউনলোড লোকেশনটি মনে রাখুন।

4. নিম্নলিখিত কমান্ড চালিয়ে একটি লোকাল ADC ফাইল তৈরি করুন। এই কমান্ড একটি ওয়েব ফ্লো লঞ্চ করে যেখানে আপনাকে API-এর সাথে ব্যবহার করা Google অ্যাকাউন্টে লগ-ইন করার জন্য প্রম্পট করা হয়।

   আপনি ডাউনলোড করেছেন এমন JSON ফাইলের নাম দিয়ে PATH_TO_CLIENT_JSON পরিবর্তন করুন।

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   আপনি যদি Data Manager API এবং Google Ads API-এর জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় Google Ads API স্কোপ অন্তর্ভুক্ত করুন:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

   আপনি যদি Data Manager API এবং Display & Video 360 API-এর জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় Display & Video 360 API স্কোপ অন্তর্ভুক্ত করুন:

   gcloud auth application-default login \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
     --client-id-file="PATH_TO_CLIENT_JSON"
   

5. নিচের কমান্ড ব্যবহার করে কনফার্ম করুন যে ক্রেডেনশিয়াল সঠিকভাবে সেট-আপ করা হয়েছে। সফল হলে, কমান্ডটি কনসোলে একটি অ্যাক্সেস টোকেন প্রিন্ট করে।

   gcloud auth application-default print-access-token
   

সার্ভিস অ্যাকাউন্ট

স্থানীয় ডেভেলপমেন্ট এনভায়রনমেন্টে যাচাই করার জন্য পরিষেবা অ্যাকাউন্ট তৈরি করা এবং পরিষেবা অ্যাকাউন্ট ইমপার্সোনেশন ব্যবহার করার ধাপগুলি এখানে দেওয়া হল। এইসব ধাপে পরিষেবা অ্যাকাউন্ট কীয়ের পরিবর্তে ছদ্মবেশ ব্যবহার করা হয় কারণ পরিষেবা অ্যাকাউন্ট কী সাবধানে ম্যানেজ না করলে নিরাপত্তা সংক্রান্ত ঝুঁকি তৈরি হতে পারে।

1. নিচে দেওয়া পরিষেবা অ্যাকাউন্ট তৈরি করুন বোতামে ক্লিক করুন অথবা পরিষেবা অ্যাকাউন্ট বেছে নিতে বা তৈরি করতে নির্দেশাবলী অনুসরণ করুন।

   পরিষেবা অ্যাকাউন্ট তৈরি করুন

2. সার্ভিস অ্যাকাউন্টকে পরিষেবা ব্যবহার সংক্রান্ত গ্রাহক IAM রোল (roles/serviceusage.serviceUsageConsumer) দিন, যার মধ্যে serviceusage.services.use অনুমতি অন্তর্ভুক্ত থাকে যা প্রোজেক্টের জন্য API অনুরোধ পাঠাতে সার্ভিস অ্যাকাউন্টকে অনুমতি দেয়।

   gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/serviceusage.serviceUsageConsumer"
   

   পরামর্শ: আপনি যদি Google Cloud রিসোর্সে (যেমন, Compute Engine VM, Cloud Run বা GKE) আপনার কোড রান করাচ্ছেন, তাহলে ছদ্মবেশীতার বাকি ধাপগুলি এড়িয়ে যেতে পারবেন। এর পরিবর্তে, পরিষেবা অ্যাকাউন্টটি সরাসরি রিসোর্সের সাথে অ্যাটাচ করুন এবং অ্যাকাউন্ট অ্যাক্সেস সেট-আপ করুন।

3. পরিষেবা অ্যাকাউন্টে আপনার Google অ্যাকাউন্টকে পরিষেবা অ্যাকাউন্ট টোকেন ক্রিয়েটর IAM রোল (roles/iam.serviceAccountTokenCreator) দিন।

   মনে রাখবেন: আপনার Google অ্যাকাউন্ট কোনও প্রোজেক্টের মালিক হলেও এই ধাপটি প্রয়োজন।

   gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
     --member="user:USER_EMAIL" \
     --role="roles/iam.serviceAccountTokenCreator"
   

4. নিম্নলিখিত কমান্ড রান করে আপনার ADC কনফিগার করুন:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"
   

   আপনি যদি Data Manager API এবং Google Ads API-এর জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় Google Ads API স্কোপ অন্তর্ভুক্ত করুন:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"
   

   আপনি যদি Data Manager API এবং Display & Video 360 API-এর জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় Display & Video 360 API স্কোপ অন্তর্ভুক্ত করুন:

   gcloud auth application-default login \
     --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
     --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"
   

   সাইন-ইন করার জন্য প্রম্পট করা হলে, আপনার সেই Google অ্যাকাউন্ট দিয়ে লগ-ইন করুন যেটির পরিষেবা অ্যাকাউন্ট টোকেন ক্রিয়েটর ভূমিকা আছে।

5. নিচের কমান্ড ব্যবহার করে কনফার্ম করুন যে ক্রেডেনশিয়াল সঠিকভাবে সেট-আপ করা হয়েছে। সফল হলে, কমান্ডটি কনসোলে একটি অ্যাক্সেস টোকেন প্রিন্ট করে।

   gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"
   

মনে রাখবেন: Data Manager API-এর সব পরিষেবার জন্য স্কোপ https://www.googleapis.com/auth/datamanager প্রয়োজন।

আপনার অ্যাপের জন্য যাচাইকরণ ও ক্রেডেনশিয়াল সম্পর্কে আরও জানতে, Google-এ যাচাইকরণ পদ্ধতি এবং অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল কীভাবে কাজ করে দেখুন।

অ্যাকাউন্ট অ্যাক্সেস সেট-আপ করা

ব্যবহারকারীর অ্যাকাউন্ট

আপনার ব্যবহারের ক্ষেত্রে প্রযোজ্য ট্যাবটি বেছে নিন।

• আপনি যদি এমন Google অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করেন যা আপনি ম্যানেজ করতে চান এমন বিজ্ঞাপনদাতার অ্যাকাউন্টের ব্যবহারকারী, তাহলে বিজ্ঞাপনদাতা বিকল্প বেছে নিন।
• আপনি যদি এমন Google অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করেন যা ডেটা পার্টনার অ্যাকাউন্টের ব্যবহারকারী এবং আপনি যদি এমন বিজ্ঞাপনদাতার অ্যাকাউন্ট ম্যানেজ করতে চান যেটির ডেটা পার্টনার অ্যাকাউন্টের সাথে পার্টনার লিঙ্ক আছে, তাহলে ডেটা পার্টনার বিকল্প বেছে নিন। অনুমোদন প্রক্রিয়া সম্পূর্ণ হওয়ার পরেই ডেটা পার্টনার অ্যাকাউন্ট ইস্যু করা হয়। শুরু করতে, আগ্রহের ফর্ম পূরণ করুন।

বিজ্ঞাপনদাতা

ব্যবহারকারীর সাথে যুক্ত ইমেল আইডিকে Destination-এর অ্যাক্সেস দিন।

Google Ads

Google Ads অ্যাকাউন্ট বা কোনও মূল Google Ads ম্যানেজার অ্যাকাউন্টে ব্যবহারকারীর ইমেল আইডি যোগ করতে নির্দেশাবলী অনুসরণ করুন।

Display & Video 360

অ্যাকাউন্টে ব্যবহারকারীর ইমেল আইডি যোগ করতে নির্দেশাবলী অনুসরণ করুন।

Google Analytics

অ্যাকাউন্টে ব্যবহারকারীর ইমেল আইডি যোগ করতে নির্দেশাবলী অনুসরণ করুন।

ডেটা পার্টনার

আপনার ডেটা পার্টনার অ্যাকাউন্টে ব্যবহারকারীর অ্যাক্সেস আছে এমন ইমেল আইডিকে অ্যাক্সেস দিন। সাধারণত, ডেটা পার্টনাররা API অ্যাক্সেস করার জন্য পরিষেবা অ্যাকাউন্ট ব্যবহার করেন। তবে, আপনি যদি পরীক্ষা বা অন্য কোনও উদ্দেশ্যে ব্যবহারকারীর অ্যাকাউন্ট ব্যবহার করেন, তাহলে আপনাকে অবশ্যই ডেটা পার্টনার অ্যাকাউন্টে আপনার ব্যবহারকারীর অ্যাকাউন্টের অ্যাক্সেস দিতে হবে।

Google Ads UI-এর মাধ্যমে ডেটা পার্টনার অ্যাকাউন্টে ব্যবহারকারীর ইমেল আইডি যোগ করুন এইসব নির্দেশাবলী অনুসরণ করে।

সার্ভিস অ্যাকাউন্ট

আপনার ব্যবহারের ক্ষেত্রে প্রযোজ্য ট্যাবটি বেছে নিন।

• আপনি যদি এমন Google অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করেন যা আপনি ম্যানেজ করতে চান এমন বিজ্ঞাপনদাতার অ্যাকাউন্টের ব্যবহারকারী, তাহলে বিজ্ঞাপনদাতা বিকল্প বেছে নিন।
• আপনি যদি এমন Google অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করেন যা ডেটা পার্টনার অ্যাকাউন্টের ব্যবহারকারী এবং আপনি যদি এমন বিজ্ঞাপনদাতার অ্যাকাউন্ট ম্যানেজ করতে চান যেটির ডেটা পার্টনার অ্যাকাউন্টের সাথে পার্টনার লিঙ্ক আছে, তাহলে ডেটা পার্টনার বিকল্প বেছে নিন। অনুমোদন প্রক্রিয়া সম্পূর্ণ হওয়ার পরেই ডেটা পার্টনার অ্যাকাউন্ট ইস্যু করা হয়। শুরু করতে, আগ্রহের ফর্ম পূরণ করুন।

বিজ্ঞাপনদাতা

আপনার পরিষেবা অ্যাকাউন্টের সাথে যুক্ত ইমেল আইডিকে Destination-এর অ্যাক্সেস দিন।

Google Ads

Google Ads অ্যাকাউন্ট বা পেরেন্ট Google Ads ম্যানেজার অ্যাকাউন্টে পরিষেবা অ্যাকাউন্ট যোগ করতে, অ্যাকাউন্ট অ্যাক্সেস সেট-আপ সম্পূর্ণ করুন।

Display & Video 360

Display & Video 360 ব্যবহারকারী তৈরি করতে নির্দেশাবলী অনুসরণ করুন যা পরিষেবা অ্যাকাউন্টের সাথে যুক্ত।

Google Analytics

অ্যাকাউন্টে পরিষেবা অ্যাকাউন্টের ইমেল আইডি যোগ করতে নির্দেশাবলী অনুসরণ করুন।

ডেটা পার্টনার

আপনার পরিষেবা অ্যাকাউন্টের সাথে যুক্ত ইমেল আইডিকে আপনার ডেটা পার্টনার অ্যাকাউন্টে অ্যাক্সেস দিন।

Google Ads UI-এর মাধ্যমে ডেটা পার্টনার অ্যাকাউন্ট অ্যাক্সেস ম্যানেজ করা হয়। পরিষেবা অ্যাকাউন্ট যোগ করতে এবং এর অ্যাক্সেস লেভেল সেট করতে, অ্যাকাউন্ট অ্যাক্সেস সেট-আপ লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।

পরবর্তী ধাপ

• আপনার প্রথম ডেটা ম্যানেজার API অনুরোধ করে দেখতে কোড স্যাম্পেল রান করুন এবং ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
• আপনি প্রোডাকশনে ডেপ্লয় করলে কীভাবে যাচাইকরণ কনফিগার করবেন তা জানুন।