إعداد Chrome Enterprise Core

استخدام واجهة برمجة التطبيقات Chrome Enterprise Core API

المواضيع

التفويض 

قبل استخدام جميع واجهات برمجة التطبيقات في Chrome Enterprise Core، تحتاج إلى تفعيل واجهة برمجة التطبيقات في مجموعة تطوير البرامج للمشرف (إذا لم يسبق تفعيلها) في "وحدة تحكّم المطوّرين في Google" من خلال اتّباع هذا الرابط واختيار المشروع الذي تريد تفعيل واجهة برمجة التطبيقات به.

بعد ذلك، سيتاح لك خياران للحصول على رمز مميّز للوصول إلى واجهة برمجة التطبيقات:

  1. بروتوكول Oauth2.0 مع انتحال الهوية عن طريق استخدام حساب الخدمة (يرجى الاطّلاع على قسم "تفويض مع انتحال الهوية")
  2. مصادقة "بروتوكول Oauth2.0 الثلاثي" بدون انتحال الهوية (يمكنك تفويض الطلبات باتّباع إرشادات Oauth2)

يجب استخدام النطاقات التالية لتفويض الوصول إلى واجهة برمجة التطبيقات Chrome Enterprise Core API:

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers.readonly

أو

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers

التفويض مع انتحال الهوية

للحصول على حساب الخدمة للتفويض مع انتحال الهوية، عليك تنفيذ ما يلي:

  1.  أنشئ حساب خدمة واستخدِم مفاتيح حساب الخدمة اللازمة له. ويمكنك اتّباع هذه التعليمات لإنشاء حساب خدمة والحصول على مفاتيح حساب الخدمة. 
  2. يجب أن يكون "معرِّف العميل" لحساب الخدمة هذا مفوَّضًا لنطاقات OAuth المُدرَجة أعلاه. ولإجراء ذلك، عليك الانتقال إلى "وحدة تحكُّم المشرف" ضمن الأمان -> عناصر تحكُّم واجهة برمجة التطبيقات -> إدارة التفويض على مستوى النطاق. ستتمكن بعد ذلك من إضافة عميل جديد. حيث يتطابق في مربّع الحوار هذا "معرِّف العميل" مع "المعرِّف الفريد" لحساب الخدمة.

ومع مفاتيح حساب الخدمة، عليك استخدام مكتبات عميل واجهة برمجة تطبيقات Google بلغتك المفضَّلة لطلب رمز الوصول عبر بروتوكول OAuth إلى حساب الخدمة. 

 

بالإضافة إلى ذلك، سيحتاج طلب رمز OAuth المميز أيضًا إلى انتحال هوية مستخدم مشرف في نطاقك عند طلب رمز OAuth المميز. 

في ما يلي مثال على رمز برمجي نموذجي باستخدام مكتبات عميل واجهة برمجة تطبيقات Java لاسترداد الرمز OAuth المميّز.

package takeout.api.credentials;

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;

public final class ApiRequestHelper {

  public static String getAccessToken(
      String serviceAccountKeyFilePath, String adminUserToImpersonate, Collection<String> scopes)
      throws IOException {
    InputStream is = new FileInputStream(serviceAccountKeyFilePath);

    GoogleCredential credential =
        GoogleCredential.fromStream(is).toBuilder()
            .setServiceAccountScopes(scopes)
            .setServiceAccountUser(adminUserToImpersonate)
            .build();

    if (!credential.refreshToken()) {
      throw new RuntimeException(
          String.format(
              "Failed to fetch refresh token for service account defined in '%s' for user '%s' and"
                  + " scopes '%s'",
              serviceAccountKeyFilePath, adminUserToImpersonate, String.join(",", scopes)));
    }
    return credential.getAccessToken();
  }

  public static void printUsage() {
    System.out.println(
        "Usage: get_access_token <service account key file> <admin user> [<scope,scope>]");
  }

  public static void main(String[] args) throws Exception {
    if (args.length < 2) {
      printUsage();
      return;
    }

    String scopes =
        "https://www.googleapis.com/auth/admin.directory.device.chromebrowsers";
    if (args.length >= 3) {
      scopes = args[2];
    }
    System.out.println(
        getAccessToken(args[0], args[1], new ArrayList<String>(Arrays.asList(scopes.split(",")))));
  }

  private ApiRequestHelper() {}
}

