بما أنّ Google Sheets API هي خدمة مشتركة، نطبّق الحصص والقيود التأكد من استخدامه بشكل عادل من قبل جميع المستخدمين ولحماية البيانات لسلامة نظام Google Workspace.
حدود الحصة
على الرغم من أنّ Sheets API لا يفرضان حدودًا على الحجم الثابت لطلب بيانات من واجهة برمجة التطبيقات، قد يواجه المستخدمون حدودًا من مكوّنات معالجة مختلفة لا تتحكّم فيها "جداول بيانات Google". لتسريع الطلبات، تنصح Google بتحميل بيانات أساسية بحجم 2 ميغابايت كحد أقصى.
توفّر واجهة Sheets API حصصًا في الدقيقة، وتتم إعادة تعبئتها كل دقيقة. على سبيل المثال، هناك حدّ أقصى لطلبات القراءة يبلغ 300 طلب في الدقيقة لكل مشروع.
إذا أرسل تطبيقك 350 طلبًا في دقيقة واحدة، ستتجاوز الطلبات الـ 50 الإضافية الحصة ويتم إنشاء
استجابة رمز حالة HTTP 429: Too many requests. إذا حدث هذا، يجب عليك استخدام
خوارزمية التراجع الأسي. بعد دقيقة واحدة،
تنفيذ الطلبات مرة أخرى. يمكن للمستخدمين إرسال طلبات متعددة في الوقت نفسه، شرط ألا تتجاوز الحصة المسموح بها.
يتم تطبيق جميع طلبات "جداول بيانات Google" على نحو ذري. ويعني ذلك أنّه إذا كان أي طلب غير صالح، لن ينجح التعديل بأكمله ولن يتم تطبيق أي من التغييرات (التي يحتمل أن تكون تابعة).
يوضّح الجدول التالي تفاصيل حدود الطلبات. شريطة بقاءك ضمن الحصص لكل دقيقة، فلا توجد تحديد عدد الطلبات التي يمكنك تقديمها في اليوم.
| الحصص | |||||
|---|---|---|---|---|---|
| قراءة الطلبات |
|
||||
| كتابة الطلبات |
|
||||
للحصول على تفاصيل عن حدود الملفات، انتقِل إلى مقالة الملفات التي يمكنك تخزينها في Google Drive.
حل أخطاء الحصة المستندة إلى الوقت
بالنسبة إلى جميع الأخطاء التي تستند إلى الوقت (بحد أقصى N طلب لكل X دقيقة)، نوصي يكتشف الرمز الاستثناء ويستخدم رقود أسي مقتطع للتأكد من الأجهزة لا تتسبب في حمل زائد.
"الرقود الأسي" هو استراتيجية قياسية للتعامل مع الأخطاء في تطبيقات الشبكة. إنّ تعيد خوارزمية التراجع الأسي معالجة الطلبات من خلال زيادة أوقات الانتظار المتزايدة بشكل كبير بين الطلبات، وصولاً إلى أقصى وقت للتراجع. إذا استمرت الطلبات غير ناجحة، أهمية زيادة التأخيرات بين الطلبات بمرور الوقت حتى يتم قبول الطلب.
مثال على الخوارزمية
تعيد خوارزمية التراجع الأسي محاولة الطلبات بشكل متزايد، مما يزيد من وقت الانتظار بين مرات إعادة المحاولة وحتى أقصى وقت للتراجع. مثلاً:
- يمكنك تقديم طلب إلى Google Sheets API.
- في حال عدم نجاح الطلب، يُرجى الانتظار 1 +
random_number_millisecondsثم إعادة المحاولة. الطلب. - في حال عدم نجاح الطلب، يُرجى الانتظار إلى الرقم 2 +
random_number_millisecondsثم إعادة المحاولة. الطلب. - في حال تعذّر الطلب، يُرجى الانتظار 4 +
random_number_millisecondsثم إعادة المحاولة. الطلب. - وهكذا، وما يصل إلى مرة واحدة (
maximum_backoff). - مواصلة الانتظار وإعادة المحاولة حتى الحدّ الأقصى المسموح به لعدد مرّات إعادة المحاولة، بدون زيادة مدة الانتظار الفترة بين إعادات المحاولة.
حيث:
- يبلغ وقت الانتظار
min(((2^n)+random_number_milliseconds), maximum_backoff)، مع زيادةnبمقدار 1 لكل تكرار (طلب). random_number_millisecondsعبارة عن عدد عشوائي بالمللي ثانية أقل من أو تساوي 1000. ويساعد ذلك في تجنب الحالات التي تتم فيها مزامنة العديد من البرامج بواسطة بعض المواقف وإعادة المحاولة دفعة واحدة، وإرسال الطلبات في أوقات متزامنة أمواج. تتم إعادة احتساب قيمةrandom_number_millisecondsبعد كل قيمة إعادة محاولة الطلب.- تتراوح مدة
maximum_backoffعادةً بين 32 أو 64 ثانية. يجب أن تكون القيمة المناسبة حسب حالة الاستخدام.
يمكن للعميل مواصلة إعادة المحاولة بعد الوصول إلى وقت maximum_backoff.
ولا تحتاج إعادة المحاولة بعد هذه المرحلة إلى الاستمرار في زيادة وقت التراجع. بالنسبة
على سبيل المثال، إذا استخدم العميل وقت maximum_backoff من 64 ثانية، بعد الوصول إلى
هذه القيمة، فيمكن للعميل إعادة المحاولة كل 64 ثانية. في مرحلة ما،
يجب منع العملاء من إعادة المحاولة إلى أجل غير مسمى.
يعتمد وقت الانتظار بين إعادات المحاولة وعدد المحاولات على حالة الاستخدام وحالة الشبكة.
الأسعار
تتوفر إمكانية استخدام واجهة برمجة التطبيقات Google Sheets API بالكامل بدون أي تكلفة إضافية. تجاوز الحصة المحدّدة لا تؤدي حدود الطلبات إلى فرض رسوم إضافية، ولا يتم تحصيل فواتير من حسابك.
طلب زيادة في الحصة
بناءً على استخدام موارد مشروعك، قد ترغب في طلب حصة. زيادة. يتم اعتبار طلبات البيانات من واجهة برمجة التطبيقات التي يجريها حساب الخدمة على أنّها تستخدم حساب واحد. ولا يضمن طلب الحصول على حصة زائدة الموافقة. كبير جدًا قد تستغرق الموافقة على زيادة الحصة وقتًا أطول.
ليست كل المشروعات لها الحصص نفسها. مع ازدياد استخدامك لخدمة Google Cloud قد تحتاج إلى زيادة حصصك. إذا كنت تتوقع أحداثًا قادمة لزيادة الاستخدام، يمكنك طلب تعديل الحصص من صفحة "الحصص" في وحدة تحكُّم Google Cloud.
لمزيد من المعلومات، يمكنك الاطّلاع على المراجع التالية: