আপনার Google Cloud প্রোজেক্টে অ্যাক্সেস লেভেল ও "অনুমোদিত ব্যবহার" অ্যাসাইন করা হয়। অ্যাক্সেস লেভেল নির্ধারণ করে যে আপনি প্রোডাকশন অ্যাকাউন্ট এবং প্রতিদিন কতগুলি অপারেশন ও অনুরোধ কার্যকর করতে পারবেন। অনুমোদিত ব্যবহার নির্ধারণ করে যে প্রোজেক্টটি কোন নির্দিষ্ট Google Ads API ফিচার ব্যবহার করার অনুমতি পাবে।
অ্যাক্সেস লেভেল
টেবিলে চারটি আলাদা API অ্যাক্সেস লেভেল ক্রমানুসারে তালিকাভুক্ত করা আছে। আপনার কাছে আগে থেকে Google Ads API অ্যাক্সেস না থাকলে, আপনি API চালু করার মাধ্যমে শুরু করতে পারেন যাতে আপনার Google Cloud প্রোজেক্টের জন্য টেস্ট অ্যাক্সেস লেভেল পেতে পারেন। অ্যাপ্লিকেশনে কিছু অতিরিক্ত ধাপ সম্পূর্ণ করে আপনি অ্যাক্সেস লেভেল বাড়াতে পারবেন।
| অ্যাক্সেস স্তর | অ্যাক্সেস করতে পারবেন... | দৈনিক অপারেশন সীমা ১ | কীভাবে আবেদন করবেন | পর্যালোচনা করতে সাধারণত কত সময় লাগে? |
|---|---|---|---|---|
| পরীক্ষা | টেস্ট অ্যাকাউন্ট | ১৫,০০০টি অপারেশন / দিন | টেস্ট অ্যাক্সেসের জন্য আবেদন করুন | |
| এক্সপ্লোরার | টেস্ট ও প্রোডাকশন অ্যাকাউন্ট | প্রোডাকশন অ্যাকাউন্টের জন্য ২,৮৮০টি অপারেশন / দিন টেস্ট অ্যাকাউন্টের জন্য ১৫,০০০টি অপারেশন / দিন |
Explorer অ্যাক্সেসের জন্য আবেদন করুন | |
| সাধারণ | টেস্ট ও প্রোডাকশন অ্যাকাউন্ট | টেস্ট ও প্রোডাকশন অ্যাকাউন্ট, দুটির ক্ষেত্রেই ১৫,০০০ অপারেশন / দিন | বেসিক অ্যাক্সেসের জন্য আবেদন করুন | |
| মানক | টেস্ট ও প্রোডাকশন অ্যাকাউন্ট | টেস্ট ও প্রোডাকশন অ্যাকাউন্ট, দুটির জন্যই আনলিমিটেড অপারেশন / দিন | স্ট্যান্ডার্ড অ্যাক্সেসের জন্য আবেদন করুন | ১০ কর্মদিবস |
১ "প্রতি দিন" বলতে ২৪ ঘণ্টার সময়সীমাকে বোঝায়, যার মধ্যে আপনার Google Cloud প্রোজেক্টের সাথে API অনুরোধ করা হয়েছে। আপনার অ্যাক্সেস লেভেলের জন্য অনুরোধের সীমা গত ২৪ ঘণ্টার মধ্যে অতিক্রম করলে, আপনার অ্যাপ্লিকেশন একটি সমস্যার মেসেজ পাবে।
অ্যাক্সেস টেস্ট করুন
Google Ads API চালু করার পরে, আপনার Google Cloud প্রোজেক্টকে টেস্ট অ্যাক্সেস দেওয়া হয়। এর অর্থ হল, প্রোজেক্টটি শুধুমাত্র টেস্ট অ্যাকাউন্টের জন্য Google Ads API-এর অনুরোধ করতে পারবে।
টেস্ট অ্যাক্সেসের জন্য আবেদন করা
আপনার Google Cloud প্রোজেক্টে Google Ads API চালু করুন যাতে আপনার প্রোজেক্টের জন্য অটোমেটিক টেস্ট অ্যাক্সেস পেতে পারেন।
এক্সপ্লোরার অ্যাক্সেস লেভেল
Google Ads API-তে প্রাথমিক সাইন-আপ সম্পূর্ণ করার পরে, Google আপনাকে এক্সপ্লোরার অ্যাক্সেস লেভেলের জন্য আবেদন করার অনুমতি দিতে পারে।
Explorer অ্যাক্সেস লেভেল আপনার Google Cloud প্রোজেক্টকে টেস্ট অ্যাকাউন্ট ও প্রোডাকশন অ্যাকাউন্ট, দুটির বিরুদ্ধেই Google Ads API অনুরোধ করার অনুমতি দেয়। প্রোডাকশন অ্যাকাউন্ট হল সেইসব অ্যাকাউন্ট যেগুলি আসল, লাইভ Google বিজ্ঞাপন দেখায়—টেস্ট অ্যাকাউন্ট বিজ্ঞাপন দেখায় না।
Explorer অ্যাক্সেস লেভেল আপনার Google Cloud প্রোজেক্টকে প্রোডাকশন অ্যাকাউন্টের বিরুদ্ধে প্রতিদিন সর্বাধিক ২,৮৮০টি অপারেশন এক্সিকিউট করার অনুমতি দেয়। API ব্যবহার শুরু করা এবং সাধারণ অটোমেশন তৈরি করার জন্য বেশিরভাগ ডেভেলপারদের জন্য এটি যথেষ্ট।
Explorer অ্যাক্সেস লেভেল নিম্নলিখিত ফিচারগুলিতে অ্যাক্সেস সীমিত করে। আপনি যদি এইসব ফিচার ব্যবহার করতে চান, তাহলে আপনাকে বেসিক অ্যাক্সেস লেভেল বা স্ট্যান্ডার্ড অ্যাক্সেস লেভেল-এর জন্য আবেদন করতে হবে।
| বিধিনিষেধযুক্ত কার্যকারিতা | বিধিনিষেধযুক্ত পরিষেবা ও পদ্ধতি |
|---|---|
| অ্যাকাউন্ট তৈরি | CustomerService.CreateCustomerClient |
| ব্যবহারকারী ম্যানেজমেন্ট | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| প্ল্যানিং | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| অ্যাকাউন্ট বিলিং ও পেমেন্ট | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
এক্সপ্লোরার অ্যাক্সেস লেভেলের জন্য আবেদন করুন
- আপনার Google Cloud প্রোজেক্টে Google Ads API ওভারভিউ পৃষ্ঠায় নেভিগেট করুন।
- পৃষ্ঠাটি আপনার বর্তমান অ্যাক্সেস লেভেল Test হিসেবে দেখাচ্ছে কিনা তা যাচাই করুন।
- অ্যাক্সেস লেভেল আপগ্রেড করুন বিভাগটি বড় করতে ক্লিক করুন।
- পরবর্তী অ্যাক্সেস লেভেল এক্সপ্লোরার হিসেবে দেখানো হচ্ছে কিনা তা কনফার্ম করুন।
- এক্সপ্লোরার অ্যাক্সেস লেভেলের জন্য আবেদন করতে অ্যাক্সেসের জন্য আবেদন করুন বোতামে ক্লিক করুন।
আপনার আবেদন জমা দেওয়ার পরে, Google অটোমেটিক আপনার প্রোজেক্টের API অ্যাক্সেস লেভেল আপগ্রেড করে এক্সপ্লোরার করতে পারে।
প্রাথমিক অ্যাক্সেস লেভেল
বেসিক অ্যাক্সেস লেভেল আপনার Google Cloud প্রোজেক্টকে টেস্ট অ্যাকাউন্ট এবং প্রোডাকশন অ্যাকাউন্ট উভয়ের জন্যই Google Ads API অনুরোধ করার অনুমতি দেয়। প্রোডাকশন অ্যাকাউন্ট হল এমন যেকোনও অ্যাকাউন্ট যা আসল, লাইভ Google বিজ্ঞাপন দেখায়—টেস্ট অ্যাকাউন্ট বিজ্ঞাপন দেখায় না।
বেসিক অ্যাক্সেস লেভেল আপনার Google Cloud প্রোজেক্টকে প্রতিদিন ১৫,০০০ পর্যন্ত অপারেশন সম্পাদন করার অনুমতি দেয়। বেশিরভাগ ডেভেলপারের জন্য এটি যথেষ্ট।
বেসিক অ্যাক্সেস লেভেলের জন্য আবেদন করুন
- আপনার Google Cloud প্রোজেক্টে Google Ads API ওভারভিউ পৃষ্ঠায় নেভিগেট করুন।
- পৃষ্ঠাটি আপনার বর্তমান অ্যাক্সেস লেভেল এক্সপ্লোরার হিসেবে দেখাচ্ছে কিনা তা যাচাই করুন।
- অ্যাক্সেস লেভেল আপগ্রেড করুন বিভাগটি বড় করতে ক্লিক করুন।
- পরবর্তী অ্যাক্সেস লেভেল বেসিক হিসেবে দেখানো হচ্ছে কিনা তা কনফার্ম করুন।
- আপনার প্রোজেক্টের জন্য ব্র্যান্ড যাচাইকরণ সম্পূর্ণ করেননি, এমন কোনও সতর্কতা নেই তা কনফার্ম করুন। সেগুলি থাকলে, ব্র্যান্ড যাচাইকরণ সম্পূর্ণ করতে, নির্দেশাবলী অনুসরণ করুন তারপরে চালিয়ে যান।
- বেসিক অ্যাক্সেস লেভেলের জন্য আবেদন করতে অ্যাক্সেসের জন্য আবেদন করুন বোতামে ক্লিক করুন।
আপনি আবেদন জমা দেওয়ার পরে Google অটোমেটিক আপনার প্রোজেক্টের API অ্যাক্সেস লেভেল বেসিক লেভেলে আপগ্রেড করতে পারে।
অ্যাক্সেসের স্ট্যান্ডার্ড লেভেল
স্ট্যান্ডার্ড অ্যাক্সেস লেভেল আপনার Google Cloud প্রোজেক্টকে সব পরিষেবার জন্য প্রতিদিন সীমাহীন সংখ্যক অপারেশন এক্সিকিউট করার অনুমতি দেয়। ব্যক্তিগত পরিষেবা ও ফিচারের ক্ষেত্রে এখনও রেট সীমা ও বিধিনিষেধ থাকতে পারে যা সেইসব ফিচারের জন্য নির্দিষ্ট, আপনার প্রোজেক্টে স্ট্যান্ডার্ড অ্যাক্সেস লেভেল থাকলেও যা প্রযোজ্য থাকবে।
অ্যাক্সেসের স্ট্যান্ডার্ড পদ্ধতি শুধুমাত্র সেইসব ডেভেলপারদের দেওয়া হয় যাদের আনলিমিটেড Google Ads API অপারেশন প্রয়োজন, যেমন বড় কোম্পানি বা টুল যা অনেক ব্যবহারকারীকে পরিষেবা দেয়।
স্ট্যান্ডার্ড অ্যাক্সেস লেভেলের জন্য আবেদন করুন
- আপনার Google Cloud প্রোজেক্টে Google Ads API ওভারভিউ পৃষ্ঠায় নেভিগেট করুন।
- পৃষ্ঠাটি আপনার বর্তমান অ্যাক্সেস লেভেল বেসিক হিসেবে দেখাচ্ছে কিনা তা যাচাই করুন।
- অ্যাক্সেস লেভেল আপগ্রেড করুন বিভাগটি বড় করতে ক্লিক করুন।
- পরবর্তী অ্যাক্সেস লেভেল স্ট্যান্ডার্ড হিসেবে দেখানো হচ্ছে কিনা তা কনফার্ম করুন।
- স্ট্যান্ডার্ড অ্যাক্সেস লেভেল অ্যাপ্লিকেশন শুরু করতে অ্যাপ্লিকেশন শুরু করুন বোতামে ক্লিক করুন।
স্ট্যান্ডার্ড অ্যাক্সেস অ্যাপ্লিকেশনে আপনার আবেদনের বিস্তারিত ম্যানুয়াল অডিট করা হয়। আপনার টুলের কার্যকারিতা এবং এর টার্গেট অডিয়েন্স সম্পর্কে প্রশ্নের উত্তর দেওয়ার জন্য প্রস্তুত থাকুন। আপনার টুল এক্সটার্নাল ব্যবহারকারীরা ব্যবহার করলে, আপনার টুলে ডেমো সাইন-ইন অ্যাক্সেস দেওয়ার জন্য প্রস্তুত থাকুন। মনে রাখবেন, আপনার টুলকে অবশ্যই ন্যূনতম প্রয়োজনীয় কার্যকারিতা মেনে চলতে হবে।
পর্যালোচনা প্রক্রিয়া চলাকালীন, Google-এর কমপ্লায়েন্স টিম আপনার ইমেল আইডি ব্যবহার করে আপনার সাথে যোগাযোগ করবে। আপনার স্ট্যান্ডার্ড অ্যাক্সেস অ্যাপ্লিকেশন নিয়ে এগিয়ে যেতে, কমপ্লায়েন্স টিমের প্রশ্নের দ্রুত উত্তর দিতে ভুলবেন না। পর্যালোচনা সম্পূর্ণ হয়ে গেলে, Google আপনাকে পর্যালোচনা প্রক্রিয়ার চূড়ান্ত ফলাফল ইমেল করে জানাবে।
API কোটা ও সিস্টেম রেটের সীমা
অ্যাক্সেস লেভেল যাই হোক না কেন, সব API অপারেশন সিস্টেম রেট সীমার মধ্যে পড়ে, যা নির্দিষ্ট সময়ের মধ্যে আপনি কতগুলি অপারেশন করতে পারবেন তা সীমিত করে, অর্থাৎ প্রতি ঘণ্টায় অপারেশনের সংখ্যা। রেট লিমিট সংক্রান্ত সমস্যা কীভাবে সমাধান করবেন সেই সম্পর্কে আরও জানতে, সমস্যার ধরন দেখুন।
প্রোডাক্ট ডিজাইন সংক্রান্ত সীমাবদ্ধতা, প্রোডাক্ট নীতি সংক্রান্ত বিধিনিষেধ, API পারফর্ম্যান্স ও লেটেন্সি সংক্রান্ত বিবেচনার মতো কারণে ব্যক্তিগত পরিষেবা অতিরিক্ত সীমা ও কোটা সংক্রান্ত বিধিনিষেধ প্রয়োগ করতে পারে। এইসব বিধিনিষেধ সম্পর্কে আরও জানতে API কোটা সংক্রান্ত ডকুমেন্টেশন দেখুন।
অনুমতিযোগ্য ব্যবহার
অনুমতিযোগ্য ব্যবহার শুধুমাত্র স্ট্যান্ডার্ড অ্যাক্সেস লেভেল সহ Google Cloud প্রোজেক্টের ক্ষেত্রে প্রযোজ্য। Google Ads API-এর উদ্দেশ্যমূলক ব্যবহারের উপর ভিত্তি করে অনুমোদিত ব্যবহার বরাদ্দ করা হয়। এইসব অনুমতি নির্ধারণ করে যে আপনার টুল API-এর কোন ফিচার ব্যবহার করতে পারবে, যেমন নিচের সারণীতে বিশদে বলা হয়েছে:
| অনুমতিযোগ্য ব্যবহার | বিবরণ |
|---|---|
| বিজ্ঞাপন তৈরি / ম্যানেজ করা | Google Ads ক্যাম্পেন, বিজ্ঞাপন গ্রুপ, বিজ্ঞাপন ও কীওয়ার্ড তৈরি ও ম্যানেজ করার জন্য API-এর সব পরিষেবায় অ্যাক্সেস প্রদান করে। |
| রিপোর্ট করা হচ্ছে | শুধুমাত্র GoogleAdsService.Search বা GoogleAdsService.SearchStream অনুরোধ বা রিড-অনলি কল করুন। এটি সেইসব ডেভেলপারদের জন্য যারা শুধুমাত্র পরিসংখ্যানের অনুরোধ করার জন্য API ব্যবহার করেন। |
| কীওয়ার্ড ও সাজেশন রিসার্চ করা হচ্ছে | Google Cloud প্রোজেক্টকে RecommendationService, KeywordPlanIdeaService ও KeywordPlanService অ্যাক্সেস করার অনুমতি দিন। Google Ads ক্যাম্পেন তৈরি ও ম্যানেজ করার জন্য যেসব টুলের সাজেশন প্রয়োজন হয়, শুধুমাত্র সেগুলিই এটি ব্যবহার করে। |
অনুমতিযোগ্য ব্যবহার পরিবর্তন করা
আপনার Google Cloud প্রোজেক্ট স্ট্যান্ডার্ড অ্যাক্সেস লেভেলের জন্য অনুমোদিত হলে, আপনি অনুমোদিত ব্যবহার আপডেট করার জন্য আবেদন পূরণ করতে পারবেন। আপনার অনুমোদিত ব্যবহার আপডেট করতে চাইলে বা আপনার টুল অ্যাক্সেস করার জন্য ক্লায়েন্টদের অনুমতি দিতে চাইলে, আবেদনপত্রটি পূরণ করুন।