باستخدام هذا الرمز النموذجي، ستتمكن من استرداد رمز الوصول الذي يمكنك استخدامه لاستدعاء واجهة برمجة التطبيقات. على سبيل المثال، في حال تخزين ملف المفتاح في /home/private_key.json وحساب المشرف الذي تريد استخدامه لإجراء الطلب هو admin@domain.com، فيمكنك تشغيل الملف التنفيذي باستخدام الوسيطات التالية:

ApiRequestHelper /home/private_key.json admin@domain.com

 

ملاحظة: البريد الإلكتروني المستخدم ليس البريد الإلكتروني لحساب الخدمة (الذي يظهر على الشكل التالي <project-name>-<id>@<project-name>.iam.gserviceaccount.com).

متصفِّح Chrome

متصفِّحات Chrome المسجَّلة في Chrome Enterprise Core

تمثيل الموارد

يُستخدم نموذج JSON التالي لموارد Chromebrowser في "واجهة برمجة تطبيقات الدليل":

{

"kind": "admin#directory#browserdevice",

"deviceId": string,

"osPlatform": string,

"osPlatformVersion": string,

"osArchitecture":string,

"osVersion": string,

"machineName": string,

"annotatedLocation": string,

"annotatedUser": string,

"annotatedAssetId": string,

"annotatedNotes": string,

"lastPolicyFetchTime": dateTime,

"lastRegistrationTime": dateTime,

"lastActivityTime":dateTime,

"lastStatusReportTime":dateTime,

"virtualDeviceId": string,

"serialNumber": string,

"orgUnitPath": string,

"extensionCount":int,

"policyCount": int,

"safeBrowsingClickThroughCount": int,

"lastDeviceUser": string,

"browserVersions": [string],

"lastDeviceUsers":[

  "userName": strin,

  "lastStatusReportTime":dateTime,

  ]

"machinePolicies": [

  "source": string,

  "name": string,

  "value": string,

  "error": string,

  ]

"browsers": [

  "browserVersion": string,

  "channel": string,

  "lastStatusReportTime": dateTime,

  "lastPolicyFetchTime": dateTime,

  "executablePath": string,

  "installedBrowserVersion": string,

  "plugins":[

    "name": string,

    "description": string,

    "fileame" string,

    ]

  "profiles": [

    "name": string,

    "id": string,

    "lastStatusReportTime": dateTime,

    "lastPolicyFectchTime": dateTime,

    "safeBrowsingWarnings": int,

    "safeBrowsingWarningsClickThrough": int,

    "chromeSignedinUserEmail": string,

    "extensionPolicies": [

      "extensionId": string,

      "extensionName": string,

      "policies": [

        "source": string,

        "name": string,

        "value": string,

        "error": string,

      ]

    ]

    "extensions": [

      "extensionId": string,

      "version": string,

      "permissions": [string],

      "name": string,

      "description":string,

      "appType": string,

      "homepageUrl": string,

      "installType": string,

      "configuredAppPolicy": string,

      "disabled": boolean,

      "icons": [

        "size": int,

        "url": string, 

      ]

    ]

    "userPolicies": [

      "source": string,

      "name": string,

      "value": string,

      "error": string,

    ]

    "safeBrowsingWarningsResetTime": string

  ]

}

استدعاء واجهة برمجة التطبيقات 

استرداد جميع أجهزة متصفِّح Chrome لأحد الحسابات 

المدة المحددة: تبلغ فترة صلاحية الرمز nextPageToken التي يعرضها طلب البيانات ساعة واحدة. إذا تضَمن طلب البيانات عددًا كبيرًا من أجهزة متصفّح Chrome، قد تنتهي صلاحية الرمز المميّز لصفحتك قبل أن تتمكّن من إنهاء طلب بيانات جميع الأجهزة. في هذه الحالة، يمكنك تطبيق فلتر على طلب البيانات لتقليل عدد الأجهزة التي يعرضها طلب البحث. وعادةً ما تكون الفلترة حسب الوحدة التنظيمية طريقة جيدة لتقليل عدد النتائج.

 

لعرض قائمة بجميع أجهزة متصفِّح Chrome والمخصّصة لحساب ما، يمكنك استخدام طلب استرداد بيانات باستخدام GET التالي وإضافة التفويض الموضّح في التفويض. ولسهولة القراءة، تحتوي عينة التعليمات البرمجية التالية على أحرف الرجوع إلى أول السطر:

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers?projection={FULL|BASIC}&query={query string}&orderBy={orderBy
category}&sortOrder={ASCENDING|DESCENDING}&pageToken={token for next results
page, if applicable &maxResults=max number of results per page}
  • customerId هو معرّف فريد لحساب العميل على Google.
  • عند استخدام هوية مشرف الحساب، يمكنك أيضًا استخدام السلسلة my_customer التي تمثِّل معرف customerId لحسابك. هناك طريقة أخرى للحصول على قيمة customerId، وهي استخدام عملية "استرداد مستخدم". ويمكنك استخدام عنوان البريد الإلكتروني للمشرف أو رقم التعريف الفريد للمشرف في مَعلمة مسار userKey في تلك العملية.

وفي ما يلي معلومات مرجعية لجميع مَعلمات سلسلة طلب البحث التي يمكن استخدامها في الطلب:

المَعلَمة النوع الوصف
maxResults عدد صحيح تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. العدد التلقائي والحد الأقصى هو 100 نتيجة.
orderBy سلسلة وهي سمة لجهاز متصفّح Chrome التي يمكن استخدامها لترتيب النتائج.
    القيم المقبولة هي
    "id" - رقم تعريف الجهاز الذي تم تثبيت متصفِّح Chrome عليه.
    "last_sync" - تاريخ ووقت آخر مرة تم فيها تسجيل جهاز Chrome، أو آخر مزامنة له مع إعدادات السياسة، أو تحميل تقرير.
    "machine_name" - اسم الآلة المرتبطة بالجهاز.
    "extension_count" - إجمالي عدد الإضافات التي أُعلن عنها على جهاز متصفّح Chrome.
    "policy_count" - إجمالي عدد السياسات المعلن عنها لجهاز متصفّح Chrome.
    "os_version" - نظام التشغيل الجهاز المثبت عليه متصفّح Chrome.
    "last_signed_in_user" - آخر مستخدم سجّل الدخول إلى جهاز متصفّح Chrome.
    "annotated_user": هو مستخدم جهاز متصفِّح Chrome كما وضِّح من المشرف.
    "annotated_location": هو موقع جهاز متصفِّح Chrome كما وضِّح من المشرف.
    "annotated_asset_id": معرّف مادة عرض جهاز متصفّح Chrome كما وضِّح من المشرف.
    "notes": ملاحظات جهاز متصفِّح Chrome كما وضِّح من المشرف.
    "browser_version_channel" - آخر قناة وإصدار من Chrome تم تقريره من خلال الجهاز.
    "org_unit" - الوحدة التنظيمية التي ينتمي إليها الجهاز.
    "enrollment_date" - تاريخ تسجيل الجهاز.
    "save_browsing_clickthrough" - عدد النقرات في "التصفّح الآمن" التي تم تقريرها من خلال الجهاز.
    "platform_major_version" - نوع نظام التشغيل ورقم الإصدار الرئيسي (مثل Windows 10).:
    "last_activity": آخر وقت نشاط للجهاز.:
    "browser_version_sortable" - أقدم إصدار من المتصفِّح مثبَّت على الجهاز.:
    "os_version_sortable" - نوع نظام التشغيل والإصدار الكامل.:
orgUnitPath سلسلة المسار الكامل أو المعرّف الفريد للوحدة التنظيمية
groupId سلسلة اسم المورد الكامل للمجموعة بالصيغة التالية groups/{group} أو المعرّف الفريد الخاص بها.
pageToken سلسلة تُستخدَم مَعلمة طلب البحث pageToken في طلب الصفحة التالية من نتائج طلب البحث. مَعلمة طلب البحث pageToken لطلب المتابعة هي معلمة nextPageToken من استجابتك السابقة.
projection سلسلة تستخدم لتقييد المعلومات التي يتم عرضها لمجموعة من الحقول المحددة.
    القيم المقبولة هي:
    "BASIC" - والتي تتضمّن حقول البيانات الوصفية الأساسية فقط (أي الحقول الموجودة في الأعمدة ضمن قائمة متصفِّح "وحدة تحكُّم المشرف" على النحو المذكور أعلاه)
    "FULL" - والتي تتضمّن جميع حقول البيانات الوصفية (على النحو المذكور أعلاه)
query سلسلة سلسلة البحث باستخدام صفحة قائمة لغة طلب البحث الموضّحة في القسم أدناه (فلترة لغة طلب البحث).
sortOrder سلسلة لاختيار عرض النتائج إما بترتيب تصاعدي أو تنازلي. ويجب استخدامها مع معلّمة orderBy.
    القيم المقبولة هي:
    "ASCENDING" - ترتيب تصاعدي.
    "DESCENDING" - ترتيب تنازلي.

مثال: فلترة الأجهزة حسب اسم الآلة

في المثال الأول، يتم البحث عن اسم آلة معيّنة باستخدام query=machine_name:CLIENT2012. وتحتوي الاستجابة على مورد واحد لمتصفِّحات Chrome، حيث تكون machineName هي مركز مساعدة:

طلب JSON

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers?projection=BASIC&query=machine_name:CLIENT2012&orderBy=status
&sortOrder=ASCENDING&maxResults=100

استجابة JSON

يعرض الطلب الناجح رمز الحالة HTTP 200. مع قائمة بأجهزة المتصفحات التي تتطابق مع معلمات طلب البحث:

{
  "kind": "directory#browserdevices",
  "browsers": [
     {
      "deviceId": "device_id_value",
      "kind": "admin#directory#browserdevice",
      "osPlatform": "Windows",
      "osVersion": "6.3.9600.19505",
      "machineName": "CLIENT2012",
      "lastRegistrationTime": "2019-11-04T00:29:17.484Z",
      "lastActivityTime": "2019-11-04T00:29:17.484Z",
      "virtualDeviceId": "virtual_device_id",
      "orgUnitPath": "/Org-unit path",
    },
  ],
  "nextPageToken": "abcdefghijkl123"
}

استرداد جهاز متصفّح Chrome 

لاسترداد سمات جهاز متصفِّح Chrome، يمكنك استخدام طلب GET التالي مع تضمين التفويض الوارد في طلبات التفويض. ولسهولة القراءة، تحتوي عينة التعليمات البرمجية التالية على أحرف الرجوع إلى أول السطر:

GET
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/deviceId?projection={FULL|BASIC}
  • customerId هو معرّف فريد لحساب العميل على Google.
  • عند استخدام هوية مشرف الحساب، يمكنك أيضًا استخدام السلسلة my_customer التي تمثِّل معرف customerId لحسابك. هناك طريقة أخرى للحصول على قيمة customerId، وهي استخدام عملية "استرداد مستخدم". ويمكنك استخدام عنوان البريد الإلكتروني للمشرف أو رقم التعريف الفريد للمشرف في مَعلمة مسار userKey في تلك العملية.
  • رقم تعريف الجهاز هو معرّف فريد للجهاز يمكن العثور عليه في استجابةً عملية استرداد جميع أجهزة متصفّح Chrome. للاطّلاع على سمات سلاسل طلبات البحث وطلبات البيانات والاستجابة، يرجى مراجعة "مرجع واجهة برمجة التطبيقات".

وفي ما يلي معلومات مرجعية لجميع مَعلمات سلسلة طلب البحث التي يمكن استخدامها في الطلب:

المَعلَمة النوع الوصف
deviceId سلسلة المعرّف الفريد للجهاز يتم عرض أرقام تعريف الأجهزة في الاستجابة على طريقة browsersdevices.list. ملاحظة: هذه المعلّمة مطلوبة.
projection سلسلة تحدِّد ما إذا كانت الاستجابة تحتوي على القائمة الكاملة للسمات أو مجموعة فرعية فقط.
    القيم المقبولة هي:
    "BASIC": والتي تتضمّن حقول البيانات الوصفية الأساسية فقط (أي الحقول الموجودة في الأعمدة ضمن قائمة متصفِّحات "وحدة تحكُّم المشرف" على النحو المذكور أعلاه)
    "FULL": والتي تتضمّن جميع حقول البيانات الوصفية (على النحو المذكور أعلاه)

مثال

طلب JSON

مثال على الطلب. ولسهولة القراءة، تحتوي عينة التعليمات البرمجية التالية على أحرف الرجوع إلى أول السطر:

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/deviceId?projection=basic

استجابة JSON

يعرض الطلب الناجح رمز الحالة HTTP 200. وإلى جانب رمز الحالة، تعرض الاستجابة سمات جهاز متصفِّح Chrome:

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "CLIENT2012",
  "lastRegistrationTime": "2019-11-27T12:55:27.230Z",
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
  "deviceIdentifiersHistory": { 
    "records": [
    { 
      "identifiers": { 
        "machineName": "CLIENT2012", 
        "serialNumber": "ABCD1234567890" }, 
      "firstRecordTime": "2019-11-27T12:55:27.230Z",
      "lastActivityTime": "2019-11-27T12:55:27.230Z"}
  ],
  “has_device_id_collision”: “false”
  }
}

