בסוף הדף תוכלו לראות רשימה של השיטות למשאב הזה.
ייצוגים של משאבים
משאב 'מוצרים' מייצג אפליקציה בחנות 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 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 |
קטגוריית האפליקציה (למשל, מרוצים, SOCIAL וכו') | |
contentRating |
string |
סיווג התוכן של האפליקציה הזו.
הערכים המקובלים הם:
|
|
description |
string |
תיאור קידום המכירות המותאם לשוק המקומי, אם יש כזה. | |
detailsUrl |
string |
קישור לדף הפרטים של המוצר ב-Google Play (לצרכנים). | |
distributionChannel |
string |
איך ולמי תהיה החבילה זמינה. המשמעות של הערך publicGoogleHosted היא שהחבילה זמינה דרך חנות Play ואינה מוגבלת לארגון ספציפי. המשמעות של הערך privateGoogleHosted היא שהחבילה היא אפליקציה פרטית (מוגבלת לארגון) אבל מתארחת ב-Google. המשמעות של הערך privateSelfHosted היא שהחבילה היא אפליקציה פרטית (מוגבלת לארגון) ומתארחת באופן פרטי.
הערכים הקבילים הם:
|
|
features[] |
list |
תכונות חשובות (אם יש) של המוצר. | |
fullDescription |
string |
תיאור מלא של חנות האפליקציות שמותאמת לשוק המקומי, אם יש תיאור זמין. | |
iarcGenericRating |
string |
סיווג התוכן של האפליקציה הזו.
הערכים המקובלים הם:
|
|
iconUrl |
string |
קישור לתמונה שיכולה לשמש כסמל של המוצר. התמונה הזו מתאימה לשימוש בגודל של עד 512 x 512 פיקסלים. | |
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 urlsafe של האישור. (השדה הזה הוצא משימוש והוחלף באלגוריתם SHA2-256. אין להשתמש בו ויכול להיות שהוא יוסר בכל שלב.) |
|
signingCertificate.certificateHashSha256 |
string |
גיבוב SHA2-256 עם קידוד base64 urlsafe של האישור. | |
smallIconUrl |
string |
קישור לתמונה קטנה יותר שיכולה לשמש כסמל של המוצר. התמונה הזו מתאימה לשימוש בגודל של עד 128 x 128 פיקסלים. | |
title |
string |
שם המוצר. | |
workDetailsUrl |
string |
קישור לדף הפרטים של המוצר ב-Google Play לארגונים, לשימושו של מנהל מערכת בארגון. |
שיטות
- אישור
מאשר את המוצר שצוין ואת ההרשאות הרלוונטיות הניתנות לאפליקציה, אם יש כאלה. המספר המקסימלי של מוצרים שאתם יכולים לאשר לכל לקוח ארגוני הוא 1,000.
במאמר עיצוב פריסת החנות מוסבר איך משתמשים ב-Google Play לארגונים כדי לעצב וליצור פריסה של חנות כדי להציג למשתמשים מוצרים שאושרו.
הערה: הפריט הזה הוצא משימוש. בשילובים חדשים אי אפשר להשתמש בשיטה הזו, והם יכולים לעיין בהמלצות החדשות שלנו.- generateApprovalUrl
- יוצרת כתובת URL שאפשר לעבד ב-iframe כדי להציג את ההרשאות (אם יש) של מוצר. כדי לאשר את המוצר, אדמין בארגון צריך לעיין בהרשאות האלה ולאשר אותן בשם הארגון.
אדמינים צריכים לאשר את ההרשאות המוצגות באמצעות אינטראקציה עם רכיב נפרד בממשק המשתמש במסוף ה-EMM. פעולה זו צריכה להפעיל את השימוש בכתובת ה-URL הזו כנכסapprovalUrlInfo.approvalUrl
בקריאה ל-Products.approve
כדי לאשר את המוצר. ניתן להשתמש בכתובת ה-URL הזו להצגת הרשאות ליום אחד בלבד לכל היותר. הערה: הפריט הזה הוצא משימוש. בשילובים חדשים אי אפשר להשתמש בשיטה הזו, והם יכולים לעיין בהמלצות החדשות שלנו. - get
- מאחזר פרטים של מוצר להצגה למנהל מערכת בארגון.
- getAppRestrictionsSchema
- מאחזר את הסכימה שמגדירה את המאפיינים הניתנים להגדרה של המוצר. לכל המוצרים יש סכימה, אבל הסכימה הזו יכולה להיות ריקה אם לא הוגדרו הגדרות מנוהלות. אפשר להשתמש בסכימה הזו כדי לאכלס ממשק משתמש שמאפשר לאדמין להגדיר את המוצר. במאמר הגדרות מנוהלות דרך Play מוסבר איך להחיל הגדרה מנוהלת על סמך הסכימה שהתקבלה באמצעות ה-API הזה.
- getPermissions
- מאחזר את ההרשאות הניתנות לאפליקציה ל-Android שנדרשות על ידי האפליקציה הזו.
- list
- המערכת תמצא מוצרים שאושרו שתואמים לשאילתה, או את כל המוצרים שאושרו, אם אין שאילתה. הערה: הפריט הזה הוצא משימוש. בשילובים חדשים אי אפשר להשתמש בשיטה הזו, והם יכולים לעיין בהמלצות החדשות שלנו.
- ביטול אישור
- ביטול האישור של המוצר שצוין (וההרשאות הרלוונטיות הניתנות לאפליקציה, אם יש כאלה) הערה: הפריט הזה הוצא משימוש. בשילובים חדשים אי אפשר להשתמש בשיטה הזו, והם יכולים לעיין בהמלצות החדשות שלנו.