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 עם קידוד כתובת ה-URL הבטוח של 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
מאחזר את הסכימה שמגדירה את המאפיינים שניתנים להגדרה עבור המאפיין הזה המוצר. לכל המוצרים יש סכימה, אבל אם לא, הסכימה הזו יכולה להיות ריקה הגדרות מנוהלות הוגדרו. אפשר להשתמש בסכימה הזו כדי מאכלסים ממשק משתמש שמאפשר לאדמין להגדיר את המוצר. כדי להחיל הגדרה מנוהלת שמבוססת על הסכימה שהתקבלה באמצעות API, ראו הגדרות מנוהלות דרך Play.
getPermissions
אחזור של ההרשאות לאפליקציה ל-Android שנדרשות לאפליקציה הזו.
list
חיפוש מוצרים שאושרו שתואמים לשאילתה, או כל המוצרים שאושרו אם אין שאילתה.
לא לאשר
ביטול האישור של המוצר שצוין (וההרשאות הרלוונטיות לאפליקציה, אם יש)