Play Integrity API: راهنمای سهمیه و پیوند دادن پروژه Cloud

Google Play Integrity API محدودیت ۱۰٬۰۰۰ درخواست در روز را برای ترافیک پروژه‌های Google Cloud که به برنامه‌ای در «کنسول Google Play» یا به کیت توسعه نرم‌افزار در Play SDK Console پیوند نشده‌اند اعمال می‌کند. این محدودیت درحال‌حاضر برای اکثر پروژه‌های Google Cloud فعال است. به تعداد کمی از پروژه‌ها که ازقبل سهمیه افزایش‌یافته داشتند مهلت تمدیدشده‌ای تا ۱۶ فوریه ۲۰۲۷ داده شد تا پیونددهی را قبل‌از اعمال محدودیت تکمیل کنند.

این راهنما توضیح می‌دهد که پیوند دادن پروژه چگونه بر سهمیه شما تأثیر می‌گذارد، چگونه پروژه‌های Google Cloud را به برنامه یا کیت توسعه نرم‌افزارتان پیوند دهید، و به پرسش‌های پرتکرار پاسخ می‌دهد.

خلاصه سریع

جزئیات کلیدی	شرح
تاریخ اجرا	برای اکثر پروژه‌ها ازقبل فعال است. ۱۶ فوریه ۲۰۲۷ برای پروژه‌هایی که اعلان مهلت دریافت کرده‌اند.
خط‌مشی	درخواست‌های Play Integrity API که از پروژه‌های Cloud پیوندنشده به برنامه یا کیت توسعه نرم‌افزار شما منشأ می‌گیرند، صرف‌نظر از هرگونه سهمیه سفارشی بالاتری که در پروژه پیکربندی شده است، به ۱۰٬۰۰۰ درخواست در روز محدود می‌شوند.
چه کسانی تحت‌تأثیر قرار می‌گیرند	برنامه‌ها و کیت‌های توسعه نرم‌افزاری که بیش‌از ۱۰٬۰۰۰ درخواست در روز بااستفاده از پروژه Google Cloud که به آن برنامه (در «کنسول Play») یا کیت توسعه نرم‌افزار (در «کنسول کیت توسعه نرم‌افزار Play») پیوند داده نشده است ارسال می‌کنند.
اقدام لازم است	پروژه‌های Google Cloud را به برنامه‌تان در کنسول Google Play یا به کیت توسعه نرم‌افزارتان در کنسول کیت توسعه نرم‌افزار Google Play پیوند دهید.
خطای فراتر رفتن از سهمیه	درخواست‌های پیوندنشده فراتر از ۱۰٬۰۰۰ درخواست در روز با خطای TOO_MANY_REQUESTS (کد خطای -8) ناموفق می‌شوند.

پرسشگان

سؤال ۱: چرا پیوند دادن پروژه Google Cloud الزامی است؟

‫Play Integrity API برای هر پروژه Google Cloud سهمیه پیش‌فرضی معادل ۱۰٬۰۰۰ درخواست در روز ارائه می‌دهد. توسعه‌دهندگانی که به حجم بالاتری نیاز دارند می‌توانند درخواست افزایش سهمیه کنند.

برای محافظت از برنامه یا کیت توسعه نرم‌افزار شما و جلوگیری از تمام شدن سهمیه شما توسط اشخاص ثالث غیرمجاز، سهمیه روزانه افزایش‌یافته منحصراً به پروژه‌های Google Cloud محدود می‌شود که در «کنسول Google Play» به برنامه شما یا در «کنسول کیت توسعه نرم‌افزار Google Play» به کیت توسعه نرم‌افزار شما پیوند داده شده‌اند.

سؤال ۲: چگونه پروژه‌های Google Cloud خود را در «کنسول Play» یا «کنسول کیت توسعه نرم‌افزار Play» پیوند دهم؟

برای برنامه‌ها (کنسول Google Play):

1. به سیستم کنسول Google Play وارد شوید و برنامه‌تان را انتخاب کنید.
2. در منو پیمایش سمت راست، به محافظت‌شده با Play بروید.
3. در کنار Play Integrity API، شروع به کار (یا مدیریت) را انتخاب کنید.
4. روی پیوند دادن پروژه Cloud (یا افزودن پروژه اگر قبلاً پروژه‌هایی را پیوند داده‌اید) کلیک کنید.
5. شماره پروژه Google Cloud را که می‌خواهید پیوند شود انتخاب یا وارد کنید و تأیید کنید.

برای کیت‌های توسعه نرم‌افزار (کنسول کیت توسعه نرم‌افزار Google Play):

