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

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

string

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

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
lastPolicyFetchTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
lastPolicySyncTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
lastStatusReportTime

string (Timestamp format)

النتائج فقط. طابع زمني لأحدث تقرير حالة قدّمه الملف التجاري

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
affiliationState

enum (AffiliationState)

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

string (int64 format)

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

string (int64 format)

النتائج فقط. عدد الإضافات المثبّتة في الملف التجاري
osPlatformVersion

string

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

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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

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 لأحد العملاء استنادًا إلى معايير البحث والترتيب المحدّدة.