ক্লাউড-পরিচালিত অ্যাক্সেস লেভেল

দ্রষ্টব্য: গুগল এই প্রোগ্রামের জন্য আবেদন গ্রহণ করছে। নিবন্ধন করুন ।

এই ফিচারের মাধ্যমে একটি গুগল ক্লাউড অর্গানাইজেশন আপনার এপিআই অ্যাক্সেস লেভেল পরিচালনা করতে পারে, যা আপনাকে নিম্নলিখিত সুবিধাগুলো প্রদান করে:

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

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

• আরও সূক্ষ্ম কোটা পর্যবেক্ষণ ও ব্যবস্থাপনা : আপনি স্বতন্ত্র প্রোজেক্টের এপিআই ব্যবহার পর্যবেক্ষণ করতে পারেন অথবা এপিআই ব্যবহারের সীমা নির্ধারণ করতে পারেন ।

পূর্বশর্ত

• একটি অনুমোদিত ডেভেলপার টোকেন

  এই বিকল্পটি ব্যবহার করার জন্য আপনার কাছে আগে থেকেই একটি অনুমোদিত ডেভেলপার টোকেন থাকা উচিত। আপনি আপনার Google Ads ম্যানেজার অ্যাকাউন্টের API সেন্টারে একটি বিদ্যমান ডেভেলপার টোকেন খুঁজে পেতে পারেন। সাইন ইন করুন , তারপর Admin > API center-এ যান। API সেন্টারের ভেতরে, API Access > Developer token-এ যান।

• একটি গুগল ক্লাউড সংস্থা

  গুগল অ্যাডস এপিআই আপনার ডেভেলপার টোকেনকে একটি গুগল ক্লাউড অর্গানাইজেশনের সাথে যুক্ত করে এবং এটি ব্যবহার করে আপনার এপিআই অ্যাক্সেস লেভেল নির্ধারণ করে। গুগল ক্লাউড অর্গানাইজেশন তৈরি করার একাধিক উপায় রয়েছে।

  দৃশ্যকল্প	পদক্ষেপ
  আপনি একজন বিদ্যমান Google Workspace বা Google Cloud Identity গ্রাহক।	সম্ভবত আপনার ইতিমধ্যেই একটি সাংগঠনিক সম্পদ রয়েছে। আপনি যাচাই করে দেখতে পারেন এবং প্রয়োজন হলে একটি তৈরি করে নিতে পারেন ।
  আপনি গুগল ওয়ার্কস্পেস বা গুগল ক্লাউড আইডেন্টিটি ব্যবহার করেন না।	Google Cloud Identity-এর বিনামূল্যের সংস্করণের জন্য সাইন আপ করুন। তারপর আপনার প্রতিষ্ঠানের রিসোর্স তৈরি করুন ।
  পূর্ববর্তী বিকল্পগুলির কোনোটিই আপনার জন্য কাজ করে না।	পাইলট প্রোগ্রামের জন্য সাইন আপ করার সময় আপনার পরিস্থিতি ব্যাখ্যা করুন এবং আপনার জন্য একটি অর্গানাইজেশন রিসোর্স তৈরি করতে গুগলকে অনুরোধ করুন। গুগল কোনো চার্জ ছাড়াই এই অর্গানাইজেশন রিসোর্সটির মালিকানা ও ব্যবস্থাপনা করবে।

• পাইলট প্রোগ্রামের জন্য আপনার গুগল এপিআই কনসোল প্রজেক্টগুলো প্রস্তুত করুন।

  পাইলট প্রোগ্রামের জন্য গুগল অ্যাডস এপিআই (Google Ads API)-এর সাথে ব্যবহৃত গুগল এপিআই কনসোল (Google API Console) প্রজেক্টগুলো আপনাকে নিম্নরূপভাবে প্রস্তুত করতে হবে:

  দৃশ্যকল্প	পদক্ষেপ
  আপনার আগে থেকেই একটি গুগল ক্লাউড অর্গানাইজেশন আছে অথবা আপনি পূর্ববর্তী ধাপে একটি তৈরি করেছেন।	নিশ্চিত করুন যে, গুগল এপিআই কনসোলের যে সমস্ত প্রোজেক্টে আপনি গুগল অ্যাডস এপিআই সক্রিয় করেছেন, সেগুলি এই অর্গানাইজেশনের অধীনে রয়েছে। যদি তা না থাকে, তবে সেটিকে এই অর্গানাইজেশনের অধীনে মাইগ্রেট করুন । আপনি যদি Google Workspace বা Google Cloud Identity-এর একজন বিদ্যমান গ্রাহক হন, তাহলে সম্ভবত Google API Console প্রজেক্টগুলো ইতিমধ্যেই আপনার প্রতিষ্ঠানের অধীনে রয়েছে, তাই আপনি এই ধাপটি এড়িয়ে যেতে পারেন।
  আপনার কোনো গুগল ক্লাউড অর্গানাইজেশন নেই এবং আপনি আগের ধাপে একটি তৈরি করতে পারেননি।	নিশ্চিত করুন যে আপনি আপনার গুগল অ্যাডস এপিআই ম্যানেজার অ্যাকাউন্ট এবং গুগল এপিআই কনসোল প্রজেক্ট, উভয় ক্ষেত্রেই একজন অ্যাডমিনিস্ট্রেটর ইউজার। আপনার পাইলট অ্যাপ্লিকেশনটি অনুমোদিত হওয়ার পর অতিরিক্ত পদক্ষেপগুলো সম্পন্ন করার জন্য এই অনুমতির প্রয়োজন হবে।

