API সীমা ও কোটা

Google Ads API, API অপারেশনের উপর সীমা আরোপ করে, যেমন, একটি মিউটেট রিকোয়েস্টে যতগুলি অপারেশন পাঠানো যেতে পারে। নিচের সারণীতে কিছু গুরুত্বপূর্ণ সীমা ও কোটা সম্পর্কে সংক্ষেপে বলা হয়েছে, যেগুলি সম্পর্কে আপনাকে সচেতন থাকতে হবে।

অনুরোধের ধরন, সীমাবদ্ধতা ও ত্রুটি কোড
টেস্ট অ্যাক্সেস লেভেল সহ অপারেশন	টেস্ট অ্যাকাউন্টের জন্য প্রতিদিন ১৫,০০০ API অপারেশন	RESOURCE_EXHAUSTED
এক্সপ্লোরার অ্যাক্সেস লেভেল সহ অপারেশন	প্রোডাকশন অ্যাকাউন্টের ক্ষেত্রে প্রতিদিন ২৮৮০টি API অপারেশন টেস্ট অ্যাকাউন্টের ক্ষেত্রে প্রতিদিন ১৫০০০টি API অপারেশন	RESOURCE_EXHAUSTED
প্রাথমিক অ্যাক্সেস লেভেল সহ অপারেশন	টেস্ট ও প্রোডাকশন অ্যাকাউন্ট, দুটির ক্ষেত্রেই প্রতিদিন ১৫,০০০ API অপারেশন	RESOURCE_EXHAUSTED
অ্যাক্সেসের স্ট্যান্ডার্ড পদ্ধতি লেভেল সহ অপারেশন	টেস্ট ও প্রোডাকশন অ্যাকাউন্ট, দুটির ক্ষেত্রেই প্রতিদিন আনলিমিটেড API অপারেশন	প্রযোজ্য নয়
মিউটেট রিকোয়েস্ট	প্রতিটি অনুরোধে ১০,০০০টি মিউটেট অপারেশন	TOO_MANY_MUTATE_OPERATIONS
প্ল্যানিং পরিষেবা সংক্রান্ত অনুরোধ	১ QPS	RESOURCE_EXHAUSTED
কনভার্সন আপলোড পরিষেবার অনুরোধ	প্রতি অনুরোধে ২,০০০টি কনভার্সন	TOO_MANY_CONVERSIONS_IN_REQUEST
বিলিং ও অ্যাকাউন্ট বাজেট পরিষেবা সংক্রান্ত অনুরোধ	প্রতিটি মিউটেট রিকোয়েস্টে ১টি অপারেশন	TOO_MANY_MUTATE_OPERATIONS

দৈনিক API অপারেশন সীমা

আপনার Google Cloud প্রোজেক্টের মাধ্যমে করা API অপারেশনের সংখ্যার উপর ভিত্তি করে দৈনিক API ব্যবহারের সীমা নির্ধারণ করা হয়। API অপারেশন হল Search ও SearchStream অনুরোধ, স্বতন্ত্র মিউটেশন অপারেশন এবং অন্যান্য পরিষেবা অনুরোধের মোট যোগফল। দৈনিক API অপারেশনের সীমা নির্ভর করে আপনার Google Cloud প্রোজেক্টের API অ্যাক্সেস লেভেলের উপর। অ্যাক্সেস লেভেল ও অনুমোদিত ব্যবহার সংক্রান্ত নির্দেশিকা প্রতিটি অ্যাক্সেস লেভেলের জন্য নির্দিষ্ট API অপারেশন সীমা সম্পর্কে জানায়।

এইসব সীমা লঙ্ঘনকারী অনুরোধগুলি এই সমস্যা সহ বাতিল করা হয়: RESOURCE_EXHAUSTED.

gRPC সংক্রান্ত সীমাবদ্ধতা

Google Ads API-এর সব ক্লায়েন্ট লাইব্রেরি অনুরোধ ও উত্তর জেনারেট করার জন্য gRPC ব্যবহার করে। সাধারণত, gRPC-তে মেসেজের সাইজ ৪ এমবি, কিন্তু আমাদের ক্লায়েন্ট লাইব্রেরি কার্যকারিতা বাড়ানোর জন্য মেসেজের সর্বাধিক সাইজ ৬৪ এমবি সেট করে।

