API অনুরোধে সীমা এবং কোটা

এই নথিতে ম্যানেজমেন্ট এপিআই এবং রিপোর্টিং এপিআই অনুরোধ করার সীমা এবং কোটা বর্ণনা করা হয়েছে।

Google Analytics লক্ষ লক্ষ সাইট ব্যবহার করে। আমরা API অনুরোধগুলিতে সীমা এবং কোটা রাখি যাতে সিস্টেমটি পরিচালনা করতে পারে তার চেয়ে বেশি ডেটা গ্রহণ থেকে রক্ষা করতে এবং সিস্টেম সংস্থানগুলির একটি ন্যায়সঙ্গত বন্টন নিশ্চিত করতে। সীমা এবং কোটা পরিবর্তন সাপেক্ষে.

এই ভিডিওটি Google Analytics API অনুরোধ কোটা পরিচালনার জন্য সর্বোত্তম অনুশীলন নিয়ে আলোচনা করে।

সাধারণ কোটার সীমা

নিম্নলিখিত কোটাগুলি ম্যানেজমেন্ট এপিআই , কোর রিপোর্টিং এপিআই v3 , MCF রিপোর্টিং এপিআই , মেটাডেটা এপিআই , ইউজার ডিলিট এপিআই এবং রিয়েল টাইম রিপোর্টিং এপিআই- এর ক্ষেত্রে প্রযোজ্য:

  • প্রতিদিন প্রকল্প প্রতি ৫০,০০০ অনুরোধ, যা বাড়ানো যেতে পারে
  • প্রতি সেকেন্ডে 10টি প্রশ্ন (QPS) প্রতি IP ঠিকানা
    • এপিআই কনসোলে , ব্যবহারকারী প্রতি 100 সেকেন্ডে অনুরোধ হিসাবে উল্লেখ করা একটি অনুরূপ কোটা রয়েছে। ডিফল্টরূপে, এটি প্রতি ব্যবহারকারী প্রতি 100 সেকেন্ডে 100টি অনুরোধে সেট করা হয় এবং সর্বোচ্চ 1,000 মানের সাথে সামঞ্জস্য করা যায়। কিন্তু API-তে অনুরোধের সংখ্যা প্রতি সেকেন্ডে প্রতি ব্যবহারকারী সর্বোচ্চ 10টি অনুরোধের মধ্যে সীমাবদ্ধ।
    • যদি আপনার অ্যাপ্লিকেশনটি একটি একক IP ঠিকানা থেকে সমস্ত API অনুরোধ করে (যেমন, আপনার ব্যবহারকারীদের পক্ষে), প্রতিটি ব্যবহারকারীর জন্য সম্পূর্ণ QPS কোটা পেতে প্রতিটি অনুরোধের সাথে userIP বা quotaUser প্যারামিটার ব্যবহার করুন। বিস্তারিত জানার জন্য স্ট্যান্ডার্ড ক্যোয়ারী প্যারামিটারের সারাংশ দেখুন।

ব্যবস্থাপনা APIs

Google Analytics এই ম্যানেজমেন্ট এপিআই-এর অনুরোধে কোটা প্রয়োগ করে:

এপিআই লিখুন

এই কোটাগুলি লেখার ( insert , update , patch এবং delete ) অনুরোধগুলিতে প্রযোজ্য:

  • প্রতি প্রকল্পে প্রতিদিন 50টি অনুরোধ লিখুন, যা বাড়ানো যেতে পারে
  • অ্যাকাউন্ট আইডি প্রতি সেকেন্ডে 1.5 প্রশ্ন (QPS)

অনুরোধ ত্রুটি লিখুন

যদি আপনার লেখার অনুরোধ ব্যর্থ হয় এবং আপনি একটি রেসপন্স কোড 500 বা 503 পান, আপনি এটি আবার জমা দিতে পারেন। Google Analytics অনুমতি দেয়:

  • প্রতি ঘন্টায় 50টি ব্যর্থ লেখার অনুরোধ।

আপনি যদি প্রতি ঘন্টায় 50 টির বেশি ব্যর্থ লেখার অনুরোধ জমা দেওয়ার চেষ্টা করেন তবে আপনি নিম্নলিখিত ত্রুটিটি পাবেন:

Quota Error: The number of recent failed writes is too high.

