Products

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

משאב 'מוצרים' מייצג אפליקציה בחנות Google Play שזמינה לפחות לחלק מהמשתמשים בארגון. (חלק מהאפליקציות מוגבלות לארגון אחד, ומידע עליהן לא זמין מחוץ לארגון הזה).

המידע שניתן לכל מוצר (שם, סמל, קישור לדף הפרטים המלא ב-Google Play) נועד לאפשר ייצוג בסיסי של המוצר בתוך ממשק משתמש של EMM. 



{
  "kind": "androidenterprise#product",
  "productId": string,
  "title": string,
  "authorName": string,
  "iconUrl": string,
  "smallIconUrl": string,
  "detailsUrl": string,
  "workDetailsUrl": string,
  "requiresContainerApp": boolean,
  "appVersion": [
    {
      "versionString": string,
      "versionCode": integer,
      "track": string,
      "targetSdkVersion": integer,
      "trackId": [
        string
      ],
      "isProduction": boolean
    }
  ],
  "distributionChannel": string,
  "productPricing": string,
  "signingCertificate": {
    "certificateHashSha256": string,
    "certificateHashSha1": string
  },
  "availableTracks": [
    string
  ],
  "appTracks": [
    {
      "trackId": string,
      "trackAlias": string
    }
  ],
  "description": string,
  "fullDescription": string,
  "screenshotUrls": [
    string
  ],
  "category": string,
  "recentChanges": string,
  "minAndroidSdkVersion": integer,
  "contentRating": string,
  "lastUpdatedTimestampMillis": long,
  "permissions": [
    {
      "permissionId": string,
      "state": string
    }
  ],
  "availableCountries": [
    string
  ],
  "features": [
    string
  ],
  "iarcGenericRating": string,
  "appRestrictionsSchema": {
    "kind": string,
    "restrictions": [
      {
        "key": string,
        "title": string,
        "restrictionType": string,
        "description": string,
        "entry": [
          string
        ],
        "entryValue": [
          string
        ],
        "defaultValue": {
          "type": string,
          "valueBool": boolean,
          "valueString": string,
          "valueInteger": integer,
          "valueMultiselect": [
            string
          ]
        },
        "nestedRestriction": [
          (AppRestrictionsSchemaRestriction)
        ]
      }
    ]
  }
}
שם הנכס ערך תיאור הערות
appRestrictionsSchema nested object סכימת ההגבלות על אפליקציות
appRestrictionsSchema.kind string הוצא משימוש.

appRestrictionsSchema.restrictions[] list קבוצת ההגבלות שמהן מורכב הסכימה הזו.
appRestrictionsSchema.restrictions[].defaultValue nested object ערך ברירת המחדל של ההגבלה. להגבלות bundle ו-bundleArray אין ערך ברירת מחדל.
appRestrictionsSchema.restrictions[].defaultValue.type string סוג הערך שצוין.

הערכים הקבילים הם:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].defaultValue.valueBool boolean הערך הבוליאני - הערך הזה יופיע רק אם הסוג הוא בוליאני.
appRestrictionsSchema.restrictions[].defaultValue.valueInteger integer הערך 'מספר שלם' - הערך הזה יופיע רק אם הסוג הוא מספר שלם.
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] list רשימת ערכי המחרוזת – יוצג רק אם הסוג הוא בחירה מרובה.
appRestrictionsSchema.restrictions[].defaultValue.valueString string ערך המחרוזת – הוא יופיע עבור סוגי המחרוזת, הבחירה והמוסתר.
appRestrictionsSchema.restrictions[].description string תיאור ארוך יותר של ההגבלה, עם פרטים נוספים על ההשפעה שלה.
appRestrictionsSchema.restrictions[].entryValue[] list להגבלות choice או multiselect, רשימת הערכים האפשריים שמחשב יכול לקרוא. צריך להשתמש בערכים האלה בהגדרות האישיות, או כערך string יחיד להגבלה על choice או כערך stringArray עבור הגבלה של multiselect.
appRestrictionsSchema.restrictions[].entry[] list בהגבלות choice או multiselect, רשימת השמות הקריאים לאנשים של הערכים האפשריים.
appRestrictionsSchema.restrictions[].key string המפתח הייחודי שבו המוצר משתמש לזיהוי ההגבלה, למשל com.google.android.gm.fieldname.
appRestrictionsSchema.restrictions[].nestedRestriction[] list בהגבלות bundle או bundleArray, רשימת ההגבלות שהוצבו. הגבלה מסוג bundle תמיד מקוננת בהגבלה bundleArray, והגבלה bundleArray נמצאת עמוקה לכל היותר בשתי רמות.
appRestrictionsSchema.restrictions[].restrictionType string סוג ההגבלה.

