Chrome Management Chrome Browsers API के लिए कोड के सैंपल

एपीआई की सुविधाओं के बारे में खास जानकारी पाने के लिए, 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 ब्राउज़र के एनोटेट किए गए फ़ील्ड अपडेट करने के लिए, HTTP PATCH तरीके के साथ /chromeBrowsers/{browser_permanent_id} एंडपॉइंट का इस्तेमाल करें. साथ ही, 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 ब्राउज़र से इकट्ठा किया गया डेटा मिटाने के लिए, HTTP DELETE के साथ /chromeBrowsers/{browser_permanent_id} एंडपॉइंट का इस्तेमाल करें.

अनुरोध

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

जवाब

{}