एपीआई की सुविधाओं के बारे में खास जानकारी पाने के लिए, Chrome Management Chrome Browsers API पर जाएं.
इस पेज पर दिखाए गए सभी अनुरोधों में, इन वैरिएबल का इस्तेमाल किया जाता है:
$TOKEN- OAuth 2.0 टोकन$CUSTOMER- ग्राहक का आईडी या लिटरलmy_customer
रजिस्टर किए गए Chrome ब्राउज़र की सूची
रजिस्टर किए गए Chrome ब्राउज़र की सूची देखने के लिए, /chromeBrowsers एंडपॉइंट का इस्तेमाल करें. pageSize (ज़्यादा से ज़्यादा और डिफ़ॉल्ट रूप से 50) और 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=last_activity_time+desc&filter=os_platform=WINDOWS"
जवाब
{
"chromeBrowsers": [
{
"name": "customers/<customerId>/chromeBrowsers/<browserPermanentId1>",
"browserPermanentId": "<browserPermanentId1>",
"machineName": "CLIENT2024-01",
"osPlatform": "Windows",
"osVersion": "10.0.19045",
"browserVersions": [
"124.0.6367.60"
],
"annotatedUser": "user1@example.com",
"annotatedLocation": "US-NYC",
"annotatedAssetId": "ASSET-1001",
"annotatedNotes": "Engineering workstation",
"lastActivityTime": "2024-04-23T22:05:44.214362Z",
"lastPolicyFetchTime": "2024-04-23T22:00:00.000Z",
"lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
"lastRegistrationTime": "2024-01-15T10:30:00.000Z",
"orgUnitId": "03ph8a2z3v",
"policyCount": "15",
"extensionCount": "8"
},
{
"name": "customers/<customerId>/chromeBrowsers/<browserPermanentId2>",
"browserPermanentId": "<browserPermanentId2>",
"machineName": "CLIENT2024-02",
"osPlatform": "Windows",
"osVersion": "11.0.22631",
"browserVersions": [
"124.0.6367.60"
],
"annotatedUser": "user2@example.com",
"annotatedLocation": "US-MTV",
"lastActivityTime": "2024-04-23T21:45:10.102000Z",
"lastPolicyFetchTime": "2024-04-23T21:40:00.000Z",
"lastStatusReportTime": "2024-04-23T21:45:10.102000Z",
"lastRegistrationTime": "2024-02-10T14:15:00.000Z",
"orgUnitId": "03ph8a2z3v",
"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",
"osPlatform": "Windows",
"osVersion": "10.0.19045",
"browserVersions": [
"124.0.6367.60"
],
"annotatedUser": "user1@example.com",
"annotatedLocation": "US-NYC",
"annotatedAssetId": "ASSET-1001",
"annotatedNotes": "Engineering workstation",
"lastActivityTime": "2024-04-23T22:05:44.214362Z",
"lastPolicyFetchTime": "2024-04-23T22:00:00.000Z",
"lastStatusReportTime": "2024-04-23T22:05:44.214362Z",
"lastRegistrationTime": "2024-01-15T10:30:00.000Z",
"orgUnitId": "03ph8a2z3v",
"policyCount": "15",
"extensionCount": "8"
}
किसी Chrome ब्राउज़र के लिए, एनोटेशन की जानकारी अपडेट करना
रजिस्टर किए गए Chrome ब्राउज़र के एनोटेट किए गए फ़ील्ड अपडेट करने के लिए, एचटीटीपी 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",
"osPlatform": "Windows",
"osVersion": "10.0.19045",
"browserVersions": [
"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",
"orgUnitId": "03ph8a2z3v"
}
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 ब्राउज़र से इकट्ठा किया गया डेटा मिटाने के लिए, एचटीटीपी DELETE के साथ /chromeBrowsers/{browser_permanent_id} एंडपॉइंट का इस्तेमाल करें.
अनुरोध
curl -X DELETE \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/chromeBrowsers/<browserPermanentId1>"
जवाब
{}