- درخواست HTTP
- پارامترهای مسیر
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- دستگاه
- آن را امتحان کنید!
گزارشی از دستگاههای مرورگر Chrome مدیریتشده که برنامه مشخصشدهای را نصب کردهاند، ایجاد کنید.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
customer | مورد نیاز. شناسه مشتری یا "my_customer" برای استفاده از مشتری مرتبط با حساب درخواست کننده. |
پارامترهای پرس و جو
پارامترها | |
---|---|
org Unit Id | شناسه واحد سازمانی. |
app Id | شناسه منحصر به فرد برنامه برای برنامهها و برنامههای افزودنی Chrome، شناسه 32 کاراکتری (مثلا ehoadneljpdggcbbknedodolkkjodefl). برای برنامه های اندروید، نام بسته (به عنوان مثال com.evernote). |
app Type | نوع برنامه |
page Size | حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 100 است. |
page Token | رمزی برای مشخص کردن صفحه درخواستی که باید برگردانده شود. |
order By | فیلد مورد استفاده برای سفارش نتایج. سفارش پشتیبانی شده بر اساس فیلدها:
|
filter | رشته پرس و جو برای فیلتر کردن نتایج، فیلدهای جدا شده با AND در نحو EBNF. توجه: عملیات OR در این فیلتر پشتیبانی نمی شود. فیلدهای فیلتر پشتیبانی شده:
|
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ حاوی لیستی از دستگاههایی که برنامه درخواست شده نصب شده است.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"devices": [
{
object ( |
فیلدها | |
---|---|
devices[] | لیستی از دستگاه هایی که برنامه را نصب کرده اند. در قسمت Device.machine به ترتیب حروف الفبای صعودی مرتب شده است. |
next Page Token | رمزی برای مشخص کردن صفحه بعدی درخواست. |
total Size | تعداد کل درخواست مطابقت دستگاه. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.reports.readonly
دستگاه
دستگاهی را توصیف می کند که اطلاعات مرورگر Chrome را گزارش می دهد.
نمایندگی JSON |
---|
{ "deviceId": string, "machine": string } |
فیلدها | |
---|---|
device Id | فقط خروجی شناسه دستگاهی که این اطلاعات مرورگر Chrome را گزارش کرده است. |
machine | فقط خروجی نام دستگاه در شبکه محلی آن. |