২৬শে মার্চ, সকাল ১১:০০ টায় (EST) ডিসকর্ডে গুগল অ্যাডভার্টাইজিং অ্যান্ড মেজারমেন্ট কমিউনিটি সার্ভারে এবং ইউটিউবে আমাদের সাথে লাইভে যোগ দিন! আমরা গুগল অ্যাডস এপিআই-এর v23.2-এ যুক্ত হওয়া নতুন ফিচারগুলো নিয়ে আলোচনা করব।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

অ্যাক্সেস স্তর এবং অনুমতিযোগ্য ব্যবহার

প্রতিটি গুগল অ্যাডস এপিআই ডেভেলপার টোকেনকে একটি অ্যাক্সেস লেভেল এবং 'অনুমোদিত ব্যবহার' নির্ধারণ করে দেওয়া হয়। অ্যাক্সেস লেভেল নির্ধারণ করে যে আপনি প্রোডাকশন অ্যাকাউন্টগুলোকে প্রভাবিত করতে পারবেন কিনা এবং প্রতিদিন কতগুলো অপারেশন ও রিকোয়েস্ট সম্পাদন করতে পারবেন। অনুমোদিত ব্যবহার নির্ধারণ করে যে ডেভেলপার টোকেনটি গুগল অ্যাডস এপিআই-এর কোন নির্দিষ্ট ফিচারগুলো ব্যবহার করার অনুমতি পাবে।

অ্যাক্সেস স্তর

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

প্রবেশাধিকার স্তর	প্রবেশ করতে পারে...	দৈনিক কার্যক্রমের সীমা ^১	কীভাবে আবেদন করবেন	পর্যালোচনা করতে সাধারণত কত সময় লাগে?
টেস্ট অ্যাকাউন্ট অ্যাক্সেস স্তর	পরীক্ষার অ্যাকাউন্ট	প্রতিদিন ১৫,০০০ অপারেশন	নির্দেশাবলী
এক্সপ্লোরার অ্যাক্সেস স্তর	পরীক্ষা এবং উৎপাদন অ্যাকাউন্ট	প্রোডাকশন অ্যাকাউন্টগুলির জন্য প্রতিদিন ২,৮৮০টি অপারেশন টেস্ট অ্যাকাউন্টগুলির জন্য প্রতিদিন ১৫,০০০ অপারেশন	নির্দেশাবলী
মৌলিক অ্যাক্সেস স্তর	পরীক্ষা এবং উৎপাদন অ্যাকাউন্ট	টেস্ট এবং প্রোডাকশন উভয় অ্যাকাউন্টের জন্য প্রতিদিন ১৫,০০০ অপারেশন	নির্দেশাবলী	২ কার্যদিবস
স্ট্যান্ডার্ড অ্যাক্সেস স্তর	পরীক্ষা এবং উৎপাদন অ্যাকাউন্ট	টেস্ট এবং প্রোডাকশন উভয় অ্যাকাউন্টের জন্য প্রতিদিন সীমাহীন অপারেশন	নির্দেশাবলী	১০ কার্যদিবস

^১. "প্রতিদিন" গণনা করা হয় একটি পরিবর্তনশীল ২৪-ঘণ্টার সময়কালের উপর ভিত্তি করে, যে সময়ের মধ্যে আপনার ডেভেলপার টোকেন ব্যবহার করে এপিআই (API) অনুরোধ করা হয়েছে। গত ২৪ ঘণ্টার মধ্যে আপনার অ্যাক্সেস লেভেলের জন্য নির্ধারিত অনুরোধের সীমা অতিক্রম করলে আপনার অ্যাপ্লিকেশনটি একটি ত্রুটি বার্তা পাবে।

টেস্ট অ্যাকাউন্ট অ্যাক্সেস স্তর

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

টেস্ট অ্যাকাউন্ট অ্যাক্সেস লেভেলের জন্য কীভাবে আবেদন করবেন

গুগল অ্যাডস ওয়েব ইন্টারফেসে গুগল অ্যাডস এপিআই সাইন-আপ সম্পূর্ণ করলে স্বয়ংক্রিয়ভাবে টেস্ট অ্যাকাউন্ট অ্যাক্সেস লেভেল পেয়ে যাবেন।

এক্সপ্লোরার অ্যাক্সেস স্তর

Google Ads API-এর জন্য প্রাথমিক সাইন-আপ সম্পন্ন করার পরে, কিছু ক্ষেত্রে Google স্বয়ংক্রিয়ভাবে আপনার ডেভেলপার টোকেনকে 'টেস্ট অ্যাকাউন্ট অ্যাক্সেস' স্তর থেকে 'এক্সপ্লোরার অ্যাক্সেস' স্তরে আপগ্রেড করতে পারে। 'এক্সপ্লোরার অ্যাক্সেস' স্তর ডেভেলপার টোকেনকে টেস্ট অ্যাকাউন্ট এবং প্রোডাকশন অ্যাকাউন্ট উভয় ক্ষেত্রেই Google Ads API অনুরোধ করার অনুমতি দেয়। প্রোডাকশন অ্যাকাউন্ট হলো সেইসব অ্যাকাউন্ট যা আসল, লাইভ Google বিজ্ঞাপন দেখায়—টেস্ট অ্যাকাউন্ট কোনো বিজ্ঞাপন দেখায় না।

