Method: customers.profiles.list

تعرض هذه السمة الملفات الشخصية لمتصفّح Chrome للعميل استنادًا إلى معايير البحث والترتيب المحدّدة.

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. التنسيق: customers/{customer_id}

مَعلمات طلب البحث

المعلمات
pageSize

integer

اختياريّ. الحد الأقصى لعدد الملفات الشخصية المطلوب عرضها. حجم الصفحة التلقائي هو 100 إذا لم يتم تحديد pageSize، والحد الأقصى لحجم الصفحة المسموح به هو 200.
pageToken

string

اختياريّ. الرمز المميّز للصفحة المستخدَم لاسترداد صفحة معيّنة من طلب البيانات
filter

string

اختياريّ. الفلتر المستخدَم لفلترة الملفات التجارية يمكن استخدام الحقول التالية في الفلتر:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion
  • ouId

يمكن استخدام أيّ من الحقول أعلاه لتحديد فلتر، ويمكن الفلترة حسب حقول متعدّدة باستخدام عامل التشغيل AND. تتيح حقول نوع السلسلة وحقول نوع القائمة المحددة عوامل التشغيل "=' و"!='. يتوافق حقل نوع الأعداد الصحيحة وحقل نوع الطابع الزمني مع عوامل التشغيل "=' و"!=' و"<' و">' و"<=' و">='. تتطلّب الطوابع الزمنية سلسلة منسَّقة بتنسيق RFC-3339 (مثل ‎2012-04-21T11:30:00-04:00). يمكن استخدام الحرف البديل "*" مع فلتر حقل من النوع سلسلة. بالإضافة إلى ذلك، تتوفّر أيضًا فلترة النصوص الثابتة، على سبيل المثال، يتم ربط "ABC" كفلتر بفلتر يتحقّق مما إذا كان أيّ من حقول نوع السلسلة القابلة للفلترة يحتوي على "ABC".

يمكن استخدام رقم الوحدة التنظيمية كمعايير فلترة هنا من خلال تحديد "ouId = ${your_org_unit_id}"، يُرجى العلم أنّه لا يمكن مطابقة سوى معرّف وحدة تنظيمية واحد.
orderBy

string

اختياريّ. الحقول المستخدَمة لتحديد ترتيب النتائج في ما يلي الحقول المتوافقة:

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion

يتم الترتيب تلقائيًا بترتيب تصاعدي، ولتحديد ترتيب تنازلي لحقل معيّن، يجب إضافة اللاحقة " desc" إلى اسم الحقل. الترتيب التلقائي هو الترتيب التنازلي لـ lastStatusReportTime.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

استجابة لطريقة profiles.list

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "chromeBrowserProfiles": [
    {
      object (ChromeBrowserProfile)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
الحقول
chromeBrowserProfiles[]

object (ChromeBrowserProfile)

قائمة الملفات الشخصية التي تمّ إرجاعها
nextPageToken

string

الرمز المميّز لنظام تقسيم الصفحات الذي يمكن استخدامه لعرض الصفحة التالية.
totalSize

string (int64 format)

يمثّل إجمالي الحجم عددًا مقدَّرًا من الموارد التي تم عرضها. لا يمكن ضمان دقة البيانات التي تزيد عن 10 آلاف ملف تجاري.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/chrome.management.profiles.readonly
  • https://www.googleapis.com/auth/chrome.management.profiles