لغة فلترة query

 

عند استخدام المَعلمة query في طلب قائمة، يجب أن تتطابق كل عبارة في طلب البحث مع جهاز متصفّح معيّن حتى تكون صالحة. في حال عدم تحديد أي عوامل تشغيل (حقول) في طلب البحث، سيعرض البحث متصفِّح يحتوي على جميع العبارات المحدّدة في جميع حقول النصوص المفهرسة داخليًا. على سبيل المثال، إذا كان طلب البحث هو: "query=machine 73"، سيؤدي ذلك إلى عرض متصفِّح يحتوي على المصطلحين "machine" و "73" في جميع الحقول التي يمكن عرضها على جهاز متصفِّح على النحو التالي:

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "machine_name",
  "browser_versions": [
    "73.0.0.0",
  ],
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
}

 

ملاحظة 1: تحدث المطابقة وفقا لحدود الكلمات (أي علامات ترقيم أو مسافة) بحيث لا تتمكن من إجراء مطابقات جزئية على الكلمات. في المثال أعلاه، لن تتمكّن من إجراء الطلب query='mach 73'.

الملاحظة 2: عملية مطابقة الكلمات غير حساسة لحالة الأحرف، بحيث يتطابق طلب البحث الذي يحتوي على "machine" مع كل من "Machine" و "machine".

 

