REST Resource: customers.profiles

المرجع: ChromeBrowserProfile

تمثيل لملف شخصي في متصفّح Chrome

تمثيل JSON 
{
  "name": string,
  "profileId": string,
  "profilePermanentId": string,
  "displayName": string,
  "userId": string,
  "userEmail": string,
  "lastActivityTime": string,
  "lastPolicyFetchTime": string,
  "lastPolicySyncTime": string,
  "lastStatusReportTime": string,
  "deviceInfo": {
    object (DeviceInfo)
  },
  "osPlatformType": string,
  "osVersion": string,
  "browserVersion": string,
  "browserChannel": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "attestationCredential": {
    object (AttestationCredential)
  },
  "reportingData": {
    object (ReportingData)
  },
  "etag": string,
  "identityProvider": enum (IdentityProvider),
  "firstEnrollmentTime": string,
  "affiliationState": enum (AffiliationState),
  "policyCount": string,
  "extensionCount": string,
  "osPlatformVersion": string
}
الحقول
name

string

المعرّف التنسيق: customers/{customer_id}/profiles/{profilePermanentId}
profileId

string

النتائج فقط. رقم تعريف الملف الشخصي على جانب العميل في Chrome
profilePermanentId

string

النتائج فقط. المعرّف الدائم للملف الشخصي هو المعرّف الفريد لملف شخصي ضمن عميل واحد.
displayName

string

النتائج فقط. الاسم المعروض للملف الشخصي الذي ضبطه العميل
userId

string

النتائج فقط. رقم تعريف فريد في Directory API للمستخدم يمكن استخدامه في Admin SDK Users API.
userEmail

string

النتائج فقط. عنوان البريد الإلكتروني للمستخدم الذي ينتمي إليه الملف الشخصي
lastActivityTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر نشاط حسب الملف الشخصي

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
lastPolicyFetchTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر عملية جلب للسياسة من خلال الملف الشخصي

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
lastPolicySyncTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر مزامنة للسياسة حسب الملف الشخصي

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
lastStatusReportTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تقرير حالة حسب الملف الشخصي

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
deviceInfo

object (DeviceInfo)

النتائج فقط. معلومات أساسية عن الجهاز الذي يتوفّر عليه الملف الشخصي لا تتوفّر هذه المعلومات إلا للملفات التجارية التابعة.
osPlatformType

string

النتائج فقط. النظام الأساسي لنظام التشغيل على الجهاز الذي يتوفّر عليه الملف الشخصي
osVersion

string

النتائج فقط. إصدار نظام التشغيل للجهاز الذي يتوفّر عليه الملف الشخصي
browserVersion

string

النتائج فقط. إصدار المتصفّح الذي يتوفّر عليه الملف الشخصي
browserChannel

string

النتائج فقط. قناة المتصفّح الذي يتوفّر عليه الملف الشخصي
annotatedLocation

string

اختياريّ. الموقع الجغرافي للملف الشخصي كما وضَحه المشرف
annotatedUser

string

اختياريّ. مستخدم الملف الشخصي الذي وضَح المشرف ملاحظات عليه.
attestationCredential

object (AttestationCredential)

النتائج فقط. معلومات بيانات اعتماد الشهادة الخاصة بالملف الشخصي
reportingData

object (ReportingData)

النتائج فقط. بيانات إعداد التقارير التفصيلية للملف الشخصي لا تتوفّر هذه المعلومات إلا عند تفعيل سياسة إعداد تقارير الملفات التجارية.
etag

string

النتائج فقط. علامة Etag لمورد ChromeBrowserProfile هذا. يمكن استخدام علامة الهاشتاغ هذه مع عملية UPDATE لضمان الاتساق.
identityProvider

enum (IdentityProvider)

النتائج فقط. تحديد موفِّر الملف الشخصي
firstEnrollmentTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لأول عملية تسجيل للملف الشخصي

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
affiliationState