এক্সপ্লোরার অ্যাক্সেস লেভেল ডেভেলপার টোকেনকে প্রোডাকশন অ্যাকাউন্টের বিপরীতে প্রতিদিন ২,৮৮০টি পর্যন্ত অপারেশন সম্পাদন করার অনুমতি দেয়। বেশিরভাগ ডেভেলপারের জন্য এপিআই দিয়ে কাজ শুরু করতে এবং প্রাথমিক অটোমেশন তৈরি করতে এটি যথেষ্ট।

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

সীমাবদ্ধ কার্যকারিতা	সীমাবদ্ধ পরিষেবা এবং পদ্ধতি
অ্যাকাউন্ট তৈরি	`CustomerService.CreateCustomerClient`
ব্যবহারকারী ব্যবস্থাপনা	`CustomerUserAccessInvitationService` `CustomerUserAccessService`
পরিকল্পনা	`KeywordPlanService` `KeywordPlanIdeaService` `KeywordPlanCampaignService` `KeywordPlanCampaignKeywordService` `KeywordPlanAdGroupService` `KeywordPlanAdGroupKeywordService` `AudienceInsightsService` `KeywordPlanIdeaService` `ReachPlanService`
অ্যাকাউন্ট বিলিং এবং পেমেন্ট	`PaymentsAccountService` `BillingSetupService` `AccountBudgetProposalService` `InvoiceService`

এক্সপ্লোরার অ্যাক্সেস লেভেলের জন্য কীভাবে আবেদন করবেন

Google Ads ওয়েব ইন্টারফেসে Google Ads API সাইন-আপটি সম্পূর্ণ করুন। কিছু ক্ষেত্রে, সাইন-আপ সম্পন্ন করার পর Google স্বয়ংক্রিয়ভাবে আপনার ডেভেলপার টোকেনটিকে এক্সপ্লোরার অ্যাক্সেস লেভেলে আপগ্রেড করে দিতে পারে।

মৌলিক অ্যাক্সেস স্তর

Basic Access level allows the developer token to make Google Ads API requests against both test accounts and production accounts. Production accounts are any accounts that serve real, live Google ads—test accounts don't serve ads.

বেসিক অ্যাক্সেস লেভেল ডেভেলপার টোকেনকে প্রতিদিন সর্বোচ্চ ১৫,০০০ অপারেশন সম্পাদনের অনুমতি দেয়। এটি বেশিরভাগ ডেভেলপারের জন্য যথেষ্ট।

বেসিক অ্যাক্সেস লেভেলের জন্য কীভাবে আবেদন করবেন

আপনার কাছে যদি টেস্ট অ্যাকাউন্ট অ্যাক্সেস লেভেল বা এক্সপ্লোরার অ্যাক্সেস সহ একটি ডেভেলপার টোকেন থাকে, তাহলে আপনি নিম্নলিখিত উপায়ে বেসিক অ্যাক্সেস লেভেলের জন্য আবেদন করতে পারেন:

আপনার ওয়েব ব্রাউজারে https://ads.google.com/aw/apicenter- এ যান। অনুরোধ করা হলে আপনার গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।
এপিআই সেন্টারে প্রবেশ করুন
আপনার অ্যাক্সেস লেভেল যে টেস্ট অ্যাকাউন্ট অথবা এক্সপ্লোরার , তা যাচাই করুন।
এপিআই সেন্টারে থাকা এপিআই কন্টাক্ট ইমেলটি হালনাগাদ আছে কিনা তা নিশ্চিত করুন। একটি বৈধ ও নিয়মিত চেক করা হয় এমন ইমেল ঠিকানা ছাড়া আপনি আবেদন প্রক্রিয়াটি সম্পন্ন করতে পারবেন না। এপিআই টোকেনসহ গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টের সাথে আপনার সমস্ত সক্রিয় গুগল অ্যাডস অ্যাকাউন্ট লিঙ্ক করা আছে কিনা তা নিশ্চিত করুন।
অ্যাক্সেস লেভেলের পাশে থাকা ড্রপ-ডাউন তীরচিহ্নে ক্লিক করুন এবং 'Apply for Basic Access' লিঙ্কে ক্লিক করুন।

স্ট্যান্ডার্ড অ্যাক্সেস স্তর

স্ট্যান্ডার্ড অ্যাক্সেস লেভেল ডেভেলপার টোকেনকে বেশিরভাগ পরিষেবার জন্য প্রতিদিন সীমাহীন সংখ্যক অপারেশন সম্পাদন করার অনুমতি দেয়। এর মধ্যে GoogleAdsService Search এবং SearchStream অন্তর্ভুক্ত, তবে এটি কেবল এগুলোর মধ্যেই সীমাবদ্ধ নয়। স্ট্যান্ডার্ড অ্যাক্সেস লেভেলের সীমাবদ্ধতা এবং ব্যতিক্রম সম্পর্কে আরও বিস্তারিত জানতে, এপিআই কোটা দেখুন।

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

