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

SDK বা REST ব্যবহার করে ডেটা ম্যানেজার API-তে অ্যাক্সেস সেট আপ করার পদ্ধতি এখানে দেওয়া হলো।

পূর্বশর্ত

ডেটা এপিআই ব্যবহার করার আগে, নিশ্চিত করুন যে আপনার কাছে নিম্নলিখিত জিনিসগুলো রয়েছে:

1. একটি গুগল ক্লাউড প্রজেক্ট । আপনি একটি বিদ্যমান প্রজেক্ট ব্যবহার করতে পারেন অথবা ডেটা ম্যানেজার এপিআই-এর জন্য বিশেষভাবে একটি নতুন প্রজেক্ট তৈরি করতে পারেন।

2. এমন একটি গুগল অ্যাকাউন্ট যার আপনার গুগল ক্লাউড প্রজেক্টে serviceusage.services.enable পারমিশন আছে, অথবা এমন একটি রোল আছে যাতে এই পারমিশনটি অন্তর্ভুক্ত। উদাহরণস্বরূপ, roles/owner এবং roles/serviceusage.serviceUsageAdmin উভয়েরই serviceusage.services.enable পারমিশন রয়েছে। আপনার পারমিশনগুলো পরীক্ষা করতে, 'বর্তমান অ্যাক্সেস দেখুন' (View current access) দেখুন।

3. Google Cloud CLI ইনস্টল করা হয়েছে ।

এপিআই সক্রিয় করুন

যদি আগে থেকে না করে থাকেন, তাহলে ‘ডেটা ম্যানেজার এপিআই সক্ষম করুন’ (Enable the Data Manager API) বোতামে ক্লিক করে এটি সক্রিয় করুন অথবা এই ধাপটি ম্যানুয়ালি সম্পন্ন করতে নির্দেশাবলী অনুসরণ করুন।

ডেটা ম্যানেজার এপিআই সক্রিয় করুন

যদি আপনি ডেটা ম্যানেজার এপিআই খুঁজে না পান অথবা ডেটা ম্যানেজার এপিআই সক্রিয় করতে ব্যর্থ হন, তাহলে যাচাই করুন যে আপনার গুগল অ্যাকাউন্টটি পূর্বশর্তগুলো পূরণ করে।

প্রমাণীকরণ সেট আপ করুন

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

দুটি সাধারণ প্রমাণীকরণ পদ্ধতি হলো ব্যবহারকারী অ্যাকাউন্ট এবং পরিষেবা অ্যাকাউন্ট :

• ব্যবহারকারী অ্যাকাউন্ট : যারা সরাসরি গুগল এপিআই এবং পরিষেবাগুলো ব্যবহার করেন, তাদের প্রতিনিধিত্ব করে।
• সার্ভিস অ্যাকাউন্ট : এগুলি ব্যবহারকারী হিসেবে ব্যক্তিকে নয়, অ্যাপকে প্রতিনিধিত্ব করে। এগুলি আপনার অ্যাপকে অথেনটিকেশন এবং অথরাইজেশন পরিচালনা করতে দেয়। উদাহরণস্বরূপ, যদি কোনো অ্যাপের গুগল ক্লাউড রিসোর্স অ্যাক্সেস করার প্রয়োজন হয়।

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

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

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

ব্যবহারকারী অ্যাকাউন্টের তথ্য দিয়ে প্রমাণীকরণের ধাপগুলো নিচে দেওয়া হলো:

1. আপনার প্রোজেক্টের জন্য গুগল অথোরাইজেশন প্ল্যাটফর্মের সেটিংস কনফিগার করুন।

   গুরুত্বপূর্ণ: ডেটা ম্যানেজার এপিআই স্কোপের জন্য ব্যবহারকারীর ক্রেডেনশিয়াল পেতে ব্যবহৃত যেকোনো গুগল ক্লাউড অ্যাপকে অবশ্যই গুগল ওঅথ ভেরিফিকেশনের মধ্য দিয়ে যেতে হবে, যাতে ব্যবহারকারীদের জন্য একটি অযাচাইকৃত UI স্ক্রিন এড়ানো যায়। সার্ভিস অ্যাকাউন্টের জন্য গুগল ওঅথ ভেরিফিকেশনের প্রয়োজন নেই।

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

   2. আপনার প্রকল্পটি নির্বাচন করুন।

   3. ফর্মটি পূরণ করুন এবং তৈরি করুন-এ ক্লিক করুন।

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

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

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

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

   4. সংরক্ষণ করুন- এ ক্লিক করুন।

   5. Google Cloud Console-এর Audience- এ যান এবং Publishing status ও User type আপডেট করুন। Manage App Audience- এ এই সেটিংসগুলো সম্পর্কে আরও জানুন।

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

   আপনি যদি 'Create OAuth2 client'-এ ক্লিক করেন, তাহলে আপনার OAuth ক্লায়েন্ট কনফিগার করার জন্য অনুরোধ করা হলে 'Desktop app' নির্বাচন করুন, যাতে আপনি পরবর্তী ধাপগুলিতে ক্লায়েন্টটি ব্যবহার করতে পারেন।

   OAuth2 ক্লায়েন্ট তৈরি করুন

   শেষ ধাপে, 'DOWNLOAD CLIENT CONFIGURATION'-এ ক্লিক করুন এবং আপনার নির্বাচিত ডাউনলোড লোকেশনটি নোট করে রাখুন।

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

   PATH_TO_CLIENT_JSON জায়গায় আপনার ডাউনলোড করা 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"
   

   আপনি যদি ডেটা ম্যানেজার এপিআই এবং গুগল অ্যাডস এপিআই উভয়ের জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় গুগল অ্যাডস এপিআই স্কোপটি অন্তর্ভুক্ত করুন:

   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"
   

   আপনি যদি ডেটা ম্যানেজার এপিআই এবং ডিসপ্লে ও ভিডিও ৩৬০ এপিআই-এর জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় ডিসপ্লে ও ভিডিও ৩৬০ এপিআই স্কোপটি অন্তর্ভুক্ত করুন:

   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. একটি সার্ভিস অ্যাকাউন্ট নির্বাচন বা তৈরি করতে, নিচের 'Create service account' বোতামটি ক্লিক করুন অথবা নির্দেশাবলী অনুসরণ করুন।

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