একটি ব্যর্থ লেখার অনুরোধ ক্রমাগত পুনরায় জমা দেওয়ার পরিবর্তে, এটি পুনরায় জমা দেওয়ার জন্য সূচকীয় ব্যাকঅফ প্রয়োগ করুন

ডেটা আমদানি API

এই কোটা Uploads সম্পদের জন্য নির্দিষ্ট:

  • লাইফটাইম এক্সটেন্ডেড ডেটা ইম্পোর্ট স্টোরেজ সীমা ( সংগ্রহ API এবং SDK থেকে পাঠানো হিট ডেটার ক্ষেত্রে প্রযোজ্য নয়):
  • সম্পত্তি প্রতি 50 ডেটা সেট
  • প্রতিদিন সম্পত্তি প্রতি 50 আপলোড অপারেশন
  • আপলোড করা ফাইল প্রতি 1 জিবি
  • খরচ ডেটা নির্দিষ্ট সীমা:
    • প্রতি ডেটা সেট প্রতি 100 MB প্রতি তারিখ ( ga:date )। উদাহরণস্বরূপ, যদি আপনি একটি আপলোডে 2014-10-10 এর জন্য 50 এমবি ডেটা এবং একটি সেকেন্ড আপলোডে 2014-10-10-এর জন্য 50 এমবি ডেটা আমদানি করেন, আপনি সেই ডেটা সেটের জন্য 2014-10-10 এর জন্য 100 এমবি সীমাতে পৌঁছেছেন .

এক্সপেরিমেন্ট এপিআই

এই কোটা শুধুমাত্র পরীক্ষায় প্রযোজ্য:

  • প্রতি ভিউ 12টি পরীক্ষা (প্রোফাইল)

নিম্নলিখিত statuses মধ্যে একটি সহ পরীক্ষাগুলি এই কোটার জন্য গণনা করা হয়:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

এক দিনের বেশি পরীক্ষা শেষ হয়েছে (স্থিতি = ENDED ) এই কোটার জন্য গণনা করা হবে না।

নমুনাবিহীন প্রতিবেদন API

এই কোটাগুলি শুধুমাত্র নমুনাবিহীন রিপোর্টগুলিতে প্রযোজ্য:

  • নমুনাবিহীন প্রতিবেদন তৈরি করার জন্য API অনুরোধগুলি সাধারণ লিখার অনুরোধ কোটার সাথে গণনা করা হয়।
  • এপিআই একই প্রতি-সম্পত্তি, প্রতিদিনের টোকেন সিস্টেম ব্যবহার করে যা ওয়েব ইন্টারফেস নমুনাবিহীন প্রতিবেদন তৈরি করতে ব্যবহার করে।
  • অনুমোদিত নমুনাবিহীন রিপোর্টের সর্বাধিক সংখ্যা 3,500। এই সীমায় পৌঁছে গেলে, API এর সাথে আরও নমুনাবিহীন প্রতিবেদন তৈরি করার চেষ্টা করলে নিম্নলিখিত ত্রুটি দেখা দেয়:
    Error creating this entity. You have reached the maximum allowed entities of this type.

ব্যবহারকারীর অনুমতি API

এই কোটা শুধুমাত্র ব্যবহারকারীর অনুমতিগুলিতে প্রযোজ্য:

  • একজন ব্যবহারকারীর সর্বাধিক 100টি Analytics অ্যাকাউন্ট থাকতে পারে। একটি নতুন অ্যাকাউন্টে 100টি অ্যানালিটিক্স অ্যাকাউন্ট আছে এমন একজন ব্যবহারকারীকে যোগ করলে একটি ত্রুটি দেখা দেয়।

নিম্নলিখিত কোটাগুলি ব্যবহারকারীর অনুমতিগুলির জন্য ব্যাচ করা লেখার ( delete , insert , update ) অনুরোধগুলিতে প্রযোজ্য:

  • ব্যাচ অনুরোধ প্রতি 300 ব্যবহারকারীর অনুমতি লিখুন অনুরোধ
  • 30টি ব্যাচড ব্যবহারকারীর অনুমতি লেখার অনুরোধ 1টি লেখার অনুরোধ হিসাবে গণনা করা হয়েছে

কোটার সীমা অতিক্রম করছে

যদি একটি Google Analytics API অনুরোধ করার কোটা অতিক্রম করা হয়, API একটি ত্রুটি কোড 403 বা 429 প্রদান করে এবং একটি বার্তা দেয় যে অ্যাকাউন্টটি কোটা অতিক্রম করেছে৷ আরও তথ্যের জন্য পরিষেবার শর্তাবলী দেখুন।

