‫Play Integrity API: מדריך לקישור פרויקט בענן ולמכסות

‫Google Play Integrity API אוכף מגבלה של 10,000 בקשות ביום על תעבורת נתונים מפרויקטים בענן ב-Google Cloud שלא מקושרים לאפליקציה ב-Google Play Console או ל-SDK ב-Play SDK Console. המגבלה הזו כבר פעילה ברוב הפרויקטים בענן של Google Cloud. מספר קטן של פרויקטים עם מכסה מוגדלת קיימת קיבלו הארכה עד 16 בפברואר 2027 כדי להשלים את הקישור לפני שהמגבלה תיאכף.

במדריך הזה נסביר איך קישור פרויקטים משפיע על המכסה, איך מקשרים את הפרויקטים ב-Google Cloud לאפליקציה או ל-SDK, ונענה על שאלות נפוצות.

סיכום קצר

פרט חשוב תיאור
תאריך האכיפה כבר פעיל ברוב הפרויקטים.
‫16 בפברואר 2027 לפרויקטים שקיבלו הודעה על המועד האחרון.
מדיניות בקשות ל-Play Integrity API שמגיעות מפרויקטים ב-Cloud שלא מקושרים לאפליקציה או ל-SDK מוגבלות ל-10,000 בקשות ביום, גם אם בפרויקט מוגדרת מכסה מותאמת אישית גבוהה יותר.
על מי זה משפיע אפליקציות וערכות SDK ששולחות יותר מ-10,000 בקשות ביום באמצעות פרויקט ב-Google Cloud שלא מקושר לאפליקציה (ב-Play Console) או לערכת ה-SDK (ב-Play SDK Console).
נדרשת פעולה מקשרים את הפרויקטים בענן של Google לאפליקציה ב-Google Play Console או לערכת ה-SDK ב-Google Play SDK Console.
שגיאה בחריגה מהמכסה בקשות לא מקושרות מעבר ל-10,000 ביום נכשלות עם השגיאה TOO_MANY_REQUESTS (קוד שגיאה -8).

שאלות נפוצות

לכל פרויקט בענן של Google מוקצית מכסה של 10,000 בקשות ביום ל-Play Integrity API. מפתחים שצריכים נפח גדול יותר יכולים לבקש הגדלה של המכסה.

כדי להגן על האפליקציה או על ה-SDK ולמנוע מצדדים שלישיים לא מורשים לנצל את המכסה, המכסה היומית המוגדלת מוגבלת רק לפרויקטים בענן ב-Google Cloud שמקושרים לאפליקציה ב-Google Play Console או ל-SDK ב-Google Play SDK Console.

לאפליקציות (Google Play Console):

  1. נכנסים ל-Google Play Console ובוחרים את האפליקציה.
  2. בתפריט הניווט הימני, עוברים אל מוגן על ידי Play.
  3. לצד Play Integrity API, לוחצים על תחילת העבודה (או על ניהול).
  4. לוחצים על Link Cloud project (או על Add project אם כבר יש פרויקטים מקושרים).
  5. בוחרים או מזינים את מספר הפרויקט ב-Google Cloud שרוצים לקשר ומאשרים.

לערכות SDK ‏ (Google Play SDK Console):

  1. נכנסים ל-Google Play SDK Console ובוחרים את ה-SDK.
  2. בתפריט הניווט הימני, עוברים אל תקינות ה-SDK.
  3. לצד Play Integrity API, לוחצים על הגדרות.
  4. לוחצים על Link Cloud project (או על Add another אם כבר יש פרויקטים מקושרים).
  5. בוחרים או מזינים את מספר הפרויקט ב-Google Cloud שרוצים לקשר ומאשרים.

ההרשאות הנדרשות:

  • ‫Play Console (לאפליקציות): צריכה להיות לכם ההרשאה "השקת גרסה לסביבת ייצור, החרגת מכשירים ושימוש ב-חתימת אפליקציה ב-Play" באפליקציה.
  • ‫Play SDK Console (לערכות SDK): צריכה להיות לכם הרשאת ניהול ב-SDK.
  • ‫Google Cloud (שני הסוגים): צריכות להיות לכם ההרשאות serviceusage.services.enable ו-resourcemanager.projects.get בפרויקט היעד ב-Google Cloud.

לאפליקציות (Google Play Console):

  1. פותחים את Google Play Console‏ > Protected with Play‏ > Play Integrity API‏ > ניהול.
  2. בודקים את הקטע Project configuration.
  3. מוודאים שמספר הפרויקט שמופיע תואם למספר שמשמש לקריאה ל-Play Integrity API.

לערכות SDK ‏ (Google Play SDK Console):

  1. פותחים את Google Play SDK Console > תקינות ה-SDK > הגדרות.
  2. בודקים את הקטע Project configuration.
  3. מוודאים שמספר הפרויקט שמופיע תואם למספר שמשמש לקריאה ל-Play Integrity API.

שאלה 4: איך מקשרים את הפרויקט בענן אם האפליקציה או ה-SDK לא נמצאים ב-Google Play?

אפשר לקשר פרויקט בענן של Google רק לאפליקציות שמנוהלות ב-Google Play Console ולערכות SDK שרשומות ב-Google Play SDK Console.

