ממשקי API של Google Play למפתחים (original) (raw)

סקירה כללית

ב-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.

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

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

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

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

מדווח API

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

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

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

• בגרסה הזו של Reporting API, המגבלה שמוגדרת כברירת מחדל היא 10 שאילתות לשנייה. אפשר לראות את השימוש במכסות בקטע Quotas במסוף Google Cloud. אם אתם צריכים לחרוג מהמגבלה הזו, תוכלו לשלוח בקשה להגדלת המכסה באמצעות הטופס הזה.

Reply to Reviews API

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

ממשק ה-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 הזה עוזר ליצור חוויה מאוזנת והוגנת יותר לכל המשתמשים באפליקציה, במיוחד אם מדובר במשחק.