অতিরিক্ত কোটার জন্য অনুরোধ করা হচ্ছে

আপনি শুধুমাত্র বৃদ্ধি করার জন্য অনুরোধ করতে পারেন:

আপনার প্রকল্পের ব্যবহারের সীমা দেখতে বা পরিবর্তন করতে, বা আপনার কোটা বৃদ্ধির অনুরোধ করতে, নিম্নলিখিতগুলি করুন:

  1. আপনার যদি আপনার প্রকল্পের জন্য ইতিমধ্যে একটি বিলিং অ্যাকাউন্ট না থাকে, তাহলে একটি তৈরি করুন৷
  2. API কনসোলে API লাইব্রেরির সক্ষম APIs পৃষ্ঠায় যান এবং তালিকা থেকে একটি API নির্বাচন করুন।
  3. কোটা-সম্পর্কিত সেটিংস দেখতে এবং পরিবর্তন করতে, কোটা নির্বাচন করুন। ব্যবহারের পরিসংখ্যান দেখতে, ব্যবহার নির্বাচন করুন।

সর্বাধিক কোটার পরিমাণ বৃদ্ধির অনুরোধ করতে, অনুগ্রহ করে Analytics API কোটা অনুরোধ ফর্মটি ব্যবহার করুন৷ অনুরোধ জমা দেওয়ার আগে তথ্য পর্যালোচনা এবং কোটা অনুরোধ ফর্মের নির্দেশাবলী অনুসরণ করা নিশ্চিত করুন। রিপোর্টিং API v4-এর জন্য, Google API কনসোলে API নাম হল Google Analytics রিপোর্টিং API । অন্য সব v3 API (যেমন, ম্যানেজমেন্ট API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) Google API কনসোলে Analytics API-এর অধীনে তালিকাভুক্ত।

কোটা ব্যবস্থাপনা সম্পর্কে আরও তথ্যের জন্য এবং কোটা ব্যবহারের জন্য আপনার আবেদন কীভাবে সূক্ষ্ম-টিউন করবেন, দেখুন APIs এবং ক্যাপিং ব্যবহার

,

এই নথিতে ম্যানেজমেন্ট এপিআই এবং রিপোর্টিং এপিআই অনুরোধ করার সীমা এবং কোটা বর্ণনা করা হয়েছে।

Google Analytics লক্ষ লক্ষ সাইট ব্যবহার করে। আমরা API অনুরোধগুলিতে সীমা এবং কোটা রাখি যাতে সিস্টেমটি পরিচালনা করতে পারে তার চেয়ে বেশি ডেটা গ্রহণ থেকে রক্ষা করতে এবং সিস্টেম সংস্থানগুলির একটি ন্যায়সঙ্গত বন্টন নিশ্চিত করতে। সীমা এবং কোটা পরিবর্তন সাপেক্ষে.

এই ভিডিওটি Google Analytics API অনুরোধ কোটা পরিচালনার জন্য সর্বোত্তম অনুশীলন নিয়ে আলোচনা করে।

সাধারণ কোটার সীমা

নিম্নলিখিত কোটাগুলি ম্যানেজমেন্ট এপিআই , কোর রিপোর্টিং এপিআই v3 , MCF রিপোর্টিং এপিআই , মেটাডেটা এপিআই , ইউজার ডিলিট এপিআই এবং রিয়েল টাইম রিপোর্টিং এপিআই- এর ক্ষেত্রে প্রযোজ্য:

  • প্রতিদিন প্রকল্প প্রতি ৫০,০০০ অনুরোধ, যা বাড়ানো যেতে পারে
  • প্রতি সেকেন্ডে 10টি প্রশ্ন (QPS) প্রতি IP ঠিকানা
    • এপিআই কনসোলে , ব্যবহারকারী প্রতি 100 সেকেন্ডে অনুরোধ হিসাবে উল্লেখ করা একটি অনুরূপ কোটা রয়েছে। ডিফল্টরূপে, এটি প্রতি ব্যবহারকারী প্রতি 100 সেকেন্ডে 100টি অনুরোধে সেট করা হয় এবং সর্বোচ্চ 1,000 মানের সাথে সামঞ্জস্য করা যায়। কিন্তু API-তে অনুরোধের সংখ্যা প্রতি সেকেন্ডে প্রতি ব্যবহারকারী সর্বোচ্চ 10টি অনুরোধের মধ্যে সীমাবদ্ধ।
    • যদি আপনার অ্যাপ্লিকেশনটি একটি একক IP ঠিকানা থেকে সমস্ত API অনুরোধ করে (যেমন, আপনার ব্যবহারকারীদের পক্ষে), প্রতিটি ব্যবহারকারীর জন্য সম্পূর্ণ QPS কোটা পেতে প্রতিটি অনুরোধের সাথে userIP বা quotaUser প্যারামিটার ব্যবহার করুন। বিস্তারিত জানার জন্য স্ট্যান্ডার্ড ক্যোয়ারী প্যারামিটারের সারাংশ দেখুন।