يمكنك تحديد الحقول التالية لتوجيه بحثك إلى حقول معيّنة (ملاحظة: على الرغم من أن كلمات طلب البحث غير حساسة لحالة الأحرف، إلا أنّ أسماء الحقول حسّاسة لحالة الأحرف).

الحقل الوصف
machine_name يعرض هذا الحقل اسم الآلة لجهاز متصفّح Chrome.
os_platform يعرض النظام الأساسي لنظام تشغيل جهاز متصفِّح Chrome. (مثال: Windows)
arch بنية وحدة المعالجة المركزية (CPU) لجهاز متصفح Chrome. (مثال: x86_64)
os_version إصدار نظام التشغيل لجهاز متصفّح Chrome. (مثال: 10.0.16299.904)
location تمثّل هذه السمة الموقع الجغرافي الذي تم توضيحه لجهاز متصفِّح Chrome.
user المستخدم الذي تم توضيحه لجهاز متصفِّح Chrome.
asset_id رقم تعريف مادة العرض الذي تم توضيحه لجهاز متصفِّح Chrome.
note الملاحظة التي تتضمن تعليقًا توضيحيًّا لجهاز متصفِّح Chrome.
register وقت تسجيل جهاز متصفّح Chrome.
os دمج النظام الأساسي لنظام التشغيل وإصدار نظام التشغيل الرئيسي لجهاز متصفِّح Chrome (مثال: "Windows 10")
browser_version متصفّح Chrome تم تسجيله في تقرير مثبَّت على جهاز متصفِّح Chrome (مثال: 73)
enrollment_token الرمز المميّز للتسجيل المستخدَم لتسجيل جهاز متصفّح Chrome.
report يعرض آخر مرة تم إعداد تقرير فيها عن جهاز متصفّح Chrome
sync يعرض آخر مرة تم فيها مزامنة السياسات في جهاز متصفّح Chrome.
num_extensions يعرض هذا الحقل عدد الإضافات التي تم تقريرها من خلال جهاز متصفِّح Chrome.
num_policies يعرض هذا الحقل عدد السياسات التي تم تقريرها من خلال جهاز متصفِّح Chrome.
machine_user يعرض هذا الحقل آخر مستخدم لجهاز متصفِّح Chrome تم تقريره.
last_activity يعرض آخر مرة عرض فيها جهاز متصفّح Chrome نشاطًا (استرجاع السياسات أو إعداد التقارير).
has_device_id_collision يعرض رقم تعريف الجهاز المشارَك مع عدة آلات والذي يتعرّف عليه متصفِّح Chrome على أساس أنه نفس الآلة. القيم المتوافقة هي true وfalse.

 

