API সীমা এবং কোটা

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

Request Type, Limitation, and Error Code
Operations with Explorer Access level	উৎপাদন অ্যাকাউন্টের বিপরীতে প্রতিদিন ২,৮৮০টি API অপারেশন পরীক্ষামূলক অ্যাকাউন্টের বিপরীতে প্রতিদিন ১৫,০০০ API অপারেশন	RESOURCE_EXHAUSTED
Operations with Basic Access level	পরীক্ষা এবং উৎপাদন উভয় অ্যাকাউন্টের বিপরীতে প্রতিদিন ১৫,০০০ API অপারেশন	RESOURCE_EXHAUSTED
Mutate requests	10,000 operations per request	TOO_MANY_MUTATE_OPERATIONS
Planning Service requests	১ কিউপিএস	RESOURCE_EXHAUSTED
Conversion Upload Service requests	2,000 conversions per request	TOO_MANY_CONVERSIONS_IN_REQUEST
Billing and Account Budget Service requests	1 operation per mutate request	TOO_MANY_MUTATE_OPERATIONS

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

দৈনিক API ব্যবহারের সীমা প্রতিটি ডেভেলপার টোকেনের জন্য করা API অপারেশনের সংখ্যার উপর নির্ভর করে। API অপারেশন হল get request এবং mutate অপারেশনের মোট যোগফল। দৈনিক API অপারেশনের সীমা ডেভেলপার টোকেনের অ্যাক্সেস লেভেলের উপর নির্ভর করে। অ্যাক্সেস লেভেল এবং অনুমতিযোগ্য ব্যবহারের নির্দেশিকা প্রতিটি অ্যাক্সেস লেভেলের জন্য নির্দিষ্ট API অপারেশন সীমার রূপরেখা দেয়।

এই সীমা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যান করা হয়: RESOURCE_EXHAUSTED ।

gRPC limitations

সমস্ত Google Ads API ক্লায়েন্ট লাইব্রেরি অনুরোধ এবং প্রতিক্রিয়া তৈরি করার জন্য gRPC ব্যবহার করে। ডিফল্টরূপে, gRPC-এর বার্তার আকার 4 MB, কিন্তু আমাদের ক্লায়েন্ট লাইব্রেরিগুলি দক্ষতা বৃদ্ধির জন্য সর্বাধিক বার্তার আকার 64 MB নির্ধারণ করে।

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

এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি GoogleAdsError তৈরি করবে না , বরং একটি 429 Resource Exhausted gRPC ত্রুটি তৈরি করবে। gRPC ত্রুটি কোড এবং বার্তাগুলির তালিকা দেখুন।

Mutate requests

ব্যবহারকারীর দৈনিক অপারেশন কোটার সাথে গণনা করা ছাড়াও, একটি মিউটেট অনুরোধে প্রতি অনুরোধে ১০,০০০ এর বেশি অপারেশন থাকতে পারে না।

এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যান করা হয়: TOO_MANY_MUTATE_OPERATIONS ।

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

Search requests

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

Paginated requests

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

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

Other types of requests

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

A few examples of such requests include:

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

Requests that return API exceptions

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

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

Keyword planning service

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

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

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

  এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যান করা হয়: RESOURCE_EXHAUSTED ।

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

• Limited to 2 requests per second per CID:

  • KeywordPlanIdeaService.GenerateAdGroupTheme

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

Keyword Plan Object	Maximum Number
KeywordPlan per account	১০,০০০
KeywordPlanAdGroup per KeywordPlan	২০০
KeywordPlanAdGroupKeyword প্রতি KeywordPlan	১০,০০০
KeywordPlanCampaignKeyword (negative keywords)	১,০০০
KeywordPlanCampaign per KeywordPlan	১

শ্রোতা অন্তর্দৃষ্টি পরিষেবা

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

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

  • AudienceInsightsService.generateAudienceCompositionInsights
  • AudienceInsightsService.generateSuggestedTargetingInsights

