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
  • 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

يتم الترتيب تلقائيًا بترتيب تصاعدي، ولتحديد الترتيب التنازلي لحقل معيّن، يجب إضافة اللاحقة " 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