אם האפליקציה שלכם מופצת רק מחוץ ל-Google Play או שערכת ה-SDK שלכם לא נמצאת ב-Play SDK Console, אתם לא יכולים לקשר פרויקט בענן ב-Google Cloud, והתנועה ב-Play Integrity API תוגבל לברירת המחדל של 10,000 בקשות ביום. כדי לקבל מכסה גדולה יותר, צריך לפרסם את האפליקציה ב-Google Play או לרשום את ה-SDK שעומד בדרישות ב-Play SDK Console, ולקשר את פרויקט הענן שלכם.

שאלה 5: האם אפשר לקשר כמה פרויקטים ב-Google Cloud, או לשתף פרויקט אחד בין אפליקציות או ערכות SDK?

  • כמה פרויקטים לכל אפליקציה או SDK: אתם יכולים לקשר עד חמישה פרויקטים ב-Google Cloud לאפליקציה או ל-SDK.
  • פרויקט אחד בכמה אפליקציות: אתם יכולים לקשר את אותו פרויקט ב-Google Cloud לכמה אפליקציות ב-Google Play Console. אי אפשר לקשר את אותו פרויקט בענן של Google לכמה ערכות SDK או לערכת SDK ולאפליקציה.

שאלה 6: מה קורה אם אני מנהל/ת את האפליקציה או את ה-SDK, אבל מישהו אחר בארגון שלי הוא הבעלים של הפרויקט ב-Google Cloud?

כדי להשלים את הקישור, למשתמש שמבצע את הפעולה ב-Play Console (או ב-Play SDK Console) צריכות להיות גם ההרשאות הנדרשות בפרויקט ב-Google Cloud. אפשר לעשות את זה בשתי דרכים:

  • אפשרות א': מבקשים ממישהו שיכול לנהל את הגישה ל-IAM בפרויקט ב-Google Cloud לתת לחשבון Google שלכם באופן זמני את ההרשאות serviceusage.services.enable ו-resourcemanager.projects.get. אחרי הקישור, ההרשאות האלה לא נדרשות יותר לפעולות היומיומיות.
  • אפשרות ב': נותנים לחבר צוות שכבר יש לו את ההרשאות serviceusage.services.enable ו-resourcemanager.projects.get בפרויקט ב-Google Cloud את ההרשאה הנדרשת במסוף, כדי שהוא יוכל לבצע את שלב הקישור:
    • לאפליקציות (Play Console): צריך לתת לאפליקציה את ההרשאה "השקת גרסה למסלול לסביבת הייצור, החרגת מכשירים ושימוש בחתימת אפליקציה ב-Play".
    • לערכות SDK‏ (Play SDK Console): נותנים הרשאת ניהול לערכת ה-SDK.

שאלה 7: מה יקרה אם לא אקשר את הפרויקט בענן לפני 16 בפברואר 2027?

אם אפליקציה או ערכת SDK שולחות בקשות ל-Play Integrity API באמצעות פרויקט לא מקושר ב-Google Cloud אחרי 16 בפברואר 2027:

  1. עד 10,000 בקשות ביום: הבקשות ממשיכות להתבצע כרגיל במסגרת מכסת הבסיס שמוגדרת כברירת מחדל.
  2. יותר מ-10,000 בקשות ביום: כשהפרויקט הלא מקושר מגיע ל-10,000 בקשות ביום, הבקשות נדחות עם השגיאה TOO_MANY_REQUESTS (קוד השגיאה -8).

תיקון מיידי בשירות עצמי:

אם האפליקציה או ה-SDK שלכם מקבלים שגיאות TOO_MANY_REQUESTS אחרי המועד האחרון כי פרויקט ב-Cloud לא קושר, קישור הפרויקט החסר ב-Google Cloud ב-Play Console או ב-Play SDK Console יפתור את הבעיה.

שאלה 8: אני לא משתמש/ת ב-Play Integrity API. למה קיבלתי הודעה שבה התבקשתי לקשר את הפרויקט שלי ב-Cloud?

שלחנו לך את ההודעה הזו כי הפרויקט שלך ב-Google Cloud יוצר יותר מ-10,000 בקשות לא מקושרות ביום ל-Play Integrity API. סיבות נפוצות:

  1. ספרייה או SDK שמוגדרים עם מספר הפרויקט שלכם ב-Cloud: חלק מהספריות מבצעות קריאה ל-Play Integrity API באמצעות הפרויקט שלכם ב-Google Cloud. אם האפליקציה או ה-SDK שלכם משתמשים בספרייה כזו, קשרו את הפרויקט הזה לאפליקציה שלכם ב-Play Console או ל-SDK שלכם ב-Play SDK Console.
  2. אפליקציה או צוות אחרים בארגון: יכול להיות שצוות אחר משתמש בפרויקט הזה ב-Google Cloud באפליקציה או ב-SDK שלו. כדי לזהות את האפליקציה או את ה-SDK, צריך לפנות לצוותי ההנדסה ואז לקשר את הפרויקט ב-Play Console או ב-Play SDK Console.
  3. תנועה לא מורשית או שילוב שהוצא משימוש: אם אפליקציות לא מורשות או משוכפלות שולחות בקשות עם מספר הפרויקט שלכם, או אם אתם כבר לא משתמשים ב-API, אתם לא צריכים לעשות שום דבר. אם תאפשרו למגבלה של 10,000 בקשות ביום ללא קישור להיכנס לתוקף, התנועה הלא רצויה תוגבל.

יצירת קשר ותמיכה

אם יש לכם שאלות לגבי קישור הפרויקט ב-Cloud או ניהול המכסה של Play Integrity API: