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 চালু করুন

আপনি ডেটা ম্যানেজার API খুঁজে না পেলে বা ডেটা ম্যানেজার 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. ডেটা ম্যানেজার API সংবেদনশীল স্কোপ ব্যবহার করে বলে, নিম্নলিখিত ধাপগুলি অনুসরণ করতে হবে:

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

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

   3. স্কোপের তালিকায়, Data Manager API খুঁজে নিন এবং আপনার অ্যাপ্লিকেশনের প্রয়োজনীয় প্রতিটি স্কোপের বক্স চেক করুন:

      • .../auth/datamanager: গ্রাহকের ডেটা, দর্শক ও ইভেন্ট ম্যানেজ করার মতো স্ট্যান্ডার্ড API অপারেশনের জন্য এই স্কোপ বেছে নিন। এই গাইডে এই প্রাথমিক স্কোপ ব্যবহার করা হয়েছে।

      • .../auth/datamanager.partnerlink: আপনি যদি ডেটা পার্টনার হন এবং বিজ্ঞাপনদাতার অ্যাকাউন্টে পার্টনার লিঙ্ক তৈরি বা মুছে ফেলতে চান, তাহলে শুধুমাত্র এই স্কোপ বেছে নিন।

   4. আপডেট করুন বিকল্পে ক্লিক করুন।

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

   6. 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"
   

   আপনি যদি ডেটা ম্যানেজার 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"
   

   আপনি যদি ডেটা ম্যানেজার 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"
   

   আপনি যদি ডেটা ম্যানেজার 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"
   

মনে রাখবেন: স্কোপ https://www.googleapis.com/auth/datamanager হল প্রাথমিক স্কোপ এবং এটি Data Manager API-এর সব পরিষেবার জন্য কাজ করে। কম https://www.googleapis.com/auth/datamanager.partnerlink স্কোপ শুধুমাত্র পার্টনার লিঙ্ক ম্যানেজ করার জন্য ব্যবহার করা হয়।

আপনার অ্যাপের জন্য যাচাইকরণ ও ক্রেডেনশিয়াল সম্পর্কে আরও জানতে, 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 অনুরোধ করার জন্য ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন এবং কোড স্যাম্পেল রান করুন।
• আপনি প্রোডাকশনে ডেপ্লয় করার সময় কীভাবে যাচাইকরণ কনফিগার করবেন তা জানুন।