ממשקי API של Google Play למפתחים

סקירה כללית

ב-Google Play Console יש חבילה של ממשקי API לשירותי אינטרנט שמבוססים על REST. הממשקים האלה מאפשרים לכם לבצע פעולות של פרסום, דיווח וניהול אפליקציות ישירות באפליקציה שלכם.

לא כל המפתחים צריכים להשתמש בממשקי ה-API האלה למפתחים. ברוב המקרים, אתם יכולים להמשיך לנהל את האפליקציות שלכם ישירות באמצעות Google Play Console. עם זאת, אם יש לכם מספר גדול של קובצי APK שצריך לנהל, או אם אתם צריכים לעקוב אחרי רכישות ומינויים של משתמשים, יכול להיות שממשקי ה-API האלה יהיו שימושיים בשבילכם.

מה כלול

ממשקי ה-API של Google Play למפתחים מאפשרים לכם להתמקד בעיצוב ובפיתוח של האפליקציה, ולהשקיע פחות זמן ומאמץ בניהול הגרסאות, גם כשאתם מתרחבים לשווקים חדשים.

ב-Google Play Console יש חבילה של ממשקי API שמאפשרים לנהל את האפליקציה:

  • Publishing API מאפשר להעלות ולפרסם אפליקציות, ולבצע משימות אחרות שקשורות לפרסום.
  • Subscriptions and In-App Purchases API מאפשר לנהל רכישות באפליקציות ומינויים. (בעבר הוא נקרא Purchase Status API).
  • Reporting API מאפשר לאחזר מידע על איכות האפליקציה מ"תפקוד האפליקציה".
  • Reply to Reviews API מאפשר לכם לאחזר ביקורות על האפליקציה ולהגיב להן.
  • Permissions API מאפשר לכם לנהל את ניהול ההרשאות ב-Play Console באופן אוטומטי.
  • באמצעות Play Games Services Management API אפשר להנפיק קריאות ל-REST כדי לשלוט באופן פרוגרמטי במטא-נתונים שמשמשים את התכונות של Google Play Games Services.
  • Voided Purchases API מספק רשימה של הזמנות שמשויכות לרכישות שמשתמש ביטל.

תחילת העבודה

כדי להתחיל להשתמש בממשקי ה-API של Google Play למפתחים, עיינו במאמר תחילת העבודה.

Publishing API

Publishing API מאפשר לכם להגדיר אוטומציה של משימות תכופות שקשורות להפצת אפליקציות. הוא מספק פונקציות דומות לאלה שזמינות למפתחים דרך Play Console, כמו:

  • העלאת גרסאות חדשות של אפליקציה
  • פרסום אפליקציות על ידי הקצאת קובצי APK למסלולים שונים (אלפא, בטא, השקה מדורגת או סביבת ייצור)
  • יצירה ושינוי של דפי אפליקציות בחנות Google Play, כולל טקסט וגרפיקה מותאמים לשוק המקומי וצילומי מסך ממכשירים שונים

המשימות האלה מבוצעות באמצעות הפונקציונליות של עריכות, שנוקטת גישה טרנזקציונלית לביצוע שינויים. כך אפשר לאגד כמה שינויים בטיוטת עריכה אחת, ואז להחיל את כל השינויים בבת אחת. (השינויים לא ייכנסו לתוקף עד שהעריכה תאושר).

שיטות מומלצות

  • להגביל את מספר העדכונים לאפליקציות. אל תפרסמו עדכונים לגרסאות אלפא או בטא בתדירות גבוהה יותר מפעם ביום (אפליקציות בסביבת ייצור צריך לעדכן בתדירות נמוכה עוד יותר). כל עדכון עולה למשתמשים בזמן, ולפעמים גם בכסף. אם תעדכנו את האפליקציה בתדירות גבוהה מדי, יכול להיות שהמשתמשים יתחילו להתעלם מהעדכונים, או אפילו יסירו את המוצר.

Subscriptions and In-App Purchases API

Subscriptions and In-App Purchases API מאפשר לנהל את קטלוג המוצרים והמינויים באפליקציה. בנוסף, באמצעות Subscriptions and In-App Purchases API, אתם יכולים לאחזר במהירות את הפרטים של כל רכישה באמצעות בקשת GET רגילה.

בבקשה צריך לספק מידע על הרכישה – שם חבילת ה-APK של האפליקציה, מזהה הרכישה או המינוי ואסימון הרכישה. השרת מגיב עם אובייקט JSON שמתאר את פרטי הרכישה המשויכת, סטטוס ההזמנה, המטען הייעודי (payload) של המפתח ומידע נוסף.