স্ট্যান্ডার্ড অ্যাক্সেস লেভেলের জন্য কীভাবে আবেদন করবেন

আপনার কাছে বেসিক অ্যাক্সেস লেভেলের ডেভেলপার টোকেন থাকলে, আপনি নিম্নোক্তভাবে স্ট্যান্ডার্ড অ্যাক্সেস লেভেলের জন্য আবেদন করতে পারেন:

আপনার ওয়েব ব্রাউজারে https://ads.google.com/aw/apicenter- এ যান। অনুরোধ করা হলে আপনার গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।
এপিআই সেন্টারে প্রবেশ করুন
আপনার অ্যাক্সেস লেভেল বেসিক কিনা তা যাচাই করুন।
এপিআই সেন্টারে থাকা এপিআই কন্টাক্ট ইমেলটি হালনাগাদ আছে কিনা তা নিশ্চিত করুন। একটি বৈধ ও নিয়মিত চেক করা হয় এমন ইমেল ঠিকানা ছাড়া আপনি আবেদন প্রক্রিয়াটি সম্পন্ন করতে পারবেন না। এপিআই টোকেনসহ গুগল অ্যাডস ম্যানেজার অ্যাকাউন্টের সাথে আপনার সমস্ত সক্রিয় গুগল অ্যাডস অ্যাকাউন্ট লিঙ্ক করা আছে কিনা তা নিশ্চিত করুন।
অ্যাক্সেস লেভেলের পাশে থাকা ড্রপ-ডাউন তীরচিহ্নে ক্লিক করুন এবং 'স্ট্যান্ডার্ড অ্যাক্সেসের জন্য আবেদন করুন' লিঙ্কে ক্লিক করুন।

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

এপিআই কোটা এবং সিস্টেম রেট সীমা

অ্যাক্সেস লেভেল নির্বিশেষে, সমস্ত API অপারেশন সিস্টেম রেট লিমিটের অধীন, যা একটি নির্দিষ্ট সময়কালে আপনি কতগুলি অপারেশন করতে পারবেন, অর্থাৎ প্রতি ঘন্টায় অপারেশনের সংখ্যা সীমিত করে। রেট লিমিট ত্রুটিগুলি কীভাবে সমাধান করতে হয় সে সম্পর্কে আরও জানতে, ত্রুটির প্রকারভেদ দেখুন।

পণ্যের নকশার সীমাবদ্ধতা, পণ্যের নীতিগত বিধিনিষেধ, এপিআই-এর কর্মক্ষমতা এবং লেটেন্সি সংক্রান্ত বিবেচনার মতো কারণগুলোর জন্য স্বতন্ত্র পরিষেবাগুলো অতিরিক্ত সীমা এবং কোটা সীমাবদ্ধতা আরোপ করতে পারে। এই সীমাবদ্ধতাগুলো সম্পর্কে আরও জানতে এপিআই কোটা সম্পর্কিত ডকুমেন্টেশন দেখুন।

অনুমোদিত ব্যবহার

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

অনুমোদিত ব্যবহার	বর্ণনা
বিজ্ঞাপন তৈরি / ব্যবস্থাপনা	গুগল অ্যাডস ক্যাম্পেইন, অ্যাড গ্রুপ, অ্যাড এবং কীওয়ার্ড তৈরি ও পরিচালনার জন্য এপিআই-এর সকল পরিষেবা ব্যবহারের সুযোগ প্রদান করুন।
রিপোর্টিং	শুধুমাত্র `GoogleAdsService.Search` বা `GoogleAdsService.SearchStream` রিকোয়েস্ট, অথবা রিড-অনলি কল করুন। এটি সেইসব ডেভেলপারদের জন্য যারা শুধুমাত্র পরিসংখ্যান অনুরোধ করার জন্য এপিআই ব্যবহার করেন।
কীওয়ার্ড এবং সুপারিশ নিয়ে গবেষণা	ডেভেলপার টোকেনকে `RecommendationService` , `KeywordPlanIdeaService` , এবং `KeywordPlanService` অ্যাক্সেস করার অনুমতি দিন। এটি শুধুমাত্র সেইসব টুল ব্যবহার করে, যেগুলোর গুগল অ্যাডস ক্যাম্পেইন তৈরি ও পরিচালনা সহজ করার জন্য সাজেশনের প্রয়োজন হয়।

অনুমোদিত ব্যবহার কীভাবে পরিবর্তন করবেন

আপনার ডেভেলপার টোকেনটি বেসিক অ্যাক্সেস লেভেল বা স্ট্যান্ডার্ড অ্যাক্সেস লেভেলের জন্য অনুমোদিত হয়ে থাকলে, আপনি অনুমোদিত ব্যবহার আপডেট করার জন্য আবেদনপত্রটি পূরণ করতে পারেন। আপনি যদি আপনার অনুমোদিত ব্যবহার আপডেট করতে চান অথবা আপনার ক্লায়েন্টদের আপনার টুলে অ্যাক্সেস দিতে চান, তাহলে আবেদনপত্রটি পূরণ করুন।