উত্তর এই সীমা অতিক্রম করলে চলবে না। যেমন, এমন একটি সার্চ অনুরোধ যা অনেক ফিল্ড অন্তর্ভুক্ত করে, সেটি এমন একটি উত্তর তৈরি করতে পারে যার সাইজ ৬৪ এমবি অতিক্রম করে যায়। এই সীমা এড়াতে, বেছে নেওয়া ফিল্ডের সংখ্যা কমাতে পারেন অথবা স্ট্রিমিং ব্যবহার করতে পারেন। মিউটেটের জন্য, প্রতিটি অনুরোধে কম অপারেশন পাঠান।

এই সীমাবদ্ধতা লঙ্ঘন করে এমন অনুরোধের ক্ষেত্রে GoogleAdsError তৈরি হবে না, কিন্তু RESOURCE_EXHAUSTED (gRPC কোড 8 / HTTP 429) সমস্যা তৈরি হবে। gRPC সমস্যার কোড ও মেসেজের তালিকা দেখুন।

মিউটেট রিকোয়েস্ট

ব্যবহারকারীর দৈনিক অপারেশন কোটার পাশাপাশি, একটি মিউটেট রিকোয়েস্টে প্রতি অনুরোধে ১০,০০০-এর বেশি মিউটেট অপারেশন থাকতে পারে না। এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই সমস্যা সহ বাতিল করা হয়: TOO_MANY_MUTATE_OPERATIONS.

নির্দিষ্ট পরিষেবা ও অনুরোধের ধরনের জন্য অতিরিক্ত সীমা ও বিবেচনার বিষয়গুলি নিচে উল্লেখ করা হল।

সার্চ অনুরোধ

একটি Search বা SearchStream অনুরোধ ব্যবহারকারীর দৈনিক অপারেশন কোটার বিপরীতে একটি অপারেশন হিসাবে গণনা করা হয়। একটি SearchStream অনুরোধ একটি API অপারেশন হিসাবে গণনা করা হয় ব্যাচের সংখ্যা যাই হোক না কেন।

পৃষ্ঠা সংখ্যা অনুযায়ী অনুরোধ

পেজিনেটেড অনুরোধ (যেমন, সঠিক next_page_token সহ অনুরোধ) ব্যবহারকারীর দৈনিক অপারেশন কোটার মধ্যে ধরা হয় না। তবে, মেয়াদ শেষ হয়ে গেছে বা ভুল পৃষ্ঠা টোকেন আছে এমন পৃষ্ঠাঙ্কন অনুরোধ একটি ব্যতিক্রম তৈরি করবে এবং দৈনিক অপারেশন কোটার মধ্যে গণনা করা হবে।

পৃষ্ঠা সংখ্যা সংক্রান্ত আরও তথ্যের জন্য, ফলাফলের মাধ্যমে পৃষ্ঠা সংখ্যা দেখুন।

অন্যান্য ধরনের অনুরোধ

Mutate, Search বা SearchStream নয় এমন অনুরোধ ব্যবহারকারীর দৈনিক অপারেশন কোটার একটি অপারেশন হিসেবে গণনা করা হয়।

এই ধরনের অনুরোধের কয়েকটি উদাহরণ হল:

• BatchJobService.ListBatchJobResults
• ConversionUploadService.UploadCallConversions
• ConversionUploadService.UploadClickConversions
• OfflineUserDataJobService.AddOfflineUserDataJobOperations
• OfflineUserDataJobService.CreateOfflineUserDataJob
• UserDataService.UploadUserData

API ব্যতিক্রম রিটার্ন করা অনুরোধ

GoogleAdsFailure-এর কারণে বাতিল করা অনুরোধ এখনও ব্যবহারকারীর দৈনিক অপারেশন কোটার বিপরীতে গণনা করা হয়।

যেসব অনুরোধ ব্যর্থ হয় কিন্তু GoogleAdsFailure রিটার্ন করে না, যেমন নেটওয়ার্ক লেভেলে কোনও সমস্যার কারণে, সেগুলি ব্যবহারকারীর দৈনিক অপারেশন কোটার মধ্যে ধরা হবে না কারণ অনুরোধগুলি কখনই পরিষেবায় পৌঁছাবে না। এর একটি উদাহরণ হল নেটওয়ার্ক কানেক্টিভিটি কাজ না করা।

কীওয়ার্ড প্ল্যানিং পরিষেবা

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