הערכים הקבילים הם:
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "string"
appRestrictionsSchema.restrictions[].title string שם ההגבלה.
appTracks[] list המסלולים שגלויים לארגון.
appTracks[].trackAlias string שם של טראק שאפשר לשנות. זהו השם הגלוי ב-Play Developer Console.
appTracks[].trackId string מזהה טראק ייחודי שלא ניתן לשנות. המזהה הזה הוא ReleaseTrackId בכתובת ה-URL של הדף של Play Developer Console שמציג את פרטי הטראק.
appVersion[] list גרסאות אפליקציה זמינות כרגע למוצר הזה.
appVersion[].isProduction boolean הערך הוא True אם הגרסה הזו היא APK בסביבת ייצור.
appVersion[].targetSdkVersion integer גרסת ה-SDK שהאפליקציה הזו מטרגטת, כפי שצוין במניפסט של ה-APK. פרטים נוספים זמינים בכתובת http://developer.android.com/guide/topics/manifest/uses-sdk-element.html
appVersion[].track string הוצא משימוש. במקומו צריך להשתמש ב-trackId.

הערכים הקבילים הם:
  • "alpha"
  • "beta"
  • "production"
appVersion[].trackId[] list מזהים לצורכי מעקב שבהם פורסמה גרסת האפליקציה. מחליפה את השדה track (הוצא משימוש), אבל לא כוללת את המסלול לסביבת הייצור (אפשר לעיין במקום זאת ב-isProduction).
appVersion[].versionCode integer מזהה ייחודי הולך וגדל של גרסת האפליקציה.
appVersion[].versionString string המחרוזת המשמשת את מפתח האפליקציה בחנות Play לזיהוי הגרסה. המחרוזת היא לא בהכרח ייחודית או מותאמת לשוק המקומי (לדוגמה, המחרוזת יכולה להיות '1.4').
authorName string השם של מחבר המוצר (לדוגמה, מפתח האפליקציה).
availableCountries[] list המדינות שבהן האפליקציה הזו זמינה.
availableTracks[] list הוצא משימוש. במקומו צריך להשתמש ב-appTracks.
category string קטגוריית האפליקציה (למשל, RACING, SOCIAL וכו')
contentRating string סיווג התוכן של האפליקציה הזו.

הערכים הקבילים הם:
  • "all"
  • "mature"
  • "preTeen"
  • "teen"
description string תיאור המבצע המותאם לשוק המקומי, אם יש כזה.
detailsUrl string קישור לדף הפרטים (לצרכנים) ב-Google Play של המוצר.
distributionChannel string איך ולמי החבילה זמינה. המשמעות של הערך publicGoogleHosted היא שהחבילה זמינה דרך חנות Play ולא מוגבלת לארגון ספציפי. המשמעות של הערך privateGoogleHosted היא שהחבילה היא אפליקציה פרטית (מוגבלת לארגון) אבל מארחת אותה ב-Google. המשמעות של הערך privateSelfHosted היא שהחבילה היא אפליקציה פרטית (מוגבלת לארגון) והיא מתארחת באופן פרטי.

הערכים הקבילים הם:
  • "privateGoogleHosted"
  • "privateSelfHosted"
  • "publicGoogleHosted"
features[] list תכונות ראויות לציון (אם יש) של מוצר זה.
fullDescription string התיאור המלא של חנות האפליקציות המותאם לשוק המקומי, אם זמין.
iarcGenericRating string סיווג התוכן של האפליקציה הזו.

הערכים הקבילים הם:
  • "eighteenYears"
  • "iarcGenericRatingUnspecified"
  • "sevenYears"
  • "sixteenYears"
  • "threeYears"
  • "twelveYears"
iconUrl string קישור לתמונה שיכולה לשמש כסמל של המוצר. התמונה הזו מתאימה לשימוש בגודל של עד 512px x 512px.
kind string
lastUpdatedTimestampMillis long הזמן המשוער (בתוך 7 ימים) שבו האפליקציה פורסמה לאחרונה, מבוטא באלפיות שנייה מתחילת התקופה.
minAndroidSdkVersion integer ערכת ה-SDK המינימלית של Android שנדרשת להפעלת האפליקציה.
permissions[] list רשימת ההרשאות שהאפליקציה צריכה.
permissions[].permissionId string מחרוזת אטומה המזהה באופן ייחודי את ההרשאה.
permissions[].state string האם ההרשאה התקבלה, או לא.

הערכים הקבילים הם:
  • "accepted"
  • "required"
productId string מחרוזת בפורמט app:<package name>. לדוגמה, app:com.google.android.gm מייצג את אפליקציית Gmail.
productPricing string אם המוצר הזה ניתן בחינם, בחינם עם רכישות מתוך האפליקציה או בתשלום. אם המחיר לא ידוע, המשמעות היא שהמוצר כבר לא זמין לכלל המשתמשים (למרות שהוא עדיין זמין לאנשים שבבעלותם).

הערכים הקבילים הם:
  • "free"
  • "freeWithInAppPurchase"
  • "paid"
recentChanges string תיאור של השינויים האחרונים שבוצעו באפליקציה.
requiresContainerApp boolean הוּצא משימוש.
screenshotUrls[] list רשימה של קישורים לצילומי מסך שמייצגים את האפליקציה.
signingCertificate nested object האישור ששימש לחתימה על המוצר הזה.
signingCertificate.certificateHashSha1 string גיבוב SHA1 עם קידוד כתובת האתר של base64 עם האישור. (השדה הזה הוצא משימוש לטובת SHA2-256. אין להשתמש בו וייתכן שהוא יוסר בכל שלב.)

signingCertificate.certificateHashSha256 string גיבוב SHA2-256 עם קידוד כתובת ה-URLsafe של base64 של האישור.
smallIconUrl string קישור לתמונה קטנה יותר שיכולה לשמש כסמל של המוצר. התמונה הזו מתאימה לשימוש בגודל של עד 128px x 128px.
title string שם המוצר.
workDetailsUrl string קישור לדף הפרטים של המוצר ב-Google Play לארגונים, לשימוש של אדמין בארגון.

שיטות

לאשר

אישור המוצר שצוין וההרשאות הרלוונטיות לאפליקציה, אם יש כאלה. מספר המוצרים המקסימלי שאפשר לאשר לכל לקוח בארגון הוא 1,000.

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

generateApprovalUrl
יוצרת כתובת URL שאפשר לעבד ב-iframe כדי להציג את ההרשאות (אם יש) של מוצר. כדי לאשר את המוצר, אדמינים בארגון צריכים לראות את ההרשאות האלה ולאשר אותן בשם הארגון.

אדמינים צריכים לקבל את ההרשאות שמוצגות על ידי אינטראקציה עם רכיב נפרד בממשק המשתמש במסוף ה-EMM, והפעולה הזו צריכה להפעיל את השימוש בכתובת ה-URL הזו כנכס approvalUrlInfo.approvalUrl בקריאה ל-Products.approve כדי לאשר את המוצר. ניתן להשתמש בכתובת ה-URL הזו רק להצגת הרשאות למשך עד יום אחד.
הורדה
אחזור פרטים של מוצר לצורך הצגה לאדמין בארגון.
getAppRestrictionsSchema
אחזור הסכימה שמגדירה את המאפיינים שאפשר להגדיר למוצר הזה. לכל המוצרים יש סכימה, אבל אם לא הוגדרו הגדרות מנוהלות, הסכימה הזו יכולה להיות ריקה. אפשר להשתמש בסכימה הזו כדי לאכלס ממשק משתמש שמאפשר לאדמין להגדיר את המוצר. במאמר הגדרות מנוהלות דרך Play תוכלו לקרוא איך מחילים הגדרה מנוהלת שמבוססת על הסכימה שהתקבלה באמצעות ה-API הזה.
getPermissions
אחזור ההרשאות לאפליקציה ל-Android שנדרשות לאפליקציה הזו.
list
מחפשים מוצרים שאושרו שתואמים לשאילתה, או את כל המוצרים שאושרו אם אין שאילתה.
לא לאשר
ביטול האישור של המוצר שצוין (וההרשאות הרלוונטיות לאפליקציה, אם יש)