ব্যবস্থাপনা APIs

Google Analytics এই ম্যানেজমেন্ট এপিআই-এর অনুরোধে কোটা প্রয়োগ করে:

এপিআই লিখুন

এই কোটাগুলি লেখার ( insert , update , patch এবং delete ) অনুরোধগুলিতে প্রযোজ্য:

  • প্রতি প্রকল্পে প্রতিদিন 50টি অনুরোধ লিখুন, যা বাড়ানো যেতে পারে
  • অ্যাকাউন্ট আইডি প্রতি সেকেন্ডে 1.5 প্রশ্ন (QPS)

অনুরোধ ত্রুটি লিখুন

যদি আপনার লেখার অনুরোধ ব্যর্থ হয় এবং আপনি একটি রেসপন্স কোড 500 বা 503 পান, আপনি এটি আবার জমা দিতে পারেন। Google Analytics অনুমতি দেয়:

  • প্রতি ঘন্টায় 50টি ব্যর্থ লেখার অনুরোধ।

আপনি যদি প্রতি ঘন্টায় 50 টির বেশি ব্যর্থ লেখার অনুরোধ জমা দেওয়ার চেষ্টা করেন তবে আপনি নিম্নলিখিত ত্রুটিটি পাবেন:

Quota Error: The number of recent failed writes is too high.

একটি ব্যর্থ লেখার অনুরোধ ক্রমাগত পুনরায় জমা দেওয়ার পরিবর্তে, এটি পুনরায় জমা দেওয়ার জন্য সূচকীয় ব্যাকঅফ প্রয়োগ করুন

ডেটা আমদানি API

এই কোটা Uploads সম্পদের জন্য নির্দিষ্ট:

  • লাইফটাইম এক্সটেন্ডেড ডেটা ইম্পোর্ট স্টোরেজ সীমা ( সংগ্রহ API এবং SDK থেকে পাঠানো হিট ডেটার ক্ষেত্রে প্রযোজ্য নয়):
  • সম্পত্তি প্রতি 50 ডেটা সেট
  • প্রতিদিন সম্পত্তি প্রতি 50 আপলোড অপারেশন
  • আপলোড করা ফাইল প্রতি 1 জিবি
  • খরচ ডেটা নির্দিষ্ট সীমা:
    • প্রতি ডেটা সেট প্রতি 100 MB প্রতি তারিখ ( ga:date )। উদাহরণস্বরূপ, যদি আপনি একটি আপলোডে 2014-10-10 এর জন্য 50 এমবি ডেটা এবং একটি সেকেন্ড আপলোডে 2014-10-10-এর জন্য 50 এমবি ডেটা আমদানি করেন, আপনি সেই ডেটা সেটের জন্য 2014-10-10 এর জন্য 100 এমবি সীমাতে পৌঁছেছেন .

এক্সপেরিমেন্ট এপিআই

এই কোটা শুধুমাত্র পরীক্ষায় প্রযোজ্য:

  • প্রতি ভিউ 12টি পরীক্ষা (প্রোফাইল)

নিম্নলিখিত statuses মধ্যে একটি সহ পরীক্ষাগুলি এই কোটার জন্য গণনা করা হয়:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

এক দিনের বেশি পরীক্ষা শেষ হয়েছে (স্থিতি = ENDED ) এই কোটার জন্য গণনা করা হবে না।

নমুনাবিহীন প্রতিবেদন API

