نماذج الرموز البرمجية لواجهة برمجة التطبيقات Chrome Browsers في "إدارة Chrome"

يُرجى الانتقال إلى Chrome Management Chrome Browsers API للحصول على نظرة عامة حول ميزات واجهة برمجة التطبيقات.

تستخدِم جميع الطلبات المعروضة في هذه الصفحة المتغيّرات التالية:

  • $TOKEN - رمز OAuth 2.0 المميز
  • ‫$CUSTOMER - معرّف العميل أو قيمة حرفية my_customer

قائمة بمتصفّحات Chrome المسجَّلة

لعرض قائمة بمتصفّحات Chrome المسجَّلة، استخدِم نقطة النهاية /chromeBrowsers. يمكنك التحكّم في تقسيم الصفحات باستخدام المَعلمتَين pageSize (الحدّ الأقصى والقيمة التلقائية 100) وpageToken. استخدِم orderBy لتحديد ترتيب النتائج. حدِّد filter لتضييق نطاق النتائج. يمكن تحديد قناع القراءة باستخدام مَعلمة الطلب fields.

تتوفّر ميزة المطابقة باستخدام حرف البدل (*) (البادئة prefix* أو اللاحقة *suffix أو السلسلة الفرعية *substring* أو الوجود *) مع = و: فقط في الحقول machine_name وannotated_asset_id وbrowser_version.

يبحث البحث عن النص العام (بدون تحديد اسم حقل) في جميع حقول النصوص المفهرسة. عندما يتم فصل عبارات بحث متعددة باستخدام AND أو مسافة بيضاء (على سبيل المثال، filter=machine AND 73 أو filter=machine 73)، يجب أن تطابق كل عبارة بحث حقل نص واحدًا على الأقل تم فهرسته على جهاز المتصفح (حتى لو كان ذلك في حقول مختلفة). يؤدي وضع كلمات متعددة بين علامتي اقتباس مفردتين (على سبيل المثال، filter="machine name") إلى البحث عن تلك العبارة المتجاورة المطابقة تمامًا ضمن حقل واحد.

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

# Filter by machine name prefix (using ':' or '=')
filter=machine_name:LIX*

# Filter by annotated asset ID suffix
filter=annotated_asset_id="*1001"

# Filter by browser version substring
filter=browser_version:"*6367*"

# Global search across all indexed text fields (matches browsers containing both "machine" and "73" across any fields)
filter=machine AND 73

# Global search with implicit AND (equivalent to `machine AND 73`)
filter=machine 73

# Filter by machine name prefix and registration time range
filter=machine_name:LIX* AND last_registration_time>=2024-01-01T00:00:00Z

# Filter by Organizational Unit path
filter=org_unit_path=/Marketing

طلب

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers?pageSize=2&orderBy=lastActivityTime+desc&filter=os_platform=WINDOWS"

الردّ

{
  "chromeBrowsers": [
    {
      "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
      "browserPermanentId": "<browserPermanentId1>",
      "machineName": "CLIENT2024-01",
      "osPlatformType": "WINDOWS",
      "osVersion": "10.0.19045",
      "browserVersion": "124.0.6367.60",
      "annotatedUser": "user1@example.com",
      "annotatedLocation": "US-NYC",
      "annotatedAssetId": "ASSET-1001",
      "annotatedNotes": "Engineering workstation",
      "lastActivityTime": "2024-04-23T22:05:44.214362Z",
      "lastPolicySyncTime": "2024-04-23T22:00:00.000Z",
      "lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
      "enrollmentDate": "2024-01-15T10:30:00.000Z",
      "orgUnitPath": "/Engineering",
      "policyCount": 15,
      "extensionCount": 8
    },
    {
      "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId2>",
      "browserPermanentId": "<browserPermanentId2>",
      "machineName": "CLIENT2024-02",
      "osPlatformType": "WINDOWS",
      "osVersion": "11.0.22631",
      "browserVersion": "124.0.6367.60",
      "annotatedUser": "user2@example.com",
      "annotatedLocation": "US-MTV",
      "lastActivityTime": "2024-04-23T21:45:10.102000Z",
      "lastPolicySyncTime": "2024-04-23T21:40:00.000Z",
      "lastStatusReportTime": "2024-04-23T21:45:10.102000Z",
      "enrollmentDate": "2024-02-10T14:15:00.000Z",
      "orgUnitPath": "/Engineering",
      "policyCount": 12,
      "extensionCount": 5
    }
  ],
  "nextPageToken": "<nextPageToken>"
}

