- درخواست HTTP
- پارامترهای مسیر
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- DeviceRequestingExtensionDetails
- آن را امتحان کنید!
لیستی از دستگاه هایی که درخواست نصب افزونه را داده اند دریافت کنید.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
customer | مورد نیاز. شناسه مشتری یا "my_customer" با پیشوند "customers/". |
پارامترهای پرس و جو
پارامترها | |
---|---|
extensionId | مورد نیاز. افزونه ای که می خواهیم دستگاه های درخواست کننده را برای آن پیدا کنیم. |
pageSize | اختیاری. حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 50 است. هر اندازه صفحه بزرگتر از 50 به 50 تبدیل می شود. |
pageToken | اختیاری. رمزی برای مشخص کردن صفحه درخواستی که باید برگردانده شود. توکن پس از 1 روز منقضی می شود. |
orgUnitId | شناسه واحد سازمانی. فقط دستگاه هایی را در نظر بگیرید که مستقیماً به این واحد سازمانی تعلق دارند، یعنی ارگان های فرعی شمارش نمی شوند. در صورت حذف، تمام داده ها برگردانده می شوند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ حاوی فهرستی از دستگاههایی که برنامه افزودنی درخواست شده را درخواست کردهاند.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"deviceDetails": [
{
object ( |
فیلدها | |
---|---|
deviceDetails[] | جزئیات دستگاههایی که برنامه افزودنی درخواست شده را درخواست کردهاند. |
totalSize | اختیاری. تعداد کل دستگاه ها در پاسخ. |
nextPageToken | اختیاری. رمزی برای مشخص کردن صفحه بعدی در لیست. توکن پس از 1 روز منقضی می شود. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.appdetails.readonly
DeviceRequestingExtensionDetails
جزئیات دستگاه درخواست کننده افزونه، از جمله نام دستگاه و توجیه درخواست.
نمایندگی JSON |
---|
{ "deviceName": string, "justification": string } |
فیلدها | |
---|---|
deviceName | نام دستگاهی که افزونه را درخواست کرده است. |
justification | درخواست توجیه همانطور که توسط کاربر وارد شده است. |