الحقول التي تقبل تحديد وقت (التسجيل أو التقرير أو المزامنة أو آخر نشاط) تعرض صيغة الوقت كالتالي:YYYY-MM-DDThh:mm:ss (مثال: 2020-01-01T12:00:00). كما يمكنك تحديد نطاقات مفتوحة أو مغلقة للوقت:

 

النموذج

المعنى

أمثلة

datetime

في التاريخ أو الوقت المحدد بالضبط

2011-03-23

2011-04-26T14:23:05

datetime..datetime

ضمن (شاملاً) فاصل التاريخ أو الوقت المحدد

2011-03-23..2011-04-26

datetime..

في أو بعد التاريخ أو الوقت المحدد

2011-04-26T14:23:05..

..datetime

في أو قبل التاريخ أو الوقت المحدد

..2011-04-26T14:23:05
 

أمثلة على فلترة طلبات البحث

 

ملاحظة 1: تستخدم جميع الأمثلة المقدَّمة المَعلَمة "query" في الطلب. ويجب أن يتم إلغاء قيمة المَعلَمة بشكل صحيح في عنوان URL (أي إلغاء المسافات ذات الطلبات المتعدّدة الشروط).

ملاحظة 2: يمكن فلترة جميع طلبات البحث لوحدة تنظيمية معيّنة من خلال إضافة معلّمة طلب البحث "orgUnitPath" إلى الطلب.

 

  1. البحث عن جميع الأجهزة التي تحمل اسم آلة يحتوي على كلمة:
    1. machine_name:LIX
  2. يبحث عن جميع الأجهزة التي تحمل اسم آلة يحتوي على كلمة تم تسجيلها بعد تاريخ معيَّن:​
    1. machine_name:LIX register:​2011-04-26..
  3. ​البحث عن جميع الأجهزة التي تحمل اسم آلة يحتوي على كلمة تم تسجيلها قبل تاريخ معيّن:​
    1. machine_name:LIX register:​..2011-04-26

 

