إنشاء تقرير عن أجهزة متصفّح 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 |
النتائج فقط. اسم الجهاز ضمن شبكته المحلية. |