אפשר להשתמש ב-API הזה בכמה דרכים, למשל:

  • דיווח על הזמנות ספציפיות והתאמה שלהן.
  • אימות רכישות ותאריכי תפוגה של מינויים.
  • לדעת על הזמנות שבוטלו ולוודא אם מוצרים באפליקציה נצרכו, כולל אם הם נצרכו לפני שבוטלו.

שיטות מומלצות

  • כדאי לשמור את פרטי המינוי בשרת כדי להימנע מקריאות מיותרות ל-API. כשהאפליקציה צריכה לאמת מינוי, כדאי להסתמך על המידע שנשמר במטמון בשרת במקום לחזור על הקריאה ל-API ל-Google.
  • יש שני תרחישים שבהם השרת המאובטח שלכם צריך להשתמש ב-Google Play Developer API כדי לקבל מידע על מינויים:
    • השרת מקבל אסימון רכישה חדש שלא נראה בעבר.
    • השרת מקבל התראה בזמן אמת למפתחים (RTDN) שמציינת שצריך להשתמש בטוקן הרכישה כדי לקבל את פרטי המינוי החדש.
  • אל תדגמו את ה-API באופן קבוע כדי לבדוק את סטטוס המינוי. לדוגמה, אל תשלחו קריאה ל-API מדי יום כדי לבדוק כל מינוי.
  • מכיוון שאתם מקבלים RTDN כשהמינוי פג או מתחדש, אתם לא צריכים לתזמן קריאה ל-API על סמך מועד התפוגה המתוזמן.

Reporting API

Reporting API מיועד למפתחים שרוצים ליצור תהליכי עבודה אוטומטיים על סמך נתונים מ-Play Console, או למפתחים שמשתמשים בנתונים מ-Play Console לצורך דיווח וניתוח עסקי פנימי, אולי לצד מערכי נתונים אחרים. ה-API הזה נותן לכם גישה פרוגרמטית לנתונים ברמת האפליקציה, למדדים לדיווח פנימי, לניתוח ולאוטומציה.

ה-Reporting API מאפשר גישה לנתוני תפקוד האפליקציה, כולל שיעור הקריסות, שיעור מקרי ה-ANR, בעיות שקשורות להפעלה ולחסימת מצב שינה ודוחות קריסה של שגיאות.

שיטות מומלצות

תשובה ל-Reviews API

‫Reply to Reviews API מאפשר לכם לראות את המשוב של המשתמשים על האפליקציה ולהגיב לו. אתם יכולים להשתמש ב-API הזה כדי לתקשר עם המשתמשים ישירות בתוך ערכת הכלים הקיימת שלכם לתמיכת לקוחות, כמו מערכת CRM.

ה-Reply to Reviews API מאפשר לכם לגשת למשוב רק על גרסאות הייצור של האפליקציה. אם אתם רוצים לראות משוב על גרסאות אלפא או גרסאות בטא של האפליקציה, אתם צריכים להשתמש ב-Google Play Console. חשוב גם לזכור שה-API מציג רק את הביקורות שכוללות תגובות. אם משתמש מדרג את האפליקציה אבל לא מוסיף תגובה, המשוב שלו לא נגיש דרך ה-API.

Permissions API

Permissions API מאפשר למפתחים לנהל הרשאות באופן אוטומטי ב-Play Console. כך תוכלו לשלוט בצורה גמישה בגישה לחשבון הפיתוח שלכם, בלי מעורבות ידנית.

באמצעות Permissions API, אתם יכולים לבצע פונקציות ניהוליות כמו:

  • הסרת הגישה של משתמשים כשהם עוזבים את החברה.
  • מתן גישה לאפליקציה כשמשתמש מצטרף לצוות הרלוונטי.

Voided Purchases API

Voided Purchases API מספק רשימה של הזמנות שמשויכות לרכישות שמשתמש ביטל. אתם יכולים להשתמש במידע מהרשימה הזו כדי להטמיע מערכת ביטולים שמונעת מהמשתמשים לגשת למוצרים מההזמנות האלה.

ה-API הזה רלוונטי להזמנות חד-פעמיות מתוך האפליקציה ולמינויים לאפליקציות.

אפשר לבטל רכישה בדרכים הבאות:

  • המשתמש מבקש החזר כספי על ההזמנה שלו.
  • המשתמש מבטל את ההזמנה.
  • הזמנה שבוצע בה החזר כספי.
  • המפתח מבטל את ההזמנה או מבצע החזר כספי. הערה: רק הזמנות שבוטלו יוצגו ב-Voided Purchases API. אם המפתח מבצע החזר כספי בלי להגדיר את אפשרות הביטול, ההזמנות לא יופיעו ב-API.
  • ‫Google מבטלת את ההזמנה או מבצעת החזר כספי.

השימוש ב-API הזה עוזר ליצור חוויה מאוזנת והוגנת יותר לכל המשתמשים באפליקציה, במיוחד אם האפליקציה היא משחק.