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

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

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

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

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

জিআরপিসি সীমাবদ্ধতা

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

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

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

অনুরোধগুলি পরিবর্তন করুন

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

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

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

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

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

পৃষ্ঠাবদ্ধ অনুরোধগুলি

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

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

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

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

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

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

API ব্যতিক্রমগুলি ফেরত পাঠানোর অনুরোধগুলি

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

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

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

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

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

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

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

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

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

  • KeywordPlanIdeaService.GenerateAdGroupTheme

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

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

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

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

  • AudienceInsightsService.generateAudienceCompositionInsights
  • AudienceInsightsService.generateSuggestedTargetingInsights

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

  • AudienceInsightsService.generateTargetingSuggestionMetrics

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

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

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

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

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

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

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

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

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

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

  এই সীমাবদ্ধতা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যাত হয়: 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 ত্রুটি ফিরে আসবে।