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

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

আপনি যে ধরনের সেটআপ প্রক্রিয়া অনুসরণ করতে চান তা বেছে নিন।

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

বিজ্ঞাপনদাতার ডেটা অংশীদার

পূর্বশর্ত

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

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

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

3. The Google Cloud CLI installed .

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

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

Enable the Data Manager API

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

Set up authentication

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

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

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

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

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

User account Service account impersonation

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

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

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

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

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

   3. Fill out the form and click Create .

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

   1. Go to the Data Access settings for your project.

   2. Click Add or remove scopes .

   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' নির্বাচন করুন, যাতে আপনি পরবর্তী ধাপগুলিতে ক্লায়েন্টটি ব্যবহার করতে পারেন।

   Create OAuth2 client

   শেষ ধাপে, '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
   

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

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

Set up account access

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

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

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

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