- درخواست HTTP
- پارامترهای مسیر
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- دستگاه
- آن را امتحان کنید!
گزارشی از دستگاههای مرورگر Chrome مدیریتشده که برنامه مشخصشدهای را نصب کردهاند، ایجاد کنید.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
customer | مورد نیاز. شناسه مشتری یا "my_customer" برای استفاده از مشتری مرتبط با حساب درخواست کننده. |
پارامترهای پرس و جو
پارامترها | |
---|---|
orgUnitId | شناسه واحد سازمانی. |
appId | شناسه منحصر به فرد برنامه برای برنامهها و برنامههای افزودنی Chrome، شناسه 32 کاراکتری (مثلا ehoadneljpdggcbbknedodolkkjodefl). برای برنامه های اندروید، نام بسته (به عنوان مثال com.evernote). |
appType | نوع برنامه |
pageSize | حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 100 است. |
pageToken | رمزی برای مشخص کردن صفحه درخواستی که باید برگردانده شود. |
orderBy | فیلد مورد استفاده برای سفارش نتایج. سفارش پشتیبانی شده بر اساس فیلدها:
|
filter | رشته پرس و جو برای فیلتر کردن نتایج، فیلدهای جدا شده با AND در نحو EBNF. توجه: عملیات OR در این فیلتر پشتیبانی نمی شود. فیلدهای فیلتر پشتیبانی شده:
|
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ حاوی لیستی از دستگاههایی که برنامه درخواست شده نصب شده است.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"devices": [
{
object ( |
فیلدها | |
---|---|
devices[] | لیستی از دستگاه هایی که برنامه را نصب کرده اند. در قسمت Device.machine به ترتیب حروف الفبای صعودی مرتب شده است. |
nextPageToken | رمزی برای مشخص کردن صفحه بعدی درخواست. |
totalSize | تعداد کل درخواست مطابقت دستگاه. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.reports.readonly
دستگاه
دستگاهی را توصیف می کند که اطلاعات مرورگر Chrome را گزارش می دهد.
نمایندگی JSON |
---|
{ "deviceId": string, "machine": string } |
فیلدها | |
---|---|
deviceId | فقط خروجی شناسه دستگاهی که این اطلاعات مرورگر Chrome را گزارش کرده است. |
machine | فقط خروجی نام دستگاه در شبکه محلی آن. |