1. به سیستم کنسول کیت توسعه نرم‌افزار Google Play وارد شوید و کیت توسعه نرم‌افزار خود را انتخاب کنید.
2. در منو پیمایش سمت راست، به یکپارچگی کیت توسعه نرم‌افزار بروید.
3. در کنار Play Integrity API، روی تنظیمات کلیک کنید.
4. روی پیوند دادن پروژه Cloud (یا افزودن پروژه دیگر اگر ازقبل پروژه پیوندشده دارید) کلیک کنید.
5. شماره پروژه Google Cloud را که می‌خواهید پیوند شود انتخاب یا وارد کنید و تأیید کنید.

اجازه‌های لازم:

• کنسول Play (برای برنامه‌ها): باید برای برنامه اجازه «انتشار در مرحله تولید، کنار گذاشتن دستگاه‌ها، و استفاده از Play App Signing» را داشته باشید.
• کنسول کیت توسعه نرم‌افزار Play (برای کیت‌های توسعه نرم‌افزار): باید اجازه «مدیریت» را برای کیت توسعه نرم‌افزار داشته باشید.
• Google Cloud (هر دو): باید اجازه‌های «serviceusage.services.enable» و «resourcemanager.projects.get» را در پروژه Google Cloud هدف داشته باشید.

سؤال ۳: چگونه می‌توانم تأیید کنم که پروژه Cloud من به‌درستی پیوند داده شده است؟

برای برنامه‌ها (کنسول Google Play):

1. کنسول Google Play > محافظت‌شده با Play >‏ Play Integrity API > مدیریت را باز کنید.
2. بخش پیکربندی پروژه را بررسی کنید.
3. مطمئن شوید شماره پروژه فهرست‌شده با شماره مورداستفاده برای فراخوانی Play Integrity API مطابقت داشته باشد.

برای کیت‌های توسعه نرم‌افزار (کنسول کیت توسعه نرم‌افزار Google Play):

1. کنسول کیت توسعه نرم‌افزار Google Play > یکپارچگی کیت توسعه نرم‌افزار > تنظیمات را باز کنید.
2. بخش پیکربندی «پروژه» را بررسی کنید.
3. مطمئن شوید شماره پروژه فهرست‌شده با شماره مورداستفاده برای فراخوانی Play Integrity API مطابقت داشته باشد.

سؤال ۴: اگر برنامه یا کیت توسعه نرم‌افزار من در Google Play نباشد، چگونه پروژه Cloud خود را پیوند دهم؟

پیوند دادن پروژه Google Cloud فقط برای برنامه‌هایی دردسترس است که در کنسول Google Play مدیریت می‌شوند و کیت‌های توسعه نرم‌افزاری که در کنسول کیت توسعه نرم‌افزار Google Play ثبت شده‌اند.

اگر برنامه‌تان منحصراً در خارج از Google Play توزیع می‌شود یا کیت توسعه نرم‌افزارتان در «کنسول کیت توسعه نرم‌افزار Play» نیست، نمی‌توانید پروژه Google Cloud را پیوند دهید و ترافیک Play Integrity API به ۱۰٬۰۰۰ درخواست پیش‌فرض در روز محدود خواهد شد. برای واجدشرایط شدن برای سهمیه بالاتر، برنامه‌تان را در Google Play منتشر کنید یا کیت توسعه نرم‌افزار واجدشرایطتان را در «کنسول کیت توسعه نرم‌افزار Play» ثبت کنید، و پروژه Cloud خود را پیوند دهید.

سؤال ۵: آیا می‌توانم چند پروژه Google Cloud را پیوند دهم یا یک پروژه را در برنامه‌ها یا کیت‌های توسعه نرم‌افزار هم‌رسانی کنم؟

• چند پروژه برای هر برنامه یا کیت توسعه نرم‌افزار: می‌توانید حداکثر پنج پروژه Google Cloud را به یک برنامه یا کیت توسعه نرم‌افزار پیوند دهید.
• یک پروژه در چندین برنامه: می‌توانید یک پروژه Google Cloud را به چندین برنامه در «کنسول Google Play» پیوند دهید. پیوند دادن یک پروژه Google Cloud به چند کیت توسعه نرم‌افزار یا به یک کیت توسعه نرم‌افزار و یک برنامه پشتیبانی نمی‌شود.

سؤال ۶: اگر من برنامه یا کیت توسعه نرم‌افزار را مدیریت کنم، اما شخص دیگری در سازمانم مالک پروژه Google Cloud باشد، چه اتفاقی می‌افتد؟

برای تکمیل پیوند، کاربری که این کنش را در «کنسول Play» (یا «کنسول کیت توسعه نرم‌افزار Play») انجام می‌دهد باید اجازه‌های لازم را نیز در پروژه Google Cloud داشته باشد. می‌توانید این کار را به یکی از دو روش زیر هماهنگ کنید:

