לפני שתוכלו להתחיל לבצע קריאות ל-API, עליכם להגדיר גישת API לחשבון הפיתוח שלכם ב-Google Play. זה כולל שינויים ב-Google Play Console וגם במסוף Google Cloud. בהוראות הבאות מוסבר מהם השלבים הדרושים כדי להתחיל להשתמש ב-Google Play Developer API.
- יוצרים פרויקט ב-Google Cloud.
- מפעילים את Google Play Developer API לפרויקט ב-Google Cloud.
- כדי לגשת ל-Google Play Developer API, צריך להגדיר חשבון שירות עם ההרשאות המתאימות ב-Google Play Console.
יצירת פרויקט ב-Google Cloud
אם כבר יש לכם פרויקט ב-Google Cloud שאתם רוצים להשתמש בו, תוכלו לדלג על השלב הזה.
יוצרים פרויקט במסוף Google Cloud.
למידע נוסף על פרויקטי�� ב-Google Cloud, קראו את המאמר יצירה וניהול של פרויקטים.
מפעילים את ה-API
אחרי שמגדירים את הפרויקט ב-Google Cloud, צריך להפעיל את Google Play Developer API לפרויקט הזה.
כדי להפעיל את ממשק 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.
- נכנסים אל Service Accounts במסוף Google Cloud.
- לוחצים על יצירת חשבון שירות ופועלים לפי השלבים.
- עוברים אל הדף משתמשים והרשאות ב-Google Play Console.
- לוחצים על הזמנת משתמשים חדשים.
מזינים כתובת אימייל של חשבון השירות בשדה 'כתובת אימייל', ומעניקים את הזכויות הדרושות לביצוע הפעולות.
כדי להשתמש בממשקי ה-API לחיוב ב-Google Play, עליכם להעניק את ההרשאות הבאות:
- הצגת נתונים פיננסיים, הזמנות ותשובות לסקר הביטול
- ניהול הזמנות ומינויים
לוחצים על הזמנת משתמש.
בשלב הזה אמורה להיות לך גישה ל-Google Play Developer API דרך חשבון השירות. תוכלו לקרוא מידע נוסף במאמר שימוש ב-OAuth 2.0 לאפליקציות שרת-אל-שרת.
שימוש בלקוחות OAuth
אתם יכולים לאפשר למשתמשים לבצע פעולות באמצעות ה-API באמצעות פרטי הכניסה שלהם באמצעות לקוח OAuth. הפעולות של המשתמש מוגבלות לפעולות שמותרות דרך הדף משתמשים והרשאות ב-Google Play Console.
לפני שיוצרים לקוחות OAuth, צריך ל��גדיר את פרטי המיתוג של המוצר. מידע נוסף זמין במאמר הגדרת מסך ההסכמה ל-OAuth.
- במסוף Google Cloud, נכנסים לדף ההסכמה ל-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 מיוחדים שמאפשרים לבצע סוגים ספציפיים של ניתוח נתונים של האפליקציה:
- תשובה ל-Reviews API
- מאפשר לך לראות משוב של משתמשים על האפליקציה ולהשיב למשוב הזה.
- Voided Purchases API
- ההגדרה מאפשרת לבטל את הגישה למוצרים מתוך האפליקציה שמשויכים לרכישות שהמשתמש ביטל.
ספריות לקוח
יש לנו ספריות לקוח שאפשר להשתמש בהן כדי לגשת לממשקי API ל-REST באופן פרוגרמטי. מידע נוסף זמין במאמר ספריות לקוח ודוגמאות קוד.