• একটি হালনাগাদ এপিআই যোগাযোগের ইমেল

  আপনার Google Ads API যোগাযোগের ইমেলটি হালনাগাদ আছে কিনা তা নিশ্চিত করুন। আপনার API যোগাযোগের বিবরণ আপনার Google Ads API ম্যানেজার অ্যাকাউন্টের API সেন্টার পৃষ্ঠায় তালিকাভুক্ত আছে। সাইন ইন করুন , তারপর TOOLS & SETTINGS > SETUP > API Center- এ যান।

পাইলট প্রোগ্রামের জন্য নিবন্ধন করুন

পাইলট প্রোগ্রামের জন্য সাইন আপ করুন । গুগল কমপ্লায়েন্স টিম আপনার আবেদনটি পর্যালোচনা করবে এবং অনুমোদনের অবস্থা ও অতিরিক্ত বিবরণসহ আপনার এপিআই যোগাযোগের ইমেল ঠিকানায় একটি ইমেল পাঠাবে।

আপনি যদি গুগলকে আপনার জন্য একটি গুগল ক্লাউড অর্গানাইজেশন তৈরি করতে অনুরোধ করে থাকেন, তাহলে এর সাথে আরও কয়েকটি অতিরিক্ত ধাপ জড়িত রয়েছে:

1. গুগল আপনার জন্য একটি গুগল-মালিকানাধীন ক্লাউড অর্গানাইজেশন রিসোর্স তৈরি করবে। আপনার গুগল অ্যাডস এপিআই ম্যানেজার অ্যাকাউন্টের সকল অ্যাডমিনিস্ট্রেটরকে নতুন তৈরি হওয়া অর্গানাইজেশনটিতে roles/resourcemanager.projectCreator রোলটি প্রদান করা হবে।

2. গুগল আপনার এপিআই কন্টাক্ট ইমেল অ্যাড্রেসে নতুন তৈরি হওয়া অর্গানাইজেশন রিসোর্সের বিবরণসহ একটি ইমেল পাঠাবে।

3. আপনার Google API Console প্রজেক্টটিকে নতুন অর্গানাইজেশনের অধীনে স্থানান্তর করতে , আপনাকে অবশ্যই আপনার Google API Console অ্যাকাউন্টে সাইন ইন করতে হবে এবং নির্দেশাবলী অনুসরণ করতে হবে।

4. আপনার প্রজেক্টগুলো নতুন সংস্থার অধীনে স্থানান্তরিত হয়েছে, তা গুগলকে জানাতে ইমেইলের উত্তর দিন।

5. গুগল কমপ্লায়েন্স টিম আপনার আবেদনটি পর্যালোচনা করবে এবং অনুমোদনের অবস্থা ও অতিরিক্ত বিবরণসহ আপনার এপিআই যোগাযোগের ইমেল ঠিকানায় একটি ইমেল পাঠাবে।

আপনার API অনুরোধগুলি পরিবর্তন করুন

এপিআই কল করার সময় developer-token হেডার পাঠানো বন্ধ করতে আপনি আপনার অ্যাপটি পরিবর্তন করতে পারেন। এটি একটি ঐচ্ছিক কিন্তু প্রস্তাবিত পদক্ষেপ। আপনি যদি পাইলট প্রোগ্রামে থাকেন, তাহলে এপিআই অনুরোধের অংশ হিসেবে developer-token পাঠানো হলে গুগল অ্যাডস এপিআই সার্ভার তা উপেক্ষা করে।

জাভা

শীঘ্রই আসছে!

.NET

Google Ads API .NET লাইব্রেরির 17.1.0 বা তার নতুন সংস্করণটি ডাউনলোড ও ইনস্টল করুন।

এরপর, আপনার কোডটি নিম্নরূপভাবে পরিবর্তন করুন:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

পিএইচপি

শীঘ্রই আসছে!

পাইথন

শীঘ্রই আসছে!

রুবি

শীঘ্রই আসছে!

পার্ল

শীঘ্রই আসছে!

HTTP ক্লায়েন্ট (REST)

আপনার HTTP অনুরোধগুলিতে developer-token হেডারটি বাদ দিন:

curl -i -X POST https://googleads.googleapis.com/v24/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী

ক্লাউড-পরিচালিত অ্যাক্সেস লেভেল সম্পর্কে প্রায়শই জিজ্ঞাসিত কিছু প্রশ্ন এখানে দেওয়া হলো।

