إنشاء تقرير عن أجهزة متصفّح Chrome المُدارة التي تم تثبيت تطبيق محدّد عليها
طلب HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppDevices
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
customer |
مطلوب. رقم تعريف العميل أو "my_customer" استخدام العميل المرتبط بالحساب الذي يقدّم الطلب. |
معامِلات طلب البحث
المعلمات | |
---|---|
orgUnitId |
رقم تعريف الوحدة التنظيمية. |
appId |
المعرّف الفريد للتطبيق بالنسبة إلى تطبيقات Chrome وإضافاته، رقم التعريف المكوّن من 32 حرفًا (مثل ehoadneljpdggcbbknedodolkkjodefl). بالنسبة إلى تطبيقات Android، اسم الحزمة (مثل 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 |
النتائج فقط. اسم الجهاز داخل الشبكة المحلية. |