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 تفسیر این مجموعه محصول. "ناشناخته" هرگز نباید ارسال شود و در صورت دریافت نادیده گرفته می شود. "لیست سفید" به این معنی است که کاربر حق دسترسی به مجموعه محصول را دارد. "includeAll" به این معنی است که همه محصولات قابل دسترسی هستند، از جمله محصولات تایید شده، محصولات با تاییدیه لغو شده و محصولاتی که هرگز تایید نشده اند. "allApproved" به این معنی است که کاربر حق دسترسی به تمام محصولاتی را دارد که برای شرکت تأیید شده است. اگر مقدار "allApproved" یا "includeAll" باشد، فیلد productId نادیده گرفته می شود. اگر مقداری ارائه نشود، برای سازگاری به عقب به عنوان "لیست سفید" تفسیر می شود. علاوه بر این، «allApproved» یا «IncludeAll»، مشاهده خودکار تراک‌های «آلفا» یا «بتا» را برای برنامه Android فعال نمی‌کند. از ProductVisibility برای فعال کردن آهنگ‌های «آلفا» یا «بتا» برای هر کاربر استفاده کنید.

مقادیر قابل قبول عبارتند از:
  • " allApproved "
  • " includeAll "
  • " whitelist "
productVisibility[] list فهرست اضافی از شناسه‌های محصول مجموعه محصول را تشکیل می‌دهند. برخلاف آرایه productID، در این لیست می‌توان مشخص کرد کدام تراک‌ها (آلفا، بتا، تولید) محصول برای کاربر قابل مشاهده است. برای اطلاعات بیشتر به ProductVisibility و فیلدهای آن مراجعه کنید. تعیین شناسه محصول یکسان هم در اینجا و هم در آرایه 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 برای فعال کردن آهنگ‌های «آلفا» یا «بتا» برای هر کاربر استفاده کنید.

مقادیر قابل قبول عبارتند از:
  • " allApproved "
  • " includeAll "
  • " whitelist "
productVisibility[] list لیست اضافی از شناسه های محصول مجموعه محصول را تشکیل می دهد. برخلاف آرایه productID، در این لیست می‌توان مشخص کرد که کدام تراک‌ها (آلفا، بتا، تولید) یک محصول برای کاربر قابل مشاهده است. برای اطلاعات بیشتر به ProductVisibility و فیلدهای آن مراجعه کنید. تعیین شناسه محصول یکسان هم در اینجا و هم در آرایه productId مجاز نیست و منجر به خطا می شود.
productVisibility[]. productId string شناسه محصول که برای کاربر قابل مشاهده باشد. برای هر مورد در لیست مشاهده محصول مورد نیاز است.
productVisibility[]. tracks[] list منسوخ شده است. به جای آن از trackIds استفاده کنید.
productVisibility[]. trackIds[] list مشاهده کاربر را به آهنگ(های) محصول مشخص شده، که توسط trackIds شناسایی شده اند، می دهد.
kind string