• প্রতিটি ডেভেলপার টোকেন প্রতি সেকেন্ডে 2টি অনুরোধের মধ্যে সীমাবদ্ধ:

  • AudienceInsightsService.generateTargetingSuggestionMetrics

Conversion upload service

• প্রতি অনুরোধে ২০০০টি কল বা ক্লিক রূপান্তরের মধ্যে সীমাবদ্ধ:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  এই সীমা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যান করা হয়: TOO_MANY_CONVERSIONS_IN_REQUEST ।

রূপান্তর সমন্বয় আপলোড পরিষেবা

• প্রতি অনুরোধে 2,000টি রূপান্তর সমন্বয়ের মধ্যে সীমাবদ্ধ:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  এই সীমা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যান করা হয়: TOO_MANY_ADJUSTMENTS_IN_REQUEST ।

রূপান্তর মানের নিয়ম

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

  এই সীমা লঙ্ঘনকারী অনুরোধগুলি ResourceCountLimitExceededError.ACCOUNT_LIMIT ত্রুটি সহ প্রত্যাখ্যাত হয়।

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

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

Billing and account budget services

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

  এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যাত হয়: MUTATE_NOT_ALLOWED ।

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

  এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যান করা হয়: TOO_MANY_MUTATE_OPERATIONS ।

• একই অ্যাকাউন্টে বাজেট অর্ডার পরিবর্তনের মধ্যে আপনার কমপক্ষে ১২ ঘন্টা অপেক্ষা করা উচিত। ১২ ঘন্টা অতিবাহিত হওয়ার আগে পরিবর্তন করলে অপূরণীয় ব্যর্থতা দেখা দিতে পারে যা কেবলমাত্র আপনার Google বিজ্ঞাপন অ্যাকাউন্ট প্রতিনিধির দ্বারা সমাধান করা যেতে পারে।

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

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

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

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

ব্যবহারকারীর তথ্য

ব্যবহারকারীর ডেটা UserDataService এবং OfflineUserDataJobService দিয়ে পরিচালিত হয়। একটি নির্দিষ্ট create or remove UserData অপারেশনে, user_identifiers এর প্রতিটি সেট একটি একক ব্যবহারকারীর জন্য নির্দিষ্ট হওয়া উচিত।

এটি কার্যকর করার জন্য, একটি UserData সেটে ২০ টিরও বেশি user_identifiers থাকলে একটি OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS অথবা UserDataError.TOO_MANY_USER_IDENTIFIERS ত্রুটি ফেরত পাঠানো হয়।

অপারেশনের সংখ্যা নির্বিশেষে আপনাকে সর্বাধিক ১০০,০০০ ব্যবহারকারী শনাক্তকারী ব্যবহার করার অনুমতি দেওয়া হবে।

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

একটি পুনরাবৃত্তি করা ক্ষেত্র, যেমন ক্রিয়াকলাপের তালিকা, যেখানে অনুরোধে অনেকগুলি আইটেম থাকে, তা ত্রুটির কারণ হতে পারে: REQUEST_SIZE_LIMIT_EXCEEDED । এই একই ত্রুটি বার্তা অন্যান্য সমস্যার কারণেও হতে পারে।

যদি আপনি এই সীমাবদ্ধতার সম্মুখীন হন এবং পুনরাবৃত্তিমূলক ক্ষেত্র ব্যবহার করে অনুরোধ করেন, তাহলে একটি মিউটেট অনুরোধে ক্রিয়াকলাপের একটি তালিকা স্থাপন করে পুনরাবৃত্তিমূলক ক্ষেত্রটিতে আইটেমের সংখ্যা হ্রাস করার চেষ্টা করুন।

GAQL কোয়েরি তৈরি করার সময়, একটি IN ক্লজের মধ্যে আইটেমের সর্বাধিক সংখ্যা 20,000। যদি আপনি সেই সীমা অতিক্রম করেন, তাহলে একটি FILTER_HAS_TOO_MANY_VALUES ত্রুটি ফিরে আসবে।