تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعدِّل مجموعة المنتجات التي يحق للمستخدم الوصول إليها (يُشار إليها باسم
المنتجات whitelisted). لا يمكن إدراج المنتجات في القائمة البيضاء إلا
التي تمت الموافقة عليها
أو المنتجات التي تمت الموافقة عليها سابقًا (المنتجات التي تم إبطال موافقة).
الطلب
طلب HTTP
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/availableProductSet
تمثّل هذه السمة قائمة معرّفات المنتجات التي تشكّل مجموعة المنتجات.
productSetBehavior
string
تمثّل هذه السمة تفسير مجموعة المنتجات هذه. لا ينبغي أبدًا إرسال القيمة "غير معروف" وتجاهلها في حال استلام هذه البيانات. "القائمة البيضاء" تعني أن المستخدم يحق له الوصول إلى مجموعة المنتجات. تعني عبارة "تضمين الكل" إمكانية الوصول إلى جميع المنتجات، بما في ذلك المنتجات التي تمت الموافقة عليها والمنتجات التي تم إبطال موافقتها والمنتجات التي لم تتم الموافقة عليها مطلقًا. تعني عبارة "جميع المنتجات التي تمت الموافقة عليها" أنّه يحق للمستخدم الوصول إلى جميع المنتجات التي تمت الموافقة عليها للمؤسسة. وفي حال كانت القيمة هي "allApproved" أو "includeAll"، يتم تجاهل حقل productId. وإذا لم يتم تقديم أي قيمة، يتم تفسيرها على أنها "قائمة بيضاء" للتوافق مع الأنظمة القديمة. ولا يؤدي استخدام خيار "allApproved" أو "includeAll" إلى تفعيل مستوى الظهور التلقائي لمسارات الإصدار "ألفا" أو "إصدار تجريبي" لتطبيق Android. ويمكنك استخدام ميزة Product visibility لتفعيل مسارات "الإصدار الأولي" أو "الإصدار التجريبي" لكل مستخدم.
في ما يلي القيم المقبولة:
"allApproved"
"includeAll"
"whitelist"
productVisibility[]
list
قائمة إضافية بمعرّفات المنتجات التي تشكّل مجموعة المنتجات على عكس مصفوفة productID، من الممكن في هذه القائمة تحديد المسارات (ألفا أو التجريبية أو الإنتاج) للمنتج التي تكون مرئية للمستخدم. يمكنك الاطّلاع على Product visibility وحقولها للحصول على مزيد من المعلومات. لا يُسمح بتحديد معرّف المنتج نفسه هنا وفي مصفوفة productId معًا، وسيؤدي ذلك إلى حدوث خطأ.
productVisibility[].productId
string
معرّف المنتج المطلوب إظهاره للمستخدم. مطلوبة لكل سلعة في قائمة تفاصيل المنتج
productVisibility[].tracks[]
list
تمّ الإيقاف. يمكنك استخدام trackIds كبديل.
productVisibility[].trackIds[]
list
يمنح المستخدم إذن الوصول إلى مسارات المنتجات المحدّدة التي تم تحديدها من خلال trackIds.
kind
string
الإجابة
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
تمثّل هذه السمة قائمة معرّفات المنتجات التي تشكّل مجموعة المنتجات.
productSetBehavior
string
تمثّل هذه السمة تفسير مجموعة المنتجات هذه. لا ينبغي أبدًا إرسال القيمة "غير معروف" وتجاهلها في حال استلام هذه البيانات. "القائمة البيضاء" تعني أن المستخدم يحق له الوصول إلى مجموعة المنتجات. تعني عبارة "تضمين الكل" إمكانية الوصول إلى جميع المنتجات، بما في ذلك المنتجات التي تمت الموافقة عليها والمنتجات التي تم إبطال موافقتها والمنتجات التي لم تتم الموافقة عليها مطلقًا. تعني عبارة "جميع المنتجات التي تمت الموافقة عليها" أنّه يحق للمستخدم الوصول إلى جميع المنتجات التي تمت الموافقة عليها للمؤسسة. وفي حال كانت القيمة هي "allApproved" أو "includeAll"، يتم تجاهل حقل productId. وإذا لم يتم تقديم أي قيمة، يتم تفسيرها على أنها "قائمة بيضاء" للتوافق مع الأنظمة القديمة. ولا يؤدي استخدام خيار "allApproved" أو "includeAll" إلى تفعيل مستوى الظهور التلقائي لمسارات الإصدار "ألفا" أو "إصدار تجريبي" لتطبيق Android. ويمكنك استخدام ميزة Product visibility لتفعيل مسارات "الإصدار الأولي" أو "الإصدار التجريبي" لكل مستخدم.
في ما يلي القيم المقبولة:
"allApproved"
"includeAll"
"whitelist"
productVisibility[]
list
قائمة إضافية بمعرّفات المنتجات التي تشكّل مجموعة المنتجات على عكس مصفوفة productID، من الممكن في هذه القائمة تحديد المسارات (ألفا أو التجريبية أو الإنتاج) للمنتج التي تكون مرئية للمستخدم. يمكنك الاطّلاع على Product visibility وحقولها للحصول على مزيد من المعلومات. لا يُسمح بتحديد معرّف المنتج نفسه هنا وفي مصفوفة productId معًا، وسيؤدي ذلك إلى حدوث خطأ.
productVisibility[].productId
string
معرّف المنتج المطلوب إظهاره للمستخدم. مطلوبة لكل سلعة في قائمة تفاصيل المنتج
productVisibility[].tracks[]
list
تمّ الإيقاف. يمكنك استخدام trackIds كبديل.
productVisibility[].trackIds[]
list
يمنح المستخدم إذن الوصول إلى مسارات المنتجات المحدّدة التي تم تحديدها من خلال trackIds.