يعدّل مجموعة المنتجات التي يحق للمستخدم الوصول إليها (المشار إليها بمنتجات القائمة البيضاء) لا يمكن إضافة المنتجات التي تمت الموافقة عليها أو المنتجات التي تمت الموافقة عليها سابقًا (المنتجات التي تمّ رفض الموافقة عليها) إلى القائمة البيضاء فقط. ملاحظة: تم إيقاف العمل بهذا العنصر. لا يمكن لعمليات الدمج الجديدة استخدام هذه الطريقة ويمكنها الرجوع إلى توصياتنا الجديدة.
طلب
طلب 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 |
تفسير مجموعة المنتجات هذه. لا يمكن مطلقًا إرسال القيمة "غير معروف" وتجاهلها في حال استلامها. وتعني "القائمة البيضاء" أنّ المستخدم يحق له الوصول إلى مجموعة المنتجات. "includeAll" تعني أن جميع المنتجات قابلة للوصول، بما في ذلك المنتجات التي تمت الموافقة عليها، والمنتجات التي تم إبطال الموافقة عليها، والمنتجات التي لم تتم الموافقة عليها من قبل. وتعني "allapproved" أن المستخدم يحق له الدخول إلى جميع المنتجات التي تمت الموافقة عليها للمؤسسة. إذا كانت القيمة هي "allapproved" أو "includeAll"، سيتم تجاهل حقل productId. في حال عدم تقديم قيمة، يتم تفسيرها على أنها "قائمة بيضاء" من أجل التوافق مع الإصدارات القديمة. علاوة على ذلك، لا يؤدي تفعيل "allapproved" أو "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 |
تفسير مجموعة المنتجات هذه. لا يمكن مطلقًا إرسال القيمة "غير معروف" وتجاهلها في حال استلامها. وتعني "القائمة البيضاء" أنّ المستخدم يحق له الوصول إلى مجموعة المنتجات. "includeAll" تعني أن جميع المنتجات قابلة للوصول، بما في ذلك المنتجات التي تمت الموافقة عليها، والمنتجات التي تم إبطال الموافقة عليها، والمنتجات التي لم تتم الموافقة عليها من قبل. وتعني "allapproved" أن المستخدم يحق له الدخول إلى جميع المنتجات التي تمت الموافقة عليها للمؤسسة. إذا كانت القيمة هي "allapproved" أو "includeAll"، سيتم تجاهل حقل productId. في حال عدم تقديم قيمة، يتم تفسيرها على أنها "قائمة بيضاء" من أجل التوافق مع الإصدارات القديمة. علاوة على ذلك، لا يؤدي تفعيل "allapproved" أو "includeAll" إلى تمكين مستوى الرؤية التلقائي للمسارات "ألفا" أو "التجريبية" لتطبيق Android. استخدم "مستوى رؤية المنتج" لتمكين مسارات "ألفا" أو "تجريبية" لكل مستخدم.
القيم المقبولة هي:
|
|
productVisibility[] |
list |
قائمة إضافية بمعرّفات المنتجات التي تشكّل مجموعة المنتجات. بخلاف مصفوفة productID، من الممكن في هذه القائمة تحديد المسارات (ألفا، الإصدار التجريبي، الإنتاج) التي تكون مرئية للمستخدم. راجع "مستوى رؤية المنتج" وحقوله لمزيد من المعلومات. لا يُسمح بتحديد معرّف المنتج نفسه هنا وفي مصفوفة productId وسيؤدي ذلك إلى حدوث خطأ. | |
productVisibility[].productId |
string |
رقم تعريف المنتج ليكون مرئيًا للمستخدم. مطلوبة لكل سلعة في قائمة "مستوى رؤية المنتج". | |
productVisibility[].tracks[] |
list |
تمّ الإيقاف. يمكنك استخدام trackIds بدلاً من ذلك. |
|
productVisibility[].trackIds[] |
list |
يمنح المستخدم حق الوصول إلى مسارات المنتجات المحدّدة، والتي يحدّدها trackIds . |
|
kind |
string |