כדי להתחיל לבצע קריאות ל-API, צריך להגדיר גישה ל-API לחשבון הפיתוח ב-Google Play. השינויים האלה מתבצעים גם ב-Google Play Console וגם ב-Google Cloud Console. בהוראות הבאות מוסבר איך להתחיל להשתמש ב-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, צריך להפעיל את Google Play Developer API עבור הפרויקט הזה.
כדי להפעיל את Google Play Developer API:
- עוברים אל הדף של Google Play Developer API ב-Google Cloud Console.
- לוחצים על Enable.
הגדרת OAuth וחשבונות שירות
צריך להגדיר גישה ל-Google Play Developer API באמצעות לקוח OAuth או חשבון שירות. ברוב המקרים, מומלץ להשתמש בחשבון שירות כדי לגשת ל-API.
חשבונות שירות צריכים לשמש בסביבה מאובטחת, כמו השרת שלכם. צריך לנהל את פרטי הכניסה של חשבון השירות בצורה מאובטחת כדי שלא ייחשפו לאף אחד שלא מורשה להשתמש ב-API.
אם אתם צריכים לגשת ל-API בשם משתמש ספציפי, אתם צריכים להשתמש במזהה לקוח ב-OAuth. לדוגמה, אם האתר שלכם צריך לגשת אל Google Play Developer API מלקוח האינטרנט בשם המשתמש, אתם יכולים להשתמש ב-Client ID. המשתמש יאומת באמצעות חשבון Google שלו במקום באמצעות חשבון השירות. כך תוכלו לבצע קריאות ל-API בשם משתמש בלי לסכן את פרטי הכניסה של חשבון השירות.
- חשבון שירות: שירות תוכנה מאובטח יקבל גישה ל-API (האפשרות הנפוצה ביותר)
- לקוחות OAuth: משתמש יגש ל-API
שימוש בחשבון שירות
אפשר ליצור חשבון שירות מ-Google Play Console.
- במסוף Google Cloud, עוברים אל Service Accounts.
- לוחצים על יצירת חשבון שירות ופועלים לפי השלבים.
- עוברים לדף משתמשים והרשאות ב-Google Play Console.
- לוחצים על הזמנת משתמשים חדשים.
מזינים את כתובת האימייל של חשבון השירות בשדה כתובת האימייל ומעניקים את ההרשאות הנדרשות לביצוע פעולות.
כדי להשתמש בממשקי ה-API של חיוב ב-Google Play, צריך להעניק את ההרשאות הבאות:
- הצגת נתונים פיננסיים, הזמנות ותשובות לסקר הביטול
- ניהול הזמנות ומינויים
לוחצים על הזמנת משתמש.
בשלב הזה, אמורה להיות לכם גישה ל-Google Play Developer API דרך חשבון השירות. למידע נוסף, תוכלו לקרוא את המאמר שימוש ב-OAuth 2.0 לאפליקציות שרת-אל-שרת.
שימוש בלקוחות OAuth
אתם יכולים לאפשר למשתמשים לבצע פעולות באמצעות ה-API עם פרטי הכניסה שלהם באמצעות לקוח OAuth. הפעולות של המשתמש מוגבלות לאלה שמותרות לו דרך הדף משתמשים והרשאות ב-Google Play Console.
לפני שיוצרים לקוחות OAuth, צריך להגדיר את פרטי המיתוג של המוצר. מידע נוסף זמין במאמר בנושא הגדרת מסך הסכמה ל-OAuth.
- ב-Google Cloud Console, עוברים אל דף מסך ההסכמה ל-OAuth.
- פועלים לפי השלבים ליצירת מסך הסכמה של OAuth.
כדי ליצור לקוח OAuth:
- במסוף Google Cloud, עוברים אל Credentials.
- לוחצים על Create Credentials (יצירת פרטי כניסה) > OAuth client ID (מזהה לקוח 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 ייעודיים שמאפשרים לכם לבצע סוגים ספציפיים של ניתוח באפליקציה שלכם:
- Reply to Reviews API
- מאפשר לכם לראות את המשוב של המשתמשים על האפליקציה שלכם ולהשיב למשוב הזה.
- Voided Purchases API
- מאפשרת לכם לבטל את הגישה למוצרים באפליקציה שמשויכים לרכישות שמשתמש ביטל.
ספריות לקוח
סיפקנו ספריות לקוח שבהן אפשר להשתמש כדי לגשת ל-API ל-REST באופן פרוגרמטי. מידע נוסף זמין במאמר ספריות לקוח ודוגמאות קוד.