طلبات البحث غير المتوافقة حاليًا:

  1. البحث عن جميع الأجهزة المثبّت عليها عدد إضافات أقل من عدد معين (لا تتوافق طلبات النطاق للقيم الرقمية).
  2. البحث عن جميع الأجهزة التي تحمل اسم آلة يحتوي على كلمة واحدة من كلمتين محتمَلَين (باستخدام "OR" في طلبات البحث).

 

تحديث جهاز متصفّح Chrome 

لتحديث الحقول التي تتضمّن تعليقات توضيحية لأجهزة متصفِّح Chrome المخصّصة لأحد الحسابات، يمكنك استخدام طلب PUT التالي وإدراج رمز الوصول الذي حصلت عليه من خلال اتّباع قسم "التفويض". 

PUT
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/{deviceId}
  • customerId هو معرّف فريد لحساب العميل على Google.
  • عند استخدام هوية مشرف الحساب، يمكنك أيضًا استخدام السلسلة my_customer التي تمثِّل معرف customerId لحسابك. هناك طريقة أخرى للحصول على قيمة customerId، وهي استخدام عملية "استرداد مستخدم". ويمكنك استخدام عنوان البريد الإلكتروني للمشرف أو رقم التعريف الفريد للمشرف في مَعلمة مسار userKey في تلك العملية.
  • رقم تعريف الجهاز هو معرّف فريد للجهاز يمكن العثور عليه في استجابةً عملية استرداد جميع أجهزة متصفّح Chrome. للاطّلاع على سمات سلاسل طلبات البحث وطلبات البيانات والاستجابة، يرجى مراجعة "مرجع واجهة برمجة التطبيقات".

في ما يلي معلومات مرجعية لجميع مَعلمات الحمولة التي يمكن استخدامها في الطلب:

المَعلَمة مطلوبة النوع الوصف
deviceId مطلوبة سلسلة المعرّف الفريد للجهاز يتم عرض أرقام تعريف الأجهزة في الاستجابة على طريقة browsersdevices.list. ملاحظة: هذه المعلّمة مطلوبة.
annotatedUser اختياري سلسلة تعرض مستخدم الجهاز كما وضَح المشرف.
annotatedLocation اختياري سلسلة

