إدارة استخدام واجهة برمجة التطبيقات لخدمات ألعاب Play
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا الموضوع كيفية رصد استخدام واجهة برمجة التطبيقات Play Games Services API وإدارته في
لعبتك.
رصد تقييد معدّل الزحف
إذا كنت تستخدِم حزمة SDK لـ "خدمات ألعاب Play"، تعرِض معالجات عمليات الاستدعاء أو مستمعوها
أخطاء عندما تتجاوز لعبتك الحدّ الأقصى لمعدّل إرسال البيانات.
في Android، تُعرِض المكالمات التي تُعرِض
كائنات PendingResult
،
مثل
incrementAchievementImmediate،
رمز الحالة STATUS_NETWORK_ERROR_OPERATION_DEFERRED في
كائن النتيجة. يشير رمز الحالة هذا إلى أنّ المكتبة سمحاولة تلقائيًا
إجراء المكالمة مرة أخرى لاحقًا عندما لا يعود معدّل إرسال البيانات في لعبتك محدودًا.
لطلب حصة إضافية لألعابك، يُرجى الاطّلاع على القسم
زيادة الحصة.
إدارة حصتك اليومية
يمكنك مراجعة الحصة اليومية لتطبيقك على Google Cloud Platform من خلال
الانتقال إلى مشروعك في
Google Cloud Platform.
لعرض حدود الاستخدام لمشروعك أو تغييرها، أو لطلب زيادة
حصتك، اتّبِع الخطوات التالية:
للاطّلاع على الإعدادات المتعلّقة بالحصص وتغييرها، انقر على الحصص. للاطّلاع على
إحصاءات الاستخدام، اختَر الاستخدام.
يمكنك ضبط الحد الأقصى لعدد المكالمات التي يمكن للمستخدم إجراؤها في الثانية، وذلك لمحاولة المساعدة في ضمان عدم استخدام لاعب مسيء لكل حصة تطبيقك. لمزيد من المعلومات عن الحدّ الأقصى للاستخدام، يُرجى الاطّلاع على مستندات
Google Cloud Platform.
لطلب حصة إضافية لألعابك، يُرجى الاطّلاع على القسم
زيادة الحصة.
طلب زيادة في الحصة
لطلب زيادة حصة الألعاب، انقر على الرابط طلب المزيد بجانب إدخال حصة تطبيقك في
Google Cloud Platform.
لا يتم عادةً قبول طلبات زيادة حصة الألعاب ما لم تكن لعبتك
تشهد استخدامًا استثنائيًا وتلتزم بأفضل الممارسات الواردة في
قائمة التحقّق من الجودة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-30 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-30 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["This topic describes how to detect and manage Play Games Services API usage in\nyour game.\n\nDetect rate limiting\n\nIf you are using the Play Games Services SDK, your callback handlers or listeners\nreturn errors when your game exceeds its rate limit.\n\nIn Android, calls that return\n[`PendingResult`](https://developer.android.com/reference/com/google/android/gms/common/api/PendingResult.html)\nobjects,\nsuch as\n[`incrementAchievementImmediate`](https://developer.android.com/reference/com/google/android/gms/games/achievement/Achievements.html#incrementImmediate(com.google.android.gms.common.api.GoogleApiClient,%20java.lang.String,%20int)),\nreturn a `STATUS_NETWORK_ERROR_OPERATION_DEFERRED` status code in the\nresult object. This status code indicates that the library will automatically\nattempt to make the call again later when your game is no longer rate limited.\n\nTo request additional quota for your games, see the\n[quota increase](#quota-increase) section.\n\nManage your daily quota\n\nYou can review your application's daily quota for Google Cloud Platform by\nvisiting your project in the\n[Google Cloud Platform](https://console.developers.google.com/).\n\nTo view or change usage limits for your project, or to request an increase to\nyour quota, do the following:\n\n1. If you don't already have a [billing account](//cloud.google.com/billing/docs/how-to/manage-billing-account) for your project, then create one.\n2. [Visit the Enabled APIs page of the\n API library](https://console.cloud.google.com/apis/enabled) in the API Console, and select an API from the list.\n3. To view and change quota-related settings, select **Quotas** . To view usage statistics, select **Usage**.\n\nYou can set the maximum number of calls a user can make per second, to\nhelp ensure that an abusive player doesn't use up all of your application's\nquota. To learn more about capping usage, see the\nGoogle Cloud Platform\n[documentation](https://developers.google.com/console/help/capping-usage).\n\nTo request additional quota for your games, see the\n[quota increase](#quota-increase) section.\n\nRequest a quota increase\n\nTo request a game quota increase, click the *Request more* link next to\nyour app's quota entry in the\n[Google Cloud Platform](https://console.developers.google.com/).\n\nRequests to increase the games quota usually aren't accepted unless your game is\nexperiencing exceptional usage and is obeying the best practices in the\n[quality checklist](https://developers.google.com/games/services/bestpractices#9_quota_and_rate_limiting)."]]
