כדי להתחיל לבצע קריאות ל-API, צריך להגדיר גישת API חשבון הפיתוח ב-Google Play. זה כרוך בשינויים Google Play Console ומסוף Google Cloud. ההוראות הבאות להסביר את השלבים הדרושים להתחלת השימוש ב-Google Play Developer API.
- יוצרים פרויקט ב-Google Cloud.
- מפעילים את Google Play Developer API לפרויקט Google Cloud.
- מגדירים חשבון שירות עם ההרשאות המתאימות ב-Google Play Console כדי לגשת אל Google Play Developer API.
יצירת פרויקט ב-Google Cloud
אפשר לדלג על השלב הזה אם כבר יש לך פרויקט ב-Google Cloud שבהם רוצים להשתמש.
ליצור פרויקט ב מסוף Google Cloud.
למידע נוסף על פרויקטים ב-Google Cloud, כדאי לקרוא את המאמר יצירה וניהול של פרויקטים.
הפעלת ה-API
אחרי שתגדירו את הפרויקט ב-Google Cloud, צריך להפעיל ממשק ה-API של Google Play למפתחים עבור הפרויקט הזה.
כדי להפעיל את ממשק API של Google Play למפתחים:
- עוברים אל דף Google Play Developer API ב-Google Cloud Console.
- לוחצים על Enable.
הגדרת חשבונות שירות וחשבונות OAuth
עליך להגדיר גישה אל Google Play Developer API באמצעות לקוח OAuth או חשבון שירות. ברוב המקרים, כדאי להשתמש בחשבון שירות. כדי לגשת ל-API.
יש להשתמש בחשבונות שירות בסביבה מאובטחת, כמו השרת שלך. פרטי הכניסה של חשבון השירות צריכים להיות מנוהלים באופן מאובטח, כדי שהם לא נחשף לכל מי שאינו מורשה להשתמש ב-API.
צריך להשתמש במזהה הלקוח של OAuth אם צריך לגשת ל-API בשם של משתמש ספציפי. לדוגמה, אם האתר שלך צריך גישה Google Play Developer API מלקוח האינטרנט בשם המשתמש, ניתן להשתמש ב- מזהה לקוח. המשתמש יאומת באמצעות חשבון Google שלו במקום זאת של חשבון השירות. ההרשאה הזו מאפשרת לך לבצע קריאות ל-API בשם משתמש בלי לפגוע בפרטי הכניסה לחשבון השירות.
- חשבון שירות: שירות תוכנה מאובטח יקבל גישה ל-API (האפשרות הנפוצה ביותר).
- לקוחות OAuth: משתמש יקבל גישה ל-API
שימוש בחשבון שירות
אפשר ליצור חשבון שירות דרך: ב-Google Play Console.
- במסוף Google Cloud, נכנסים אל Service Accounts.
- לוחצים על Create service account ופועלים לפי השלבים.
- עוברים אל הדף משתמשים ו- הרשאות ב-Google Play Console.
- לוחצים על הזמנת משתמשים חדשים.
מזינים את כתובת האימייל של חשבון השירות בכתובת האימייל ולהעניק את הזכויות הדרושות לביצוע פעולות.
כדי להשתמש בממשקי Google Play Billing API, עליכם להעניק את ההרשאות הבאות:
- הצגת נתונים פיננסיים, הזמנות ותגובות לסקר ביטול
- ניהול הזמנות ומינויים
לוחצים על שליחת הזמנה למשתמש.
בשלב זה, תהיה לך אפשרות לגשת לממשק ה-API של Google Play למפתחים דרך חשבון שירות. מידע נוסף זמין במאמר שימוש ב-OAuth 2.0 לשרת לשרת אפליקציות.
שימוש בלקוחות OAuth
אפשר לאפשר למשתמשים לבצע פעולות באמצעות ה-API עם פרטי הכניסה שלהם באמצעות לקוח OAuth. הפעולות של המשתמש מוגבלות לפעולות המותרות דרך משתמשים והרשאות ב-Google Play Console.
לפני שיוצרים לקוחות OAuth, צריך להגדיר את פרטי המיתוג של את המוצר שלך. מידע נוסף זמין במאמר הגדרת מסך ההסכמה ב-OAuth.
- במסוף Google Cloud, נכנסים אל הדף 'מסך ההסכמה של OAuth'.
- פועלים לפי השלבים ליצירת מסך הסכמה ל-OAuth.
כדי ליצור לקוח OAuth:
- נכנסים אל Credentials במסוף Google Cloud.
- לוחצים על Create Credentials > מזהה הלקוח ב-OAuth.
- בוחרים את סוג האפליקציה ופועלים לפי ההוראות.
מידע נוסף
הטיפים והטריקים הבאים יעזרו לכם להתחיל להשתמש ב-API Google Play.
איך מקבלים את מזהה המפַתח
בחלק מממשקי API תצטרכו לספק מזהה מפתח של Google Play Console. הזה הוא מספר ארוך שהוקצה לחשבון הפיתוח ב-Google Play נוצרה, ניתן למצוא את מזהה המפתח בכתובת ה-URL של כמעט כל דף ב-Google Play Console, כמו גישה ל-API.
לדוגמה, שימו לב לכתובת ה-URL של Google Play Console:
https://play.google.com/console/developers/1234567890123456789/api-access
בכתובת ה-URL שלמעלה, מזהה המפַתח הוא 1234567890123456789.
הערה: אם אפליקציה מועברת מחשבון פיתוח אחד ב-Google Play לחשבון אחר, מזהה המפַתח שמשויך לאפליקציה הזו ישתנה. כלומר שבסיום ההעברה, יהיה עליך להשתמש במזהה המפַתח של הנכס חשבון הפיתוח ב-Google Play בקריאות ל-API של האפליקציה הזו.
ממשקי API מיוחדים
Google Play Developer API מכיל מספר ממשקי API מיוחדים שמאפשרים לך לבצע סוגים ספציפיים של ניתוח באפליקציה:
- תשובה ל-Reviews API
- האפשרות להציג משוב של משתמשים על האפליקציה ולהשיב למשוב הזה.
- Voided Purchases API
- מאפשר לך לבטל את הגישה למוצרים מתוך האפליקציה המשויכים לרכישות בוטלה על ידי משתמש.
ספריות לקוח
יצרנו ספריות לקוח שבהן אפשר להשתמש כדי לבצע את הפעולות באופן פרוגרמטי לגשת לממשקי ה-API בארכיטקטורת REST. למידע נוסף, ראו ספריות לקוח וקודים 'טעימות'.