• گزینه الف: از فردی که می‌تواند دسترسی IAM را در پروژه Google Cloud مدیریت کند بخواهید موقتاً به «حساب Google» شما اجازه‌های «serviceusage.services.enable» و «resourcemanager.projects.get» را اعطا کند. پس‌از پیوند دادن، این اجازه‌ها دیگر برای عملیات روزانه لازم نیست.
• گزینه ب: به یکی از اعضای تیم که ازقبل «serviceusage.services.enable» و «resourcemanager.projects.get» را در پروژه Google Cloud دارد، اجازه لازم «کنسول» را اعطا کنید تا بتواند مرحله پیوند دادن را انجام دهد:
  • برای برنامه‌ها («کنسول Play»): اجازه «انتشار در مرحله تولید، کنار گذاشتن دستگاه‌ها، و استفاده از Play App Signing» را برای برنامه اعطا کنید.
  • برای کیت‌های توسعه نرم‌افزار (کنسول کیت توسعه نرم‌افزار Play): اجازه «مدیریت» را برای کیت توسعه نرم‌افزار اعطا کنید.

سؤال ۷: اگر پروژه Cloud خود را قبل‌از ۱۶ فوریه ۲۰۲۷ پیوند ندهم چه اتفاقی می‌افتد؟

اگر برنامه یا کیت توسعه نرم‌افزاری بعداز ۱۶ فوریه ۲۰۲۷ بااستفاده از پروژه Google Cloud پیوندنشده درخواست‌های Play Integrity API ارسال کند:

1. حداکثر ۱۰٬۰۰۰ درخواست در روز: درخواست‌ها همچنان به‌طور معمول تحت سهمیه مبنای پیش‌فرض با موفقیت انجام می‌شوند.
2. بیش‌از ۱۰٬۰۰۰ درخواست در روز: وقتی پروژه پیوندنشده به ۱۰٬۰۰۰ درخواست در روز برسد، درخواست‌ها با خطای TOO_MANY_REQUESTS (کد خطای -8) رد می‌شوند.

اصلاح فوری خویش‌یاری:

اگر برنامه یا کیت توسعه نرم‌افزار شما پس‌از مهلت مقرر خطاهای TOO_MANY_REQUESTS دریافت می‌کند چون پروژه Cloud پیوند داده نشده است، پیوند دادن پروژه Google Cloud مفقودشده در «کنسول Play» یا «کنسول کیت توسعه نرم‌افزار Play» مشکل را برطرف خواهد کرد.

سؤال ۸: از Play Integrity API استفاده نمی‌کنم. چرا پیامی دریافت کردم که از من می‌خواهد پروژه Cloud خودم را پیوند دهم؟

این اعلان را دریافت کرده‌اید چون پروژه Google Cloud شما بیش‌از ۱۰٬۰۰۰ درخواست Play Integrity API پیوندنشده در روز تولید می‌کند. دلایل رایج عبارت‌اند از:

1. کتابخانه یا کیت توسعه نرم‌افزار پیکربندی‌شده با شماره پروژه Cloud شما: برخی‌از کتابخانه‌ها Play Integrity API را بااستفاده از پروژه Google Cloud شما فراخوانی می‌کنند. اگر برنامه یا کیت توسعه نرم‌افزار شما از چنین کتابخانه‌ای استفاده می‌کند، آن پروژه را به برنامه‌تان در «کنسول Play» یا به کیت توسعه نرم‌افزارتان در «کنسول کیت توسعه نرم‌افزار Play» پیوند دهید.
2. برنامه یا تیم دیگری در سازمان شما: ممکن است تیم دیگری از این پروژه Google Cloud در برنامه یا کیت توسعه نرم‌افزار خود استفاده کند. با تیم‌های مهندسی‌تان تماس بگیرید تا برنامه یا کیت توسعه نرم‌افزار را شناسایی کنید، سپس پروژه را در «کنسول Play» یا «کنسول کیت توسعه نرم‌افزار Play» پیوند دهید.
3. ترافیک غیرمجاز یا ادغام بازنشسته: اگر برنامه‌های غیرمجاز یا همانندسازی‌شده با شماره پروژه شما درخواست ارسال می‌کنند—یا اگر دیگر از میانای برنامه‌سازی کاربردی استفاده نمی‌کنید—نیازی به اقدام نیست. اجازه دادن به اعمال سقف ۱۰٬۰۰۰ درخواست در روز برای پیوند نشده‌ها ترافیک ناخواسته را محدود خواهد کرد.

تماس و پشتیبانی

اگر درباره پیوند دادن پروژه Cloud یا مدیریت سهمیه Play Integrity API سؤالی دارید:

• فرم پشتیبانی Play Integrity: تماس با پشتیبانی توسعه‌دهنده
• راهنمایی کلی «کنسول Play»: مرکز راهنمایی «کنسول Play»