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