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

Here's how to set up access to the Data Manager API with an SDK or REST.

পূর্বশর্ত

1. A Google Cloud project or a Google Account that you want to own the project.

   • If you don't have a project , the setup process in the next section creates one for you.

   • আপনার যদি আগে থেকেই কোনো প্রজেক্ট থাকে , তাহলে নিশ্চিত করুন যে আপনার Google অ্যাকাউন্টের এমন একটি ভূমিকা (role) আছে যা প্রজেক্টটিতে API সক্রিয় করতে পারে, যেমন Owner , Editor , বা Service Usage Admin । আপনার ভূমিকা পরীক্ষা করতে, Google Cloud Console-এ IAM পৃষ্ঠাটি খুলুন, আপনার প্রজেক্টটি নির্বাচন করুন এবং তালিকা থেকে আপনার Google অ্যাকাউন্টটি খুঁজুন।

     আরও বিস্তারিত জানতে, বর্তমান প্রবেশাধিকার দেখুন।

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

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

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

পরামর্শ: আপনার যদি আগে থেকে কোনো গুগল ক্লাউড প্রজেক্ট না থাকে, তাহলে ‘ডেটা ম্যানেজার এপিআই সক্ষম করুন’ বিকল্পটি আপনার জন্য একটি তৈরি করে দেবে।

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

If you can't find the Data Manager API or Enable the Data Manager API fails, verify your Google Account meets the prerequisites .

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

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

Two common authentication methods are user accounts and service accounts :

• User accounts : Represent people who interact with Google APIs and services directly.
• Service accounts : Represent apps, not people, as the users. They let your apps manage authentication and authorization. For example, if an app needs to access Google Cloud resources.

Your integration can use Application Default Credentials (ADC) to automatically find credentials from the environment so you don't have to change the client code to authenticate.

Choose User account or Service account to set up ADC:

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

Here are the steps to authenticate with user account credentials :

1. Configure the Google Auth Platform settings for your project.

   Important: Any Google Cloud app used to obtain user credentials for the Data Manager API scope must eventually undergo Google OAuth verification to avoid an unverified UI screen for its users. During initial development and testing, you can use the app without verification by adding test users. For details on the verification process and production recommendations, see OAuth app verification . Verification isn't required for service accounts or certain other scenarios, such as internal applications. See When is verification not needed for details.

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

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

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

2. Since the Data Manager API scope is a sensitive scope , the following steps are required:

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

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

   3. Check the box next to Data Manager API in the list of scopes, and click Update .

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

   5. Go to Audience in the Google Cloud Console and configure the settings for initial development:

      • পাবলিশিং স্ট্যাটাস ' টেস্টিং' -এ সেট করুন।
      • Set User type to Internal (if your project is in a Google Workspace organization) or External (if it's not).
      • এক্সটার্নাল ব্যবহার করলে, ক্রেডেনশিয়াল তৈরি করতে ব্যবহৃত গুগল অ্যাকাউন্টগুলোকে টেস্ট ইউজার হিসেবে যুক্ত করুন।

      এই সেটিংসগুলো সম্পর্কে আরও জানতে Manage App Audience দেখুন।

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

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

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

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

4. Generate a local ADC file by running the following command. This command launches a web flow where you are prompted to login to the Google Account you're using with the API.

   Replace PATH_TO_CLIENT_JSON with name of the JSON file you downloaded.

   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"
   

   If you want to use the same credentials for the Data Manager API and the Google Ads API , include the Google Ads API scope in the --scopes list:

   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. Click the following Create service account button or follow the instructions to select or create a 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"
   

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

3. Grant your Google Account the Service Account Token Creator IAM role ( roles/iam.serviceAccountTokenCreator ) on the service account.

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

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

4. Configure your ADC by running the following command:

   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-এর প্রমাণীকরণ পদ্ধতি এবং অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল কীভাবে কাজ করে তা দেখুন।

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

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

আপনার ব্যবহারের ক্ষেত্রের সাথে সামঞ্জস্যপূর্ণ ট্যাবটি নির্বাচন করুন।

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

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

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

গুগল বিজ্ঞাপন

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

ডিসপ্লে এবং ভিডিও ৩৬০

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

গুগল অ্যানালিটিক্স

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

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

ব্যবহারকারীর সাথে যুক্ত ইমেলটিকে আপনার ডেটা পার্টনার অ্যাকাউন্টে অ্যাক্সেস দিন। সাধারণত, ডেটা পার্টনাররা এপিআই (API) অ্যাক্সেসের জন্য একটি সার্ভিস অ্যাকাউন্ট ব্যবহার করে। তবে, আপনি যদি টেস্টিং বা অন্য কোনো উদ্দেশ্যে ব্যবহারকারী অ্যাকাউন্ট ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার ব্যবহারকারী অ্যাকাউন্টটিকে ডেটা পার্টনার অ্যাকাউন্টে অ্যাক্সেস দিতে হবে।

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

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

আপনার ব্যবহারের ক্ষেত্রের সাথে সামঞ্জস্যপূর্ণ ট্যাবটি নির্বাচন করুন।

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

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

Grant the email associated with your service account access to the Destination .

গুগল বিজ্ঞাপন

সার্ভিস অ্যাকাউন্টটিকে গুগল অ্যাডস অ্যাকাউন্ট বা প্যারেন্ট গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টে যুক্ত করতে অ্যাকাউন্ট অ্যাক্সেস সেটআপ সম্পন্ন করুন।

ডিসপ্লে এবং ভিডিও ৩৬০

সার্ভিস অ্যাকাউন্টের সাথে যুক্ত একটি ডিসপ্লে ও ভিডিও ৩৬০ ইউজার তৈরি করতে নির্দেশাবলী অনুসরণ করুন ।

গুগল অ্যানালিটিক্স

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

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

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

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

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

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