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

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

সতর্কতা: পান পদ্ধতি আর সমর্থিত নয়। পরিবর্তে বস্তু পুনরুদ্ধার করতে searchStream বা search ব্যবহার করুন।

অনুরোধের ধরন, সীমাবদ্ধতা এবং ত্রুটি কোড
পৃষ্ঠাসংক্রান্ত অনুরোধ	প্রতি পৃষ্ঠায় 10,000 সারি	INVALID_PAGE_SIZE
বেসিক অ্যাক্সেস সহ অপারেশন	প্রতিদিন 15,000 API অপারেশন	RESOURCE_EXHAUSTED
মিউটেট অনুরোধ	অনুরোধ প্রতি 10,000 অপারেশন	TOO_MANY_MUTATE_OPERATIONS
পরিকল্পনা সেবা অনুরোধ	1 QPS	RESOURCE_EXHAUSTED
রূপান্তর আপলোড পরিষেবা অনুরোধ	অনুরোধ প্রতি 2,000 রূপান্তর	TOO_MANY_CONVERSIONS_IN_REQUEST
বিলিং এবং অ্যাকাউন্ট বাজেট পরিষেবার অনুরোধ	প্রতি মিউটেটের অনুরোধে ১টি অপারেশন	TOO_MANY_MUTATE_OPERATIONS

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

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

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

gRPC সীমাবদ্ধতা

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

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

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

মিউটেট অনুরোধ

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

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

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

অনুসন্ধান অনুরোধ

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

পৃষ্ঠাসংক্রান্ত অনুরোধ

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

যে অনুরোধগুলি পৃষ্ঠাযুক্ত, যেমন অনুসন্ধানের অনুরোধগুলি, এছাড়াও Page size cannot exceed 10,000 rows এবং যদি এটি এই সীমা লঙ্ঘন করে তাহলে প্রত্যাখ্যান করা হয়, ত্রুটি সহ: INVALID_PAGE_SIZE ।

পেজিনেশন সম্পর্কে আরো বিস্তারিত জানার জন্য, ফলাফলের মাধ্যমে পেজিং দেখুন।

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

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

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

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

অনুরোধ যেগুলি API ব্যতিক্রমগুলি ফেরত দেয়৷

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

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

পরিকল্পনা সেবা

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

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

  • KeywordPlanService.GetKeywordPlan
  • KeywordPlanService.GenerateHistoricalMetrics
  • KeywordPlanService.GenerateForecastMetrics

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

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

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

কীওয়ার্ড প্ল্যান অবজেক্ট	সর্বোচ্চ সংখ্যা
অ্যাকাউন্ট প্রতি KeywordPlan	10,000
KeywordPlanAdGroup প্রতি KeywordPlan	200
KeywordPlanAdGroupKeyword প্রতি KeywordPlan	10,000
KeywordPlanCampaignKeyword (নেতিবাচক কীওয়ার্ড)	1,000
KeywordPlan প্রতি KeywordPlan KeywordPlanCampaign	1

রূপান্তর আপলোড পরিষেবা

• অনুরোধ প্রতি 2,000 কল বা ক্লিক রূপান্তর সীমিত:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

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

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

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

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

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

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

• মিউটেটগুলি শুধুমাত্র মাসিক চালানের জন্য কনফিগার করা অ্যাকাউন্টগুলির বিরুদ্ধে করা যেতে পারে।

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

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

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

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

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

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

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

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

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

ব্যবহারকারীর ডেটা UserDataService এবং OfflineUserDataJobService দিয়ে পরিচালিত হয়। একটি প্রদত্ত UserData ক্রিয়াকলাপ তৈরি/মুছে ফেলতে, user_identifiers এর প্রতিটি সেট একটি একক ব্যবহারকারীর জন্য নির্দিষ্ট হওয়া উচিত।

এটি কার্যকর করার জন্য, একটি UserData সেটে 20 টির বেশি 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 ত্রুটি ফেরত দেওয়া হবে৷