• প্রতি CID-তে প্রতি সেকেন্ডে ১টি অনুরোধের মধ্যে সীমিত:

  • KeywordPlanIdeaService.GenerateKeywordIdeas
  • KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
  • KeywordPlanIdeaService.GenerateKeywordForecastMetrics

  এইসব সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই সমস্যা সহ বাতিল করা হয়: RESOURCE_EXHAUSTED.

• ১ QPS-কে ৬০ সেকেন্ডে ৬০টি অনুরোধ হিসেবে গণনা করা হয়।

• প্রতি CID-তে প্রতি সেকেন্ডে ২টি অনুরোধের মধ্যে সীমাবদ্ধ:

  • KeywordPlanIdeaService.GenerateAdGroupThemes

কীওয়ার্ড প্ল্যান তৈরি করার সময় এই সীমাগুলি মাথায় রাখবেন।

কীওয়ার্ড প্ল্যান অবজেক্ট	সর্বাধিক সংখ্যা
প্রতিটি অ্যাকাউন্টে KeywordPlan	১০,০০০
KeywordPlan পিছু KeywordPlanAdGroup	200
KeywordPlan পিছু KeywordPlanAdGroupKeyword	১০,০০০
প্রতি KeywordPlan-এ KeywordPlanCampaignKeyword (নেগেটিভ কীওয়ার্ড)	১,০০০
KeywordPlan পিছু KeywordPlanCampaign	1

অডিয়েন্স ইনসাইট পরিষেবা

AudienceInsightsService-এর মধ্যে নিম্নলিখিত পদ্ধতিগুলি নির্দিষ্ট কোটা সীমার অধীন।

• প্রতি CID-তে প্রতিদিন আনুমানিক ২০০টি অনুরোধের মধ্যে সীমাবদ্ধ:
  • AudienceInsightsService.GenerateAudienceCompositionInsights
  • AudienceInsightsService.GenerateSuggestedTargetingInsights
• প্রতি Google Cloud প্রোজেক্টে প্রতি সেকেন্ডে ২টি অনুরোধের মধ্যে সীমাবদ্ধ:
  • AudienceInsightsService.GenerateTargetingSuggestionMetrics

কনভার্সন আপলোড পরিষেবা

• প্রতিটি অনুরোধে কল বা ক্লিক কনভার্সনের সংখ্যা ২,০০০-এর মধ্যে সীমিত থাকে:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  এইসব সীমা লঙ্ঘন করে এমন অনুরোধ এই সমস্যার সাথে বাতিল করা হয়: TOO_MANY_CONVERSIONS_IN_REQUEST.

মনে রাখবেন: ১৫ জুন, ২০২৬ থেকে, ConversionUploadService.UploadClickConversions নতুন ব্যবহারকারীদের (ফেরত আসা NotAllowlistedError.CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE) জন্য সীমাবদ্ধ করা হয়েছে। নতুন কনভার্সন আপলোড ইন্টিগ্রেশনকে অবশ্যই ডেটা ম্যানেজার API ব্যবহার করতে হবে।

কনভার্সন অ্যাডজাস্টমেন্ট আপলোড পরিষেবা

• প্রতিটি অনুরোধে কনভার্সন অ্যাডজাস্টমেন্টের সংখ্যা ২,০০০-এর মধ্যে সীমিত থাকে:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  এইসব সীমা লঙ্ঘনকারী অনুরোধগুলি এই সমস্যা সহ বাতিল করা হয়: TOO_MANY_ADJUSTMENTS_IN_REQUEST.

কনভার্সন ভ্যালু সংক্রান্ত নিয়ম

• প্রতি অ্যাকাউন্টে ১,০০,০০০ কনভার্সন ভ্যালু সংক্রান্ত নিয়ম পর্যন্ত সীমাবদ্ধ।

  এই সীমা লঙ্ঘন করে এমন অনুরোধ ResourceCountLimitExceededError.ACCOUNT_LIMIT সমস্যার কারণে বাতিল করা হয়।

মনে রাখবেন: Google Ads API ব্যবহার করে তৈরি করা কনভার্সন ভ্যালু সংক্রান্ত নিয়ম তখনই অ্যাক্টিভ থাকে যদি সেগুলি কনভার্সন ভ্যালু সংক্রান্ত নিয়মের সেটের অংশ হয় যার মধ্যে ConversionValueRule রিসোর্সের নাম এর conversion_value_rules ফিল্ডে থাকে এবং যার ConversionValueRuleSet স্ট্যাটাস ENABLED-এ সেট করা থাকে। কনভার্সন ভ্যালু সংক্রান্ত নিয়মের সেটের অংশ নয় এমন কনভার্সন ভ্যালু সংক্রান্ত নিয়ম Google Ads UI-তে দেখা যায় না এবং শুধুমাত্র API ব্যবহার করেই ম্যানেজ করা যায়।

