רשימה של ה-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 |
סוג הערך שצוין.
הערכים הקבילים הם:
|
|
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 |
סוג ההגבלה.
הערכים הקבילים הם:
|
|
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 .
הערכים הקבילים הם:
|
|
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 |
סיווג התוכן של האפליקציה הזו.
הערכים הקבילים הם:
|
|
description |
string |
תיאור המבצע המותאם לשוק המקומי, אם יש כזה. | |
detailsUrl |
string |
קישור לדף הפרטים (לצרכנים) ב-Google Play של המוצר. | |
distributionChannel |
string |
איך ולמי החבילה זמינה. המשמעות של הערך publicGoogleHosted היא שהחבילה זמינה דרך חנות Play ולא מוגבלת לארגון ספציפי. המשמעות של הערך privateGoogleHosted היא שהחבילה היא אפליקציה פרטית (מוגבלת לארגון) אבל מארחת אותה ב-Google. המשמעות של הערך privateSelfHosted היא שהחבילה היא אפליקציה פרטית (מוגבלת לארגון) והיא מתארחת באופן פרטי.
הערכים הקבילים הם:
|
|
features[] |
list |
תכונות ראויות לציון (אם יש) של מוצר זה. | |
fullDescription |
string |
התיאור המלא של חנות האפליקציות המותאם לשוק המקומי, אם זמין. | |
iarcGenericRating |
string |
סיווג התוכן של האפליקציה הזו.
הערכים הקבילים הם:
|
|
iconUrl |
string |
קישור לתמונה שיכולה לשמש כסמל של המוצר. התמונה הזו מתאימה לשימוש בגודל של עד 512px x 512px. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
הזמן המשוער (בתוך 7 ימים) שבו האפליקציה פורסמה לאחרונה, מבוטא באלפיות שנייה מתחילת התקופה. | |
minAndroidSdkVersion |
integer |
ערכת ה-SDK המינימלית של Android שנדרשת להפעלת האפליקציה. | |
permissions[] |
list |
רשימת ההרשאות שהאפליקציה צריכה. | |
permissions[].permissionId |
string |
מחרוזת אטומה המזהה באופן ייחודי את ההרשאה. | |
permissions[].state |
string |
האם ההרשאה התקבלה, או לא.
הערכים הקבילים הם:
|
|
productId |
string |
מחרוזת בפורמט app:<package name> . לדוגמה, app:com.google.android.gm מייצג את אפליקציית Gmail. |
|
productPricing |
string |
אם המוצר הזה ניתן בחינם, בחינם עם רכישות מתוך האפליקציה או בתשלום. אם המחיר לא ידוע, המשמעות היא שהמוצר כבר לא זמין לכלל המשתמשים (למרות שהוא עדיין זמין לאנשים שבבעלותם).
הערכים הקבילים הם:
|
|
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
- מחפשים מוצרים שאושרו שתואמים לשאילתה, או את כל המוצרים שאושרו אם אין שאילתה.
- לא לאשר
- ביטול האישור של המוצר שצוין (וההרשאות הרלוונטיות לאפליקציה, אם יש)