enum (AffiliationState)

النتائج فقط. حالة الانتماء المحدّدة للملف الشخصي
policyCount

string (int64 format)

النتائج فقط. عدد السياسات المطبَّقة على الملف الشخصي
extensionCount

string (int64 format)

النتائج فقط. عدد الإضافات المثبَّتة على الملف الشخصي
osPlatformVersion

string

النتائج فقط. الإصدار الرئيسي للنظام الأساسي لنظام التشغيل على الجهاز الذي يتوفّر عليه الملف الشخصي، من تقارير الملف الشخصي

DeviceInfo

معلومات عن جهاز يعمل بملف شخصي لمتصفّح Chrome

تمثيل JSON 
{
  "deviceType": enum (DeviceType),
  "affiliatedDeviceId": string,
  "machine": string,
  "hostname": string
}
الحقول
deviceType

enum (DeviceType)

النتائج فقط. نوع الجهاز الذي يتوفّر عليه الملف الشخصي
affiliatedDeviceId

string

النتائج فقط. رقم تعريف الجهاز الذي يحدّد الجهاز المرتبط الذي يتوفّر عليه الملف الشخصي إذا كان نوع الجهاز هو CHROME_BROWSER، يعني ذلك أنّه معرّف فريد لواجهة برمجة التطبيقات Directory API للجهاز يمكن استخدامه في Admin SDK Browsers API.
machine

string

النتائج فقط. اسم الجهاز الذي يتوفّر عليه الملف الشخصي في الأنظمة الأساسية التي لا تُبلغ عن اسم الجهاز (iOS وAndroid حاليًا)، يتم ضبط هذا المَعلم بدلاً من ذلك على معرّف جهاز المتصفّح، ولكن يُرجى العِلم أنّ هذا المعرّف مختلف عن |affiliatedDeviceId|.
hostname

string

النتائج فقط. اسم المضيف للجهاز الذي يتوفّر عليه الملف الشخصي

DeviceType

الأنواع المحتملة للجهاز

عمليات التعداد
DEVICE_TYPE_UNSPECIFIED يمثّل نوع جهاز غير محدّد.
CHROME_BROWSER تمثّل جهاز متصفّح Chrome.

AttestationCredential

معلومات المفتاح العام المرتبط بملف شخصي في متصفّح Chrome

تمثيل JSON 
{
  "keyType": enum (KeyType),
  "keyTrustLevel": enum (KeyTrustLevel),
  "publicKey": string,
  "keyRotationTime": string
}
الحقول
keyType

enum (KeyType)

النتائج فقط. نوع المفتاح العام
keyTrustLevel

enum (KeyTrustLevel)

النتائج فقط. مستوى الثقة في المفتاح العام
publicKey

string (bytes format)

النتائج فقط. قيمة المفتاح العام

سلسلة بترميز base64
keyRotationTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لعملية تغيير المفتاح العام الأخيرة

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

KeyType

الأنواع المحتملة للمفتاح العام

عمليات التعداد
KEY_TYPE_UNSPECIFIED يمثّل نوع مفتاح عام غير محدّد.
RSA_KEY يمثّل مفتاح تشفير RSA.
EC_KEY يمثّل مفتاح EC.

KeyTrustLevel

مستويات الثقة المحتملة للمفتاح العام

عمليات التعداد
KEY_TRUST_LEVEL_UNSPECIFIED يمثّل مستوى ثقة غير محدّد للمفتاح العام.
CHROME_BROWSER_HW_KEY يمثّل مفتاحًا للأجهزة.
CHROME_BROWSER_OS_KEY يمثّل مفتاح نظام التشغيل.

ReportingData

بيانات إعداد التقارير لملف شخصي في متصفّح Chrome

تمثيل JSON 
{
  "browserExecutablePath": string,
  "installedBrowserVersion": string,
  "profilePath": string,
  "extensionData": [
    {
      object (ExtensionData)
    }
  ],
  "policyData": [
    {
      object (PolicyData)
    }
  ],
  "extensionPolicyData": [
    {
      object (ExtensionPolicyData)
    }
  ]
}
الحقول
browserExecutablePath

string

النتائج فقط. مسار الملف التنفيذي لمتصفّح Chrome المثبَّت لا يتم تضمين مسار صالح إلا في الملفات التجارية التابعة.
installedBrowserVersion

string

النتائج فقط. الإصدار المحدَّث من المتصفّح، إذا كان مختلفًا عن إصدار المتصفّح النشط
profilePath

string

النتائج فقط. مسار الملف الشخصي لا يتم تضمين مسار صالح إلا في الملفات التجارية التابعة.
extensionData[]

object (ExtensionData)

النتائج فقط. معلومات عن الإضافات المثبّتة على الملف الشخصي
policyData[]

object (PolicyData)

النتائج فقط. معلومات عن السياسات المطبَّقة على الملف الشخصي
extensionPolicyData[]

object (ExtensionPolicyData)

النتائج فقط. معلومات عن السياسات المطبّقة على الإضافات

ExtensionData

معلومات عن إضافة مثبَّتة على ملف شخصي لمتصفّح Chrome

تمثيل JSON 
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "name": string,
  "description": string,
  "extensionType": enum (ExtensionType),
  "homepageUri": string,
  "installationType": enum (InstallationType),
  "manifestVersion": integer,
  "isDisabled": boolean,
  "isWebstoreExtension": boolean
}
الحقول
extensionId

string

النتائج فقط. رقم تعريف الإضافة.
version

string

النتائج فقط. إصدار الإضافة
permissions[]

string

النتائج فقط. الأذونات التي تطلبها الإضافة
name

string

النتائج فقط. اسم الإضافة
description

string

النتائج فقط. وصف الإضافة
extensionType

enum (ExtensionType)

النتائج فقط. نوع الإضافة
homepageUri

string

النتائج فقط. عنوان URL للصفحة الرئيسية للإضافة
installationType

enum (InstallationType)

النتائج فقط. نوع تثبيت الإضافة
manifestVersion

integer

النتائج فقط. إصدار ملف البيان للإضافة
isDisabled

boolean

النتائج فقط. يشير إلى ما إذا كان المستخدم قد أوقف الإضافة.
isWebstoreExtension

boolean

النتائج فقط. يمثّل ما إذا كانت الإضافة من "متجر الويب".

ExtensionType

أنواع الإضافات المحتملة

عمليات التعداد
EXTENSION_TYPE_UNSPECIFIED يمثّل نوع إضافة غير محدّد.
EXTENSION يمثّل إضافة.
APP يمثّل تطبيقًا.
THEME يمثّل موضوعًا.
HOSTED_APP يمثّل تطبيقًا مستضافًا.

InstallationType

أنواع التثبيت المحتمَلة للإضافة

عمليات التعداد
INSTALLATION_TYPE_UNSPECIFIED يمثّل نوع تثبيت غير محدّد.
MULTIPLE تمثّل نُسخ الإضافة التي تتضمّن أنواع تثبيت مختلطة.
NORMAL يمثّل نوع التثبيت العادي.
ADMIN يمثّل عملية تثبيت من قِبل المشرف.
DEVELOPMENT يمثّل نوع تثبيت الإصدار التطويري.
SIDELOAD يمثّل نوع تثبيت من مصدر غير معروف.
OTHER يمثّل نوع تثبيت لا يشمله الخيارات الأخرى.

PolicyData

معلومات عن سياسة تم تطبيقها على ملف شخصي في متصفّح Chrome

تمثيل JSON 
{
  "source": enum (PolicySource),
  "name": string,
  "value": string,
  "conflicts": [
    {
      object (ConflictingPolicyData)
    }
  ],
  "error": string
}
الحقول
source

enum (PolicySource)

النتائج فقط. مصدر السياسة
name

string

النتائج فقط. اسم السياسة
value

string

النتائج فقط. قيمة السياسة.
conflicts[]

object (ConflictingPolicyData)

النتائج فقط. معلومات متعارضة عن السياسة
error

string

النتائج فقط. رسالة الخطأ في السياسة، إن توفّرت

PolicySource

مصادر السياسة المحتمَلة

عمليات التعداد
POLICY_SOURCE_UNSPECIFIED يمثّل مصدر سياسة غير محدّد.
MACHINE_PLATFORM تمثّل سياسة نظام أساسي على مستوى الجهاز.
USER_PLATFORM يمثّل سياسة نظام أساسي على مستوى المستخدم.
MACHINE_LEVEL_USER_CLOUD يمثّل سياسة السحابة الإلكترونية للمستخدم على مستوى الجهاز.
USER_CLOUD يمثّل سياسة السحابة الإلكترونية على مستوى المستخدم.
MACHINE_MERGED يمثّل سياسة مدمجة على مستوى الجهاز.

ConflictingPolicyData

معلومات عن السياسة المتضاربة المطبّقة على ملف شخصي في متصفّح Chrome

تمثيل JSON 
{
  "source": enum (PolicySource)
}
الحقول
source

enum (PolicySource)

النتائج فقط. مصدر السياسة

ExtensionPolicyData

معلومات عن السياسات المطبّقة على إضافة

تمثيل JSON 
{
  "extensionId": string,
  "extensionName": string,
  "policyData": [
    {
      object (PolicyData)
    }
  ]
}
الحقول
extensionId

string

النتائج فقط. رقم تعريف الإضافة.
extensionName

string

النتائج فقط. اسم الإضافة.
policyData[]

object (PolicyData)

النتائج فقط. معلومات عن السياسات المطبّقة على الإضافة

IdentityProvider

موفِّرو الهوية المحتمَلون لملف تجاري

عمليات التعداد
IDENTITY_PROVIDER_UNSPECIFIED يمثّل موفِّر هوية غير محدّد.
GOOGLE_IDENTITY_PROVIDER يمثّل موفِّر هوية في Google.
EXTERNAL_IDENTITY_PROVIDER يمثّل موفِّر هوية خارجيًا.

AffiliationState

حالة الانتماء المحدّدة للملف الشخصي قد تتم إضافة قيم جديدة في المستقبل.

عمليات التعداد
AFFILIATION_STATE_UNSPECIFIED حالة الانتماء غير محدّدة.
UNAFFILIATED_GENERIC غير تابع - ولكن لا تتوفّر لدينا تفاصيل عن نوع الملف الشخصي غير التابع.
PROFILE_ONLY غير تابع: ملف شخصي مُدار يظهر على متصفّح غير مُدار بالكامل.
UNAFFILIATED_LOCAL_MACHINE غير تابع: ملف شخصي مُدار يظهر على جهاز تديره مؤسسة مختلفة محليًا (من خلال آليات إدارة المنصة، مثل سياسة المجموعة النموذجية).
UNAFFILIATED_CLOUD_MACHINE غير تابع: ملف شخصي مُدار يظهر على متصفّح مُدار تديره مؤسسة مختلفة في السحابة الإلكترونية (باستخدام "إدارة السحابة الإلكترونية في متصفّح Chrome").
AFFILIATED_CLOUD_MANAGED تابع: تتولّى المؤسسة نفسها إدارة كلّ من الملف الشخصي والمتصفّح المُدار.

الطُرق

delete

 يؤدي هذا الإجراء إلى حذف البيانات التي تم جمعها من ملف شخصي في متصفّح Chrome.

get

 الحصول على ملف شخصي لمتصفّح Chrome يحتوي على معرّف العميل والمعرّف الدائم للملف الشخصي

list

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