Users: setAvailableProductSet

تُعدّل مجموعة المنتجات التي يحق للمستخدم الوصول إليها (المشار إليها كمنتجات مُضافة إلى القائمة البيضاء). فقط المنتجات التي موافَق عليه أو المنتجات التي تمت الموافقة عليها سابقًا (المنتجات التي تم إبطال الموافقة عليها) يمكنك إضافته إلى القائمة البيضاء.

الطلب

طلب 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. إذا لم يتم تقديم أي قيمة، سيتم تفسيرها على أنّها "قائمة بيضاء". للتوافق مع الأنظمة القديمة. بالإضافة إلى "الكل تمت الموافقة عليه" أو "تضمين الكل" لا يؤدي إلى تفعيل الرؤية التلقائية لـ "alpha" أو "تجريبي" الخاصة بتطبيق Android. استخدام Product visibility لتفعيل القيمة "alpha" أو "تجريبي" المسارات لكل مستخدم.

في ما يلي القيم المقبولة:
  • "allApproved"
  • "includeAll"
  • "whitelist"
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
      ]
    }
  ]
}
اسم الموقع القيمة الوصف ملاحظات
productId[] list تمثّل هذه السمة قائمة معرّفات المنتجات التي تشكّل مجموعة المنتجات.
productSetBehavior string تمثّل هذه السمة تفسير مجموعة المنتجات هذه. "غير معروف" ولا يجب أن يتم إرساله وتجاهله في حالة استلامه. "القائمة البيضاء" تعني أنه يحق للمستخدم الوصول إلى مجموعة المنتجات. "تضمين الكل" يعني هذا أنّه يمكن الوصول إلى جميع المنتجات، بما في ذلك المنتجات التي تمت الموافقة عليها والمنتجات التي تم إبطال الموافقة عليها والمنتجات التي لم تتم الموافقة عليها. "تمت الموافقة على الكل" يعني أن المستخدم يحق له الوصول إلى جميع المنتجات التي تمت الموافقة عليها للمؤسسة. في حال كانت القيمة هي "allApproved" أو "includeAll"، يتم تجاهل حقل productId. إذا لم يتم تقديم أي قيمة، سيتم تفسيرها على أنّها "قائمة بيضاء". للتوافق مع الأنظمة القديمة. بالإضافة إلى "الكل تمت الموافقة عليه" أو "تضمين الكل" لا يؤدي إلى تفعيل الرؤية التلقائية لـ "alpha" أو "تجريبي" الخاصة بتطبيق Android. استخدام Product visibility لتفعيل القيمة "alpha" أو "تجريبي" المسارات لكل مستخدم.

في ما يلي القيم المقبولة:
  • "allApproved"
  • "includeAll"
  • "whitelist"
productVisibility[] list قائمة إضافية بمعرّفات المنتجات التي تشكّل مجموعة المنتجات على عكس مصفوفة productID، من الممكن في هذه القائمة تحديد المسارات (ألفا أو التجريبية أو الإنتاج) للمنتج التي تكون مرئية للمستخدم. يمكنك الاطّلاع على Product visibility وحقولها للحصول على مزيد من المعلومات. لا يُسمح بتحديد معرّف المنتج نفسه هنا وفي مصفوفة productId معًا، وسيؤدي ذلك إلى حدوث خطأ.
productVisibility[].productId string معرّف المنتج المطلوب إظهاره للمستخدم. مطلوبة لكل سلعة في قائمة تفاصيل المنتج
productVisibility[].tracks[] list تمّ الإيقاف. يمكنك استخدام trackIds كبديل.
productVisibility[].trackIds[] list يمنح المستخدم إذن الوصول إلى مسارات المنتجات المحدّدة التي تم تحديدها من خلال trackIds.
kind string