2. সার্ভিস অ্যাকাউন্টটিকে সার্ভিস ইউসেজ কনজিউমার আইএএম রোল ( roles/serviceusage.serviceUsageConsumer ) প্রদান করুন, যার মধ্যে serviceusage.services.use পারমিশনটি অন্তর্ভুক্ত রয়েছে, যা সার্ভিস অ্যাকাউন্টটিকে প্রজেক্টের জন্য এপিআই রিকোয়েস্ট পাঠানোর অনুমতি দেয়।

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

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

   দ্রষ্টব্য: আপনার গুগল অ্যাকাউন্টটি প্রজেক্টটির মালিক হলেও এই ধাপটি আবশ্যক।

   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"
   

   আপনি যদি ডেটা ম্যানেজার এপিআই এবং গুগল অ্যাডস এপিআই উভয়ের জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় গুগল অ্যাডস এপিআই স্কোপটি অন্তর্ভুক্ত করুন:

   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"
   

   আপনি যদি ডেটা ম্যানেজার এপিআই এবং ডিসপ্লে ও ভিডিও ৩৬০ এপিআই-এর জন্য একই ক্রেডেনশিয়াল ব্যবহার করতে চান, তাহলে --scopes তালিকায় ডিসপ্লে ও ভিডিও ৩৬০ এপিআই স্কোপটি অন্তর্ভুক্ত করুন:

   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 অ্যাকাউন্ট দিয়ে লগইন করুন যেটিতে ‘Service Account Token Creator’ ভূমিকাটি রয়েছে।

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

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

দ্রষ্টব্য: ডেটা ম্যানেজার এপিআই-এর সকল পরিষেবার জন্য https://www.googleapis.com/auth/datamanager স্কোপটি আবশ্যক।

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

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

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

ব্যবহারকারীর সাথে যুক্ত ইমেলটিকে Destination প্রবেশের অনুমতি দিন।

• গুগল অ্যাডস অ্যাকাউন্ট ব্যবহার করলে, ব্যবহারকারীর ইমেলটি গুগল অ্যাডস অ্যাকাউন্টে বা মূল গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টে যুক্ত করার জন্য নির্দেশাবলী অনুসরণ করুন ।
• Display & Video 360 অ্যাকাউন্ট ব্যবহার করলে, অ্যাকাউন্টে ব্যবহারকারীর ইমেল যোগ করার জন্য নির্দেশাবলী অনুসরণ করুন ।
• গুগল অ্যানালিটিক্স প্রপার্টি ব্যবহার করলে, অ্যাকাউন্টে ব্যবহারকারীর ইমেল যোগ করার জন্য নির্দেশাবলী অনুসরণ করুন ।
• বিজ্ঞাপনদাতার অ্যাকাউন্ট থেকে পার্টনার লিঙ্কের মাধ্যমে ডেটা পার্টনার অ্যাকাউন্ট ব্যবহার করে Destination অ্যাক্সেস করার ক্ষেত্রে, ডেটা পার্টনার অ্যাকাউন্টে ব্যবহারকারীর ইমেল যোগ করার জন্য নির্দেশাবলী অনুসরণ করুন ।

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

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

• যদি গুগল অ্যাডস অ্যাকাউন্ট ব্যবহার করেন, তাহলে সার্ভিস অ্যাকাউন্টটিকে গুগল অ্যাডস অ্যাকাউন্ট বা প্যারেন্ট গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টে যুক্ত করতে অ্যাকাউন্ট অ্যাক্সেস সেটআপ সম্পন্ন করুন।
• Display & Video 360 অ্যাকাউন্ট ব্যবহার করলে, সার্ভিস অ্যাকাউন্টের সাথে যুক্ত একটি Display & Video 360 ইউজার তৈরি করার জন্য নির্দেশাবলী অনুসরণ করুন ।
• গুগল অ্যানালিটিক্স প্রপার্টি ব্যবহার করলে, অ্যাকাউন্টে ব্যবহারকারীর ইমেল যোগ করার জন্য নির্দেশাবলী অনুসরণ করুন ।
• বিজ্ঞাপনদাতা অ্যাকাউন্ট থেকে পার্টনার লিঙ্কের মাধ্যমে ডেটা পার্টনার অ্যাকাউন্ট ব্যবহার করে Destination অ্যাক্সেস করার ক্ষেত্রে, সার্ভিস অ্যাকাউন্টটি যোগ করতে এবং এর অ্যাক্সেস লেভেল সেট করতে ডেটা পার্টনার অ্যাকাউন্টে অ্যাকাউন্ট অ্যাক্সেস সেটআপ সম্পন্ন করুন।

পরবর্তী পদক্ষেপ

আপনার প্রথম ডেটা ম্যানেজার এপিআই অনুরোধটি চেষ্টা করার জন্য একটি ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন এবং কোড নমুনাগুলো চালান।