تعرض عنوان الجهاز أو موقعه الجغرافي كما وضَح المشرف.
annotatedNotes اختياري سلسلة تعرض الملاحظات حول هذا الجهاز كما وضَح المشرف
annotatedAssetId اختياري سلسلة

تعرض معرّف الإصول كما وضَحه المشرف أو حدده أثناء التسجيل.

مثال

طلب JSON

مثال على الطلب. ولسهولة القراءة، تحتوي عينة التعليمات البرمجية التالية على أحرف الرجوع إلى أول السطر:

PUT https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

{

  "deviceId": "device_id_value",
  "annotatedUser": "user 1"
}

استجابة JSON

يعرض الطلب الناجح رمز الحالة HTTP 200. وإلى جانب رمز الحالة، تعرض الاستجابة سمات جهاز متصفِّح Chrome:

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "CLIENT2012",
  "lastRegistrationTime": "2019-11-27T12:55:27.230Z",
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
  "annotatedUser": "user 1"
}

 

حذف جهاز متصفّح Chrome 

لحذف أجهزة متصفّح Chrome المخصّصة لأحد الحسابات، يمكنك استخدام الطلب DELETE التالي وإدراج رمز الوصول الذي حصلت عليه من خلال اتّباع قسم "التفويض". 

DELETE
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices
chromebrowsers/{deviceId}
  • customerId هو معرّف فريد لحساب العميل على Google.
  • عند استخدام هوية مشرف الحساب، يمكنك أيضًا استخدام السلسلة my_customer التي تمثِّل معرف customerId لحسابك. هناك طريقة أخرى للحصول على قيمة customerId، وهي استخدام عملية "استرداد مستخدم". ويمكنك استخدام عنوان البريد الإلكتروني للمشرف أو رقم التعريف الفريد للمشرف في مَعلمة مسار userKey في تلك العملية.
  • رقم تعريف الجهاز هو معرّف فريد للجهاز يمكن العثور عليه في استجابةً عملية استرداد جميع أجهزة Chrome. للاطّلاع على سمات سلاسل طلبات البحث وطلبات البيانات والاستجابة، يرجى مراجعة "مرجع واجهة برمجة التطبيقات".

مثال

مثال على الطلب:

DELETE https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

 

استجابة JSON

يعرض الطلب الناجح رمز الحالة HTTP 200. 

 

نقل جهاز متصفِّح Chrome بين الوحدات التنظيمية 

لنقل أجهزة متصفِّح Chrome المخصَّصة لحساب من وحدة تنظيمية إلى أخرى، يمكنك استخدام طلب POST التالي وإدراج رمز الوصول الذي حصلت عليه من خلال اتّباع قسم "التفويض". 

POST
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices/chromebrowsers/moveChromeBrowsersToOu

 

  • customerId هو معرّف فريد لحساب العميل على Google.
  • عند استخدام هوية مشرف الحساب، يمكنك أيضًا استخدام السلسلة my_customer التي تمثِّل معرف customerId لحسابك. هناك طريقة أخرى للحصول على قيمة customerId، وهي استخدام عملية "استرداد مستخدم". ويمكنك استخدام عنوان البريد الإلكتروني للمشرف أو رقم التعريف الفريد للمشرف في مَعلمة مسار userKey في تلك العملية.

في ما يلي معلومات مرجعية لجميع مَعلمات الحمولة التي يمكن استخدامها في الطلب:

المَعلَمة النوع الوصف
resource_ids قائمة سلاسل

تعرض قائمة معرّفات الأجهزة الفريدة لأجهزة متصفّح Chrome المطلوب نقلها. يمكن نقل 600 متصفّح كحد أقصى لكل طلب.
org_unit_path سلسلة

الوحدة التنظيمية للوجهة التي يتم نقل الأجهزة إليها. المسار الكامل للوحدة التنظيمية أو رقم تعريفها مسبوقًا بـ "id:"

 

مثال

مثال على الطلب.

POST https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/moveChromeBrowsersToOu
{
  "org_unit_path": "/new-path",
  "resource_ids": ["device_id_value_1","device_id_value_2"],
}

استجابة JSON

يعرض الطلب الناجح رمز الحالة HTTP 200. 

هل كان ذلك مفيدًا؟

كيف يمكننا تحسينها؟
true
بحث
محو البحث
إغلاق البحث
القائمة الرئيسية
5167635383494418776
true
مركز مساعدة البحث
true
true
true
true
true
410864
false
false