সীমা ও কোটা

Data Manager API-এর সাথে কাজ করার সময় সীমা ও কোটা সম্পর্কে বুঝতে এই নির্দেশিকা অনুসরণ করুন।

প্রোজেক্টের সীমা

ডেটা ম্যানেজার API ব্যবহার করার জন্য আপনার একটি Google Cloud প্রোজেক্ট থাকতে হবে। Google Cloud প্রোজেক্ট OAuth ক্লায়েন্ট ও ক্রেডেনশিয়াল প্রদান করে যা আপনি API অনুরোধ যাচাই করতে ব্যবহার করেন।

ডেটা ম্যানেজার API প্রতিটি Google Cloud প্রোজেক্টে রেট লিমিট প্রয়োগ করে, যা পরিষেবা এবং অপারেশনের ধরন (রিড বনাম মিউটেট) অনুযায়ী আলাদা করা হয়:

পরিষেবা	অপারেশন	প্রতিদিন কতগুলি অনুরোধ করা যাবে	প্রতি মিনিটে অনুরোধ
IngestionService	পরিবর্তন (লিখুন)	১০০,০০০	৩০০
IngestionService	পড়ুন	১০০,০০০	৩০০
অন্যান্য সব পরিষেবা একসাথে	পরিবর্তন (লিখুন)	৫০,০০০	৩০০
অন্যান্য সব পরিষেবা একসাথে	পড়ুন	৫০,০০০	৩০০

সীমা অতিক্রম করা অনুরোধগুলি RESOURCE_EXHAUSTED সমস্যার কারণে এবং HTTP স্ট্যাটাস 429 Too Many Requests-এর জন্য বাতিল করা হয়।

আপনি নিজের অ্যাপের নিয়ন্ত্রণ নিতে পারেন এবং সক্রিয়ভাবে অনুরোধের সংখ্যা কমিয়ে এবং ক্লায়েন্ট সাইড থেকে QPS থ্রটল করে রেট লিমিট কমাতে পারেন। এছাড়াও, আপনার অ্যাপ্লিকেশন তার সীমায় পৌঁছানোর আগে বিজ্ঞপ্তি পেতে, আপনি Google Cloud কনসোলে কোটা সংক্রান্ত সতর্কতা ও মনিটর করার সুবিধা সেট-আপ করতে পারবেন।

কোটার নাম

প্রতিটি সীমা Google Cloud-এ কোটা সীমা নাম এবং মেট্রিকের সাথে সম্পর্কিত। কোনও অনুরোধ সীমা অতিক্রম করলে, Data Manager API ErrorInfo স্ট্যান্ডার্ড ডিটেল পে-লোডে কোটা সীমার নাম metadata.quota_limit-এর অধীনে ফেরত দেয়:

কোটার সীমা সম্পর্কিত নাম	পরিষেবা	অপারেশন	উইন্ডো	সীমা
IngestionMutateRequestsPerDayPerProject	IngestionService	পরিবর্তন করুন	দিন	১০০,০০০
IngestionMutateRequestsPerMinutePerProject	IngestionService	পরিবর্তন করুন	মিনিট	৩০০
IngestionReadRequestsPerDayPerProject	IngestionService	পড়ুন	দিন	১০০,০০০
IngestionReadRequestsPerMinutePerProject	IngestionService	পড়ুন	মিনিট	৩০০
ManagementMutateRequestsPerDayPerProject	অন্য সব পরিষেবা	পরিবর্তন করুন	দিন	৫০,০০০
ManagementMutateRequestsPerMinutePerProject	অন্য সব পরিষেবা	পরিবর্তন করুন	মিনিট	৩০০
ManagementReadRequestsPerDayPerProject	অন্য সব পরিষেবা	পড়ুন	দিন	৫০,০০০
ManagementReadRequestsPerMinutePerProject	অন্য সব পরিষেবা	পড়ুন	মিনিট	৩০০

দৈনিক এবং প্রতি মিনিটের সীমা সংক্রান্ত সমস্যার মধ্যে পার্থক্য করতে এবং সাময়িকভাবে পজ করে ব্যাকঅফ সহ আবার চেষ্টা করবেন নাকি দৈনিক কোটা রিসেট না হওয়া পর্যন্ত পজ করবেন তা নির্ধারণ করতে ErrorInfo পেলোডে metadata.quota_limit চেক করুন। বিস্তারিত জানতে, কোটা ও রেট লিমিট সংক্রান্ত সমস্যা দেখুন।

রেট লিমিট ও কনকারেন্সি ম্যানেজ করা

প্রজেক্ট কোটা অতিক্রম না করে থ্রুপুট সর্বাধিক করতে, এই নির্দেশিকাগুলি অনুসরণ করুন:

• প্রতি অনুরোধে ব্যাচ রেকর্ড: প্রতিটি অনুরোধে অনুরোধের সীমা (প্রতি অনুরোধে সর্বাধিক ১০,০০০ AudienceMember রিসোর্স বা ২,০০০ Event রিসোর্স) পর্যন্ত যতগুলি সম্ভব রেকর্ড অন্তর্ভুক্ত করুন।

• একসাথে সর্বাধিক ১০টি অনুরোধ পাঠান: প্রতি মিনিটে ৩০০টি অনুরোধের সীমা অতিক্রম না করে মোট ইনজেশন টাইম কমাতে, IngestionService-এ একসাথে সর্বাধিক ১০টি অনুরোধ পাঠান।

• ব্যাকঅফ সহ প্রতি-মিনিট রেট সীমা আবার চেষ্টা করুন: যদি কোনও অনুরোধ RESOURCE_EXHAUSTED (HTTP 429) এবং metadata.quota_limit প্রতি-মিনিট সীমা নির্দেশ করে (যেমন IngestionMutateRequestsPerMinutePerProject), জিটার সহ এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে আবার চেষ্টা করুন (যেমন, আবার চেষ্টা করার মধ্যে ১ সেকেন্ড, ২ সেকেন্ড এবং ৪ সেকেন্ড অপেক্ষা করা)।

• দৈনিক কোটা শেষ হয়ে গেলে পজ করা: metadata.quota_limit যদি দৈনিক সীমা (যেমন IngestionMutateRequestsPerDayPerProject) নির্দেশ করে, তাহলে অবিলম্বে আবার চেষ্টা করবেন না। প্যাসিফিক টাইম অনুযায়ী মধ্যরাতে দৈনিক কোটা রিসেট না হওয়া পর্যন্ত অনুরোধ পজ করুন।

অনুরোধের সীমা

নির্দিষ্ট অনুরোধের ক্ষেত্রে সীমা এখানে দেওয়া হল:

• IngestAudienceMembersRequest এবং RemoveAudienceMembersRequest:

  • audience_members তালিকায় ১০,০০০ AudienceMember রিসোর্স

  • AudienceMember-এর জন্য UserData-এ ১০টি ইউজার আইডেন্টিফায়ার

  • destinations তালিকায় ১০টি Destination রিসোর্স

• RemoveAllAudienceMembersRequest:

  • destinations তালিকায় ১০টি Destination রিসোর্স

• IngestEventsRequest:

  • events তালিকায় Event-এর ২,০০০টি রিসোর্স

  • Event-এর জন্য UserData-এ ১০টি ইউজার আইডেন্টিফায়ার

  • destinations তালিকায় ১০টি Destination রিসোর্স