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