שינוי קבוצת המוצרים שלמשתמש יש גישה אליהם (שנקראים מוצרים שנמצאים ברשימת ההיתרים). רק מוצרים שאושרו או מוצרים שאושרו בעבר (מוצרים עם אישור מבוטל) יכולים להיכלל ברשימת ההיתרים. הערה: הפריט הזה הוצא משימוש. שילובים חדשים לא יכולים להשתמש בשיטה הזו ויכולים להתייחס להמלצות החדשות שלנו.
שליחת בקשה
בקשת HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/availableProductSet
פרמטרים
שם הפרמטר | ערך | תיאור |
---|---|---|
פרמטרים של נתיב | ||
enterpriseId |
string |
המזהה של הארגון. |
userId |
string |
המזהה של המשתמש. |
הרשאה
בקשה זו מחייבת הרשאה בהיקף הבא:
היקף |
---|
https://www.googleapis.com/auth/androidenterprise |
למידע נוסף, עיינו בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, צריך לספק את הנתונים במבנה הבא:
{ "kind": "androidenterprise#productSet", "productId": [ string ], "productSetBehavior": string, "productVisibility": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ] } ] }
שם הנכס | ערך | תיאור | הערות |
---|---|---|---|
productId[] |
list |
רשימת מזהי המוצרים שמהם מורכבת קבוצת המוצרים. | |
productSetBehavior |
string |
הפרשנות של קבוצת המוצרים הזו. אסור לשלוח את הערך "לא ידוע", והמערכת תתעלם ממנו אם הוא יתקבל. "רשימת היתרים" פירושה שהמשתמש זכאי לגשת לקבוצת המוצרים. המשמעות של "הכללת הכול" היא שכל המוצרים נגישים, כולל מוצרים שאושרו, מוצרים שנפסלו ומוצרים שלא אושרו. המשמעות של "כל שאושרו" היא שהמשתמש רשאי לגשת לכל המוצרים שאושרו לארגון. אם הערך הוא "allApproved" או "includeAll", המערכת תתעלם מהשדה productId. אם לא צוין ערך, המערכת מפרשת את הערך כ"רשימת היתרים" לצורך תאימות לאחור. נוסף לכך, ההגדרה "allאושר" או "includeAll" אינה מאפשרת חשיפה אוטומטית של רצועות "אלפא" או "בטא" עבור אפליקציה ל-Android. יש להשתמש בחשיפה למוצרים כדי להפעיל רצועות "אלפא" או "בטא" לכל משתמש.
הערכים הקבילים הם:
|
|
productVisibility[] |
list |
רשימה נוספת של מזהי מוצרים שמהם מורכבת קבוצת המוצרים. בניגוד למערך productID, ברשימה הזו אפשר לציין אילו טראקים (אלפא, בטא, ייצור) של מוצר יהיו גלויים למשתמשים. בקטע 'ניראות של המוצר' ובשדות שלו אפשר למצוא מידע נוסף. לא ניתן לציין את אותו מזהה מוצר גם כאן וגם במערך productId, וכתוצאה מכך תתקבל שגיאה. | |
productVisibility[].productId |
string |
מזהה המוצר שגלוי למשתמש. חובה לכל פריט ברשימת החשיפה של המוצר. | |
productVisibility[].tracks[] |
list |
הוּצא משימוש. במקומה, צריך להשתמש במדיניות trackIds . |
|
productVisibility[].trackIds[] |
list |
הרשאות הגישה של המשתמשים למסלולי המוצרים שצוינו, שזוהו על ידי trackIds . |
|
kind |
string |
תשובה
אם התגובה מוצלחת, שיטה זו תחזיר גוף תגובה בעל המבנה הבא:
{ "kind": "androidenterprise#productSet", "productId": [ string ], "productSetBehavior": string, "productVisibility": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ] } ] }
שם הנכס | ערך | תיאור | הערות |
---|---|---|---|
productId[] |
list |
רשימת מזהי המוצרים שמהם מורכבת קבוצת המוצרים. | |
productSetBehavior |
string |
הפרשנות של קבוצת המוצרים הזו. אסור לשלוח את הערך "לא ידוע", והמערכת תתעלם ממנו אם הוא יתקבל. "רשימת היתרים" פירושה שהמשתמש זכאי לגשת לקבוצת המוצרים. המשמעות של "הכללת הכול" היא שכל המוצרים נגישים, כולל מוצרים שאושרו, מוצרים שנפסלו ומוצרים שלא אושרו. המשמעות של "כל שאושרו" היא שהמשתמש רשאי לגשת לכל המוצרים שאושרו לארגון. אם הערך הוא "allApproved" או "includeAll", המערכת תתעלם מהשדה productId. אם לא צוין ערך, המערכת מפרשת את הערך כ"רשימת היתרים" לצורך תאימות לאחור. נוסף לכך, ההגדרה "allאושר" או "includeAll" אינה מאפשרת חשיפה אוטומטית של רצועות "אלפא" או "בטא" עבור אפליקציה ל-Android. יש להשתמש בחשיפה למוצרים כדי להפעיל רצועות "אלפא" או "בטא" לכל משתמש.
הערכים הקבילים הם:
|
|
productVisibility[] |
list |
רשימה נוספת של מזהי מוצרים שמהם מורכבת קבוצת המוצרים. בניגוד למערך productID, ברשימה הזו אפשר לציין אילו טראקים (אלפא, בטא, ייצור) של מוצר יהיו גלויים למשתמשים. בקטע 'ניראות של המוצר' ובשדות שלו אפשר למצוא מידע נוסף. לא ניתן לציין את אותו מזהה מוצר גם כאן וגם במערך productId, וכתוצאה מכך תתקבל שגיאה. | |
productVisibility[].productId |
string |
מזהה המוצר שגלוי למשתמש. חובה לכל פריט ברשימת החשיפה של המוצר. | |
productVisibility[].tracks[] |
list |
הוּצא משימוש. במקומה, צריך להשתמש במדיניות trackIds . |
|
productVisibility[].trackIds[] |
list |
הרשאות הגישה של המשתמשים למסלולי המוצרים שצוינו, שזוהו על ידי trackIds . |
|
kind |
string |