এই পরিবর্তনের ফলে কি গুগল অ্যাডস এপিআই (Google Ads API) ব্যবহার করার জন্য আমাকে গুগল ওয়ার্কস্পেস (Google Workspace) বা গুগল ক্লাউড (Google Cloud)-এর গ্রাহক হতে হবে?

না। আপনার একটি গুগল ক্লাউড অর্গানাইজেশন প্রয়োজন, যা বিভিন্ন উপায়ে পাওয়া যেতে পারে। এই প্রয়োজনীয়তাটি অনেকটা এমন যে, বর্তমানে গুগল অ্যাডস এপিআই ব্যবহার করার জন্য আপনার একটি গুগল এপিআই কনসোল প্রজেক্টের প্রয়োজন হয়।

আমাকে আমার এপিআই অ্যাক্সেস লেভেল পরিবর্তন করতে হবে। আমি এটা কীভাবে করতে পারি?

এপিআই অ্যাক্সেস লেভেলে যেকোনো পরিবর্তনের অনুরোধ জানাতে আপাতত আপনার এপিআই সেন্টার ব্যবহার করা চালিয়ে যাওয়া উচিত।

এই পাইলট প্রকল্পে অংশগ্রহণের জন্য কি কোনো ডাউনটাইম আছে?

না, এমন কোনো ব্যবস্থা নেই। একবার অনুমোদন পেয়ে গেলে, গুগল অ্যাডস এপিআই স্বয়ংক্রিয়ভাবে প্রতিষ্ঠান-স্তরের এপিআই অ্যাক্সেস লেভেল ব্যবহার করা শুরু করবে।

এই পাইলট প্রকল্পে অংশগ্রহণ করতে কতটা প্রচেষ্টা লাগে?

কোডে খুব সামান্য পরিবর্তন আশা করা যায়। বেশিরভাগ ডেভেলপার ৩০ মিনিটেরও কম সময়ে তাদের অ্যাপে পরিবর্তনগুলো সম্পন্ন করতে পারবেন।

এই পাইলট প্রকল্পে অংশগ্রহণ করলে আমার কি কোনো চার্জ কাটা হবে?

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

গুগল ক্লাউড অর্গানাইজেশন পাওয়ার সম্ভাব্য উপায়গুলো নিম্নরূপ:

1. আপনি একজন বিদ্যমান Google Workspace বা Google Cloud Identity গ্রাহক :

   ঐ পণ্যগুলির যেকোনো নিয়মিত ব্যবহারের জন্য আপনাকে যথারীতি চার্জ করা হবে। এই পাইলটে অংশগ্রহণের উদ্দেশ্যে একটি গুগল ক্লাউড অর্গানাইজেশন তৈরি করার জন্য আপনাকে কোনো চার্জ করা হবে না।

2. আপনি একটি গুগল ক্লাউড আইডেন্টিটি ফ্রি এডিশন অ্যাকাউন্ট তৈরি করেছেন :

   এই পাইলট কার্যক্রমে অংশগ্রহণের উদ্দেশ্যে গুগল ক্লাউড আইডেন্টিটি ফ্রি এডিশন অ্যাকাউন্ট বা গুগল ক্লাউড অর্গানাইজেশন তৈরির জন্য আপনার থেকে কোনো চার্জ নেওয়া হবে না।

3. গুগল আপনার জন্য একটি ক্লাউড সংস্থা সম্পদ তৈরি করেছে :

   এটি গুগল-পরিচালিত একটি অভ্যন্তরীণ ক্লাউড সংস্থার রিসোর্স, তাই এর জন্য আপনাকে কোনো চার্জ করা হবে না।

আমার বিভিন্ন টুলের জন্য একাধিক ডেভেলপার টোকেন আছে। এই পাইলট প্রকল্পটি আমাকে কীভাবে প্রভাবিত করবে?

এই ব্যবহারের ক্ষেত্রটি সমর্থিত নয়, তাই আপনি এই পাইলট প্রকল্পে অংশগ্রহণ করতে পারবেন না।

এর ফলে কি গুগল অ্যাডস এপিআই ব্যবহার করে আমার পরিচালিত অ্যাকাউন্টগুলোর বিদ্যমান কোনো এপিআই অনুমোদন প্রভাবিত হবে?

না, এই পরিবর্তনটি আপনার Google Ads API ব্যবহার করে পরিচালিত Google Ads অ্যাকাউন্টগুলির কোনো বিদ্যমান API অনুমোদনকে প্রভাবিত করবে না।

আমি এই পাইলট প্রকল্পে অংশগ্রহণ করেছি এবং আমার একটি সমস্যা বা মতামত আছে। আমি সাপোর্টের সাথে কীভাবে যোগাযোগ করব?

এপিআই টেকনিক্যাল সাপোর্ট পেজ ব্যবহার করে গুগল অ্যাডস এপিআই টিমের সাথে যোগাযোগ করুন এবং আপনার সমস্যার প্রকৃতি ব্যাখ্যা করুন। সম্ভব হলে আপনার অর্গানাইজেশন আইডি এবং রিকোয়েস্ট ও রেসপন্স লগের মতো বিবরণ অন্তর্ভুক্ত করুন।