استرداد متصفّح Chrome مُدار

لاسترداد متصفّح Chrome واحد مسجَّل، استخدِم نقطة النهاية /chromeBrowsers/{browser_permanent_id}. يمكن تحديد قناع القراءة باستخدام المَعلمة fields.

طلب

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>"

الردّ

{
  "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
  "browserPermanentId": "<browserPermanentId1>",
  "machineName": "CLIENT2024-01",
  "osPlatformType": "WINDOWS",
  "osVersion": "10.0.19045",
  "browserVersion": "124.0.6367.60",
  "annotatedUser": "user1@example.com",
  "annotatedLocation": "US-NYC",
  "annotatedAssetId": "ASSET-1001",
  "annotatedNotes": "Engineering workstation",
  "lastActivityTime": "2024-04-23T22:05:44.214362Z",
  "lastPolicySyncTime": "2024-04-23T22:00:00.000Z",
  "lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
  "enrollmentDate": "2024-01-15T10:30:00.000Z",
  "orgUnitPath": "/Engineering",
  "policyCount": 15,
  "extensionCount": 8
}

تعديل معلومات التعليق التوضيحي لمتصفّح Chrome

لتعديل الحقول التي تتضمّن تعليقات توضيحية في متصفّح Chrome مسجَّل، استخدِم نقطة النهاية /chromeBrowsers/{browser_permanent_id} مع طريقة HTTP PATCH وقدِّم مَعلمة طلب بحث updateMask تحدّد الحقول المطلوب تعديلها.

طلب

  curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>?updateMask=annotatedUser,annotatedNotes" \
  -d '{
    "annotatedUser": "newuser@example.com",
    "annotatedNotes": "Updated primary workstation"
  }'

الردّ

{
  "name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
  "browserPermanentId": "<browserPermanentId1>",
  "machineName": "CLIENT2024-01",
  "osPlatformType": "WINDOWS",
  "osVersion": "10.0.19045",
  "browserVersion": "124.0.6367.60",
  "annotatedUser": "newuser@example.com",
  "annotatedLocation": "US-NYC",
  "annotatedAssetId": "ASSET-1001",
  "annotatedNotes": "Updated primary workstation",
  "lastActivityTime": "2024-04-23T22:05:44.214362Z",
  "orgUnitPath": "/Engineering"
}

نقل متصفّحات Chrome إلى وحدة تنظيمية جديدة

لنقل متصفّحات Chrome المُدارة من وحدة تنظيمية إلى أخرى، استخدِم نقطة النهاية /chromeBrowsers:move. يمكن نقل ما يصل إلى 600 متصفّح لكل طلب. في حال حدوث خطأ أثناء نقل أي متصفّح، لن يتم نقل أي من المتصفّحات المحدّدة.

طلب

  curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers:move" \
  -d '{
    "destinationOrgUnitId": "03ph8a2z3v",
    "resourceIds": [
      "customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>",
      "customers/$CUSTOMER/chromeBrowsers/<browserPermanentId2>"
    ]
  }'

الردّ

{}

حذف البيانات التي تم جمعها من متصفّح Chrome

لحذف البيانات التي تم جمعها من متصفّح Chrome مُدار، استخدِم نقطة النهاية /chromeBrowsers/{browser_permanent_id} مع HTTP DELETE.

طلب

  curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>"

الردّ

{}