এই কোটাগুলি শুধুমাত্র নমুনাবিহীন রিপোর্টগুলিতে প্রযোজ্য:

  • নমুনাবিহীন প্রতিবেদন তৈরি করার জন্য API অনুরোধগুলি সাধারণ লিখার অনুরোধ কোটার সাথে গণনা করা হয়।
  • এপিআই একই প্রতি-সম্পত্তি, প্রতিদিনের টোকেন সিস্টেম ব্যবহার করে যা ওয়েব ইন্টারফেস নমুনাবিহীন প্রতিবেদন তৈরি করতে ব্যবহার করে।
  • অনুমোদিত নমুনাবিহীন রিপোর্টের সর্বাধিক সংখ্যা 3,500। এই সীমায় পৌঁছে গেলে, API এর সাথে আরও নমুনাবিহীন প্রতিবেদন তৈরি করার চেষ্টা করলে নিম্নলিখিত ত্রুটি দেখা দেয়:
    Error creating this entity. You have reached the maximum allowed entities of this type.

ব্যবহারকারীর অনুমতি API

এই কোটা শুধুমাত্র ব্যবহারকারীর অনুমতিগুলিতে প্রযোজ্য:

  • একজন ব্যবহারকারীর সর্বাধিক 100টি Analytics অ্যাকাউন্ট থাকতে পারে। একটি নতুন অ্যাকাউন্টে 100টি অ্যানালিটিক্স অ্যাকাউন্ট আছে এমন একজন ব্যবহারকারীকে যোগ করলে একটি ত্রুটি দেখা দেয়।

নিম্নলিখিত কোটাগুলি ব্যবহারকারীর অনুমতিগুলির জন্য ব্যাচ করা লেখার ( delete , insert , update ) অনুরোধগুলিতে প্রযোজ্য:

  • ব্যাচ অনুরোধ প্রতি 300 ব্যবহারকারীর অনুমতি লিখুন অনুরোধ
  • 30টি ব্যাচড ব্যবহারকারীর অনুমতি লেখার অনুরোধ 1টি লেখার অনুরোধ হিসাবে গণনা করা হয়েছে

কোটার সীমা অতিক্রম করছে

যদি একটি Google Analytics API অনুরোধ করার কোটা অতিক্রম করা হয়, API একটি ত্রুটি কোড 403 বা 429 প্রদান করে এবং একটি বার্তা দেয় যে অ্যাকাউন্টটি কোটা অতিক্রম করেছে৷ আরও তথ্যের জন্য পরিষেবার শর্তাবলী দেখুন।

অতিরিক্ত কোটার জন্য অনুরোধ করা হচ্ছে

আপনি শুধুমাত্র বৃদ্ধি করার জন্য অনুরোধ করতে পারেন:

আপনার প্রকল্পের ব্যবহারের সীমা দেখতে বা পরিবর্তন করতে, বা আপনার কোটা বৃদ্ধির অনুরোধ করতে, নিম্নলিখিতগুলি করুন:

  1. আপনার যদি আপনার প্রকল্পের জন্য ইতিমধ্যে একটি বিলিং অ্যাকাউন্ট না থাকে, তাহলে একটি তৈরি করুন৷
  2. API কনসোলে API লাইব্রেরির সক্ষম APIs পৃষ্ঠায় যান এবং তালিকা থেকে একটি API নির্বাচন করুন।
  3. কোটা-সম্পর্কিত সেটিংস দেখতে এবং পরিবর্তন করতে, কোটা নির্বাচন করুন। ব্যবহারের পরিসংখ্যান দেখতে, ব্যবহার নির্বাচন করুন।

সর্বাধিক কোটার পরিমাণ বৃদ্ধির অনুরোধ করতে, অনুগ্রহ করে Analytics API কোটা অনুরোধ ফর্মটি ব্যবহার করুন৷ অনুরোধ জমা দেওয়ার আগে তথ্য পর্যালোচনা এবং কোটা অনুরোধ ফর্মের নির্দেশাবলী অনুসরণ করা নিশ্চিত করুন। রিপোর্টিং API v4-এর জন্য, Google API কনসোলে API নাম হল Google Analytics রিপোর্টিং API । অন্য সব v3 API (যেমন, ম্যানেজমেন্ট API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) Google API কনসোলে Analytics API-এর অধীনে তালিকাভুক্ত।

কোটা ব্যবস্থাপনা সম্পর্কে আরও তথ্যের জন্য এবং কোটা ব্যবহারের জন্য আপনার আবেদন কীভাবে সূক্ষ্ম-টিউন করবেন, দেখুন APIs এবং ক্যাপিং ব্যবহার