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, אמור להפעיל את השימוש בכתובת האתר הזו בתור נכס אחד (approvalUrlInfo.approvalUrl) ב קריאה אל Products.approve לאישור המוצר. ניתן להשתמש בכתובת ה-URL הזו רק להצגת הרשאות למשך עד יום אחד.

הורדה

אחזור פרטים של מוצר לצורך הצגה לאדמין בארגון.

getAppRestrictionsSchema

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

getPermissions

אחזור של ההרשאות לאפליקציה ל-Android שנדרשות לאפליקציה הזו.

list

חיפוש מוצרים שאושרו שתואמים לשאילתה, או כל המוצרים שאושרו אם אין שאילתה.

לא לאשר

ביטול האישור של המוצר שצוין (וההרשאות הרלוונטיות לאפליקציה, אם יש)