অ্যাকাউন্টে আগে থেকেই CUSTOMER-এর attachment_type সহ ConversionValueRuleSet থাকলে, সেটি অ্যাক্টিভ করার জন্য আপনাকে সেই সেটে যেকোনও নতুন কনভার্সন ভ্যালু সংক্রান্ত নিয়ম যোগ করতে হবে। এই ধরনের কোনও কনভার্সন ভ্যালু সংক্রান্ত নিয়মের সেট না থাকলে, আপনাকে একটি তৈরি করতে হবে এবং নিয়মের সেট তৈরি করুন বিভাগে যেভাবে বর্ণনা করা হয়েছে সেইভাবে আপনার কনভার্সন ভ্যালু সংক্রান্ত নিয়ম এতে যোগ করতে হবে।

বিলিং ও অ্যাকাউন্ট বাজেট পরিষেবা

• শুধুমাত্র মাসিক ইনভয়েসের জন্য কনফিগার করা অ্যাকাউন্টের ক্ষেত্রে মিউটেশন করা যায়।

  এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই সমস্যা সহ বাতিল করা হয়: MUTATE_NOT_ALLOWED.

• পরিবর্তন করার অনুরোধের জন্য শুধুমাত্র ১টি অপারেশন অনুমোদিত।

  এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই সমস্যা সহ বাতিল করা হয়: TOO_MANY_MUTATE_OPERATIONS.

• একই অ্যাকাউন্টের জন্য অ্যাকাউন্ট বাজেট (AccountBudget অথবা AccountBudgetProposal) পরিবর্তন করার মধ্যে আপনাকে অন্তত ১২ ঘণ্টা অপেক্ষা করতে হবে। ১২ ঘণ্টা পার হওয়ার আগে পরিবর্তন করলে, তা পুনরুদ্ধার করা যাবে না এবং আপনার Google Ads অ্যাকাউন্ট প্রতিনিধিকেই তা সমাধান করতে হবে।

গ্রাহক অ্যাকাউন্টে আমন্ত্রণ

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

• একই ক্লায়েন্ট অ্যাকাউন্টের জন্য ব্যবহারকারীরা একাধিক পেন্ডিং আমন্ত্রণ পেতে পারবেন না। কোনও ব্যবহারকারীর কাছে আগে থেকেই একটি আমন্ত্রণ পেন্ডিং থাকলে, তাকে আবার আমন্ত্রণ পাঠানোর অনুরোধ করা হলে, এই সমস্যাটি দেখা যায়: EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.

• ক্লায়েন্ট অ্যাকাউন্টে একবারে ৭০টির বেশি আমন্ত্রণ পেন্ডিং থাকতে পারে না। এই ভ্যালু অতিক্রম করে গেছে এমন কোনও অনুরোধ পাঠানো হলে, এই সমস্যা দেখানো হয়: PENDING_INVITATIONS_LIMIT_EXCEEDED.

ব্যবহারকারীর ডেটা

UserDataService এবং OfflineUserDataJobService-এর মাধ্যমে ব্যবহারকারীর ডেটা ম্যানেজ করা হয়।

মনে রাখবেন: ১ এপ্রিল, ২০২৬ থেকে, নতুন ব্যবহারকারীদের (ফেরত আসা NotAllowlistedError.CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE) জন্য কাস্টমার ম্যাচের UserDataService ও OfflineUserDataJobService ফিচার সীমিত করা হয়েছে। নতুন কাস্টমার ম্যাচ ইন্টিগ্রেশনকে অবশ্যই ডেটা ম্যানেজার API ব্যবহার করতে হবে।

create বা remove অপারেশনে প্রতিটি UserData অবজেক্ট একজন গ্রাহকের সাথে সম্পর্কিত। একটি UserData অবজেক্টের মধ্যে user_identifiers ফিল্ডে সর্বাধিক ২০টি শনাক্তকারী থাকতে পারে। একটি UserData অবজেক্টে এই সীমা অতিক্রম করলে OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS বা UserDataError.TOO_MANY_USER_IDENTIFIERS সমস্যা হবে।

২০টির বেশি শনাক্তকারী সহ ব্যবহারকারীদের হ্যান্ডেল করুন

কোনও একজন গ্রাহকের ২০টির বেশি শনাক্তকারী থাকলে, আপনাকে সেগুলি আপলোড করতে হবে, আপনাকে এইসব শনাক্তকারী একাধিক UserData অবজেক্টে ডিস্ট্রিবিউট করতে হবে। Google যাতে এইসব শনাক্তকারীকে একই ব্যবহারকারীর সাথে অ্যাসোসিয়েট করতে পারে তা নিশ্চিত করতে, সেই ব্যবহারকারীর প্রতিটি UserData অবজেক্টে অন্তত একটি সাধারণ user_identifier থাকতে হবে, যেমন একই hashed_email, hashed_phone_number বা third_party_user_id. Google এই শেয়ার করা শনাক্তকারী ব্যবহার করে আলাদা UserData অপারেশন থেকে পাওয়া তথ্য সঠিক গ্রাহক প্রোফাইলের সাথে লিঙ্ক ও মার্জ করে।

আপনি যদি হ্যাশ করা ইমেল বা ফোন নম্বরের মতো PII-এর উপর নির্ভর করেন, তাহলে নিশ্চিত করুন যে সেগুলি Google Ads API-এর প্রয়োজনীয়তা (SHA-256, ছোট হাতের অক্ষর, কোনও হোয়াইটস্পেস নেই) অনুযায়ী নরমালাইজ এবং হ্যাশ করা হয়েছে যাতে লিঙ্কেজ ব্যর্থতা প্রতিরোধ করা যায়।

যেমন, কোনও ব্যবহারকারীর ৩০টি ইমেল আইডি থাকলে, আপনি দুটি UserData অবজেক্ট পাঠাতে পারেন যেগুলি একটি সাধারণ third_party_user_id শেয়ার করে (২০টি শনাক্তকারী সীমার মধ্যে থাকতে প্রথম অবজেক্টে thirdPartyUserId প্লাস ইমেল ১ থেকে ১৯ এবং দ্বিতীয়টিতে thirdPartyUserId প্লাস ইমেল ২০ থেকে ৩০):

{
  "userIdentifiers": [
    { "thirdPartyUserId": "user123" },
    { "hashedEmail": "SHA256_OF_EMAIL_1" },
    // Hashed emails 2 through 18 are omitted here.
    { "hashedEmail": "SHA256_OF_EMAIL_19" }
  ]
}

{
  "userIdentifiers": [
    { "thirdPartyUserId": "user123" },
    { "hashedEmail": "SHA256_OF_EMAIL_20" },
    // Hashed emails 21 through 29 are omitted here.
    { "hashedEmail": "SHA256_OF_EMAIL_30" }
  ]
}

একটি AddOfflineUserDataJobOperationsRequest-এ সব অপারেশন জুড়ে user_identifiers-এর মোট সীমা হল ১০০,০০০ (একটি OfflineUserDataJob একাধিক AddOfflineUserDataJobOperationsRequest কল গ্রহণ করতে পারে, প্রতিটি জবের জন্য সর্বাধিক ১,০০০,০০০ অপারেশন সাজেস্ট করা হয়)। UploadUserDataRequest (UserDataService.UploadUserData) ব্যবহার করে সিঙ্ক্রোনাস আপলোডের জন্য, প্রতিটি অনুরোধ সর্বাধিক ১০টি অপারেশন এবং সম্পূর্ণ অনুরোধ জুড়ে ১০০টি user_identifiers-এর মধ্যে সীমাবদ্ধ।

অন্যান্য ধরনের সীমা

কোনও অনুরোধে বারবার দেখানো ফিল্ড, যেমন অপারেশনের তালিকা, যাতে অনেক আইটেম আছে, তার ফলে এই সমস্যা হতে পারে: REQUEST_SIZE_LIMIT_EXCEEDED. এই একই সমস্যার মেসেজ অন্য সমস্যার কারণেও হতে পারে।

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

GAQL কোয়েরি করার সময়, IN ক্লজের মধ্যে সর্বাধিক ২০,০০০টি আইটেম থাকতে পারে। আপনি সেই সীমা অতিক্রম করলে, একটি FILTER_HAS_TOO_MANY_VALUES সমস্যা দেখানো হবে।