רשימה של ה-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 עם קידוד כתובת ה-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
- חיפוש מוצרים שאושרו שתואמים לשאילתה, או כל המוצרים שאושרו אם אין שאילתה.
- לא לאשר
- ביטול האישור של המוצר שצוין (וההרשאות הרלוונטיות לאפליקציה, אם יש)