תחילת העבודה

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

  1. יוצרים פרויקט ב-Google Cloud.
  2. מפעילים את Google Play Developer API לפרויקט ב-Google Cloud.
  3. כדי לגשת ל-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 למפתחים:

  1. עוברים אל דף Google Play Developer API ב-Google Cloud Console.
  2. לוחצים על Enable.

הגדרת OAuth וחשבונות שירות

צריך להגדיר את הגישה ל-Google Play Developer API באמצעות לקוח OAuth או חשבון שירות. ברוב המקרים צריך להשתמש בחשבון שירות כדי לגשת ל-API.

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

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

  • חשבון שירות: שירות תוכנה מאובטח ייגש ל-API (הכי נפוץ)
  • לקוחות OAuth: משתמשים יקבלו גישה ל-API

שימוש בחשבון שירות

תוכלו ליצור חשבון שירות מ-Google Play Console.

  1. נכנסים אל Service Accounts במסוף Google Cloud.
  2. לוחצים על יצירת חשבון שירות ופועלים לפי השלבים.
  3. עוברים אל הדף משתמשים והרשאות ב-Google Play Console.
  4. לוחצים על הזמנת משתמשים חדשים.
  5. מזינים כתובת אימייל של חשבון השירות בשדה 'כתובת אימייל', ומעניקים את הזכויות הדרושות לביצוע הפעולות.

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

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

בשלב הזה אמורה להיות לך גישה ל-Google Play Developer API דרך חשבון השירות. תוכלו לקרוא מידע נוסף במאמר שימוש ב-OAuth 2.0 לאפליקציות שרת-אל-שרת.

שימוש בלקוחות OAuth

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

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

  1. במסוף Google Cloud, נכנסים לדף ההסכמה ל-OAuth של מסך ההסכמה.
  2. פועלים לפי השלבים ליצירת מסך הסכמה ל-OAuth.

כדי ליצור לקוח OAuth:

  1. במסוף Google Cloud, נכנסים אל Credentials.
  2. לוחצים על Create Credentials (יצירת פרטי כניסה) > OAuth client ID (מזהה לקוח של OAuth).
  3. בוחרים את סוג האפליקציה ופועלים לפי ההוראות.

מידע נוסף

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