Chrome Management Chrome Browsers API की मदद से, एडमिन Chrome Enterprise Core में रजिस्टर किए गए Chrome ब्राउज़र का डेटा देख सकते हैं और उन्हें मैनेज कर सकते हैं. एपीआई के इस सेट का इस्तेमाल, रजिस्टर किए गए Chrome ब्राउज़र की सूची बनाने, Chrome ब्राउज़र को वापस पाने, Chrome ब्राउज़र के लिए एनोटेशन की जानकारी अपडेट करने, Chrome ब्राउज़र को संगठन की इकाइयों (ओयू) के बीच ट्रांसफ़र करने, और Chrome ब्राउज़र से इकट्ठा किए गए डेटा को मिटाने के लिए किया जा सकता है.
एपीआई के तरीकों के बारे में खास जानकारी
यूआरएल, https://chromemanagement.googleapis.com/v1/customers/{customer_id} से जुड़े हैं
| जानकारी | रिलेटिव यूआरएल | एचटीटीपी का तरीका |
|---|---|---|
| रजिस्टर किए गए Chrome ब्राउज़र की सूची देखना | /chromeBrowsers | पाएं |
| Chrome ब्राउज़र को वापस लाना | /chromeBrowsers/{browser_permanent_id} | पाएं |
| Chrome ब्राउज़र के लिए एनोटेशन की जानकारी अपडेट करना | /chromeBrowsers/{browser_permanent_id} | PATCH |
| Chrome ब्राउज़र को संगठन की किसी नई इकाई (ओयू) में ले जाना | /chromeBrowsers:move | पोस्ट करें |
| Chrome ब्राउज़र से इकट्ठा किया गया डेटा मिटाना | /chromeBrowsers/{browser_permanent_id} | मिटाएं |
अनुरोधों और जवाबों के उदाहरण के लिए, कोड सैंपल देखें.
नतीजे फ़िल्टर किए जा रहे हैं
/chromeBrowsers तरीके का इस्तेमाल करके, Chrome ब्राउज़र की सूची बनाते समय, filter क्वेरी पैरामीटर का इस्तेमाल करके नतीजों को सीमित किया जा सकता है. एचटीटीपी अनुरोधों में भेजे जाने पर, सभी फ़िल्टर पैरामीटर यूआरएल-एस्केप होने चाहिए. AND ऑपरेटर का इस्तेमाल करके, एक से ज़्यादा शर्तों को जोड़ा जा सकता है.
- स्ट्रिंग, इंटिजर, और Enum फ़ील्ड: इनमें
=और:जैसे तुलना करने वाले ऑपरेटर इस्तेमाल किए जा सकते हैं. वाइल्डकार्ड*(प्रीफ़िक्सprefix*, सफ़िक्स*suffix, सबस्ट्रिंग*substring*या मौजूदगी*) का इस्तेमाल,=और:के साथ सिर्फ़machine_name,annotated_asset_id, औरbrowser_versionके लिए किया जा सकता है. उदाहरण के लिए,machine_name=LIX*याbrowser_version:"*6367*". बिना किसी फ़ील्ड नाम के, ग्लोबल स्ट्रिंग लिटरल फ़िल्टरिंग का भी इस्तेमाल किया जा सकता है: अगर इंडेक्स किए गए किसी स्ट्रिंग फ़ील्ड मेंABCशामिल है, तोABCजैसा कोई एक शब्द मैच करता है. साथ ही,ANDया खाली जगह से जुड़े कई शब्द (उदाहरण के लिए,machine AND 73याmachine 73) उन ब्राउज़र से मैच करते हैं जिनमें इंडेक्स किए गए किसी भी टेक्स्ट फ़ील्ड में, बताए गए हर शब्द शामिल होते हैं. हालांकि, कोटेशन मार्क में मौजूद कई शब्दों वाली स्ट्रिंग, जैसे कि"machine 73", किसी एक फ़ील्ड में मौजूद सटीक वाक्यांश से मैच करती है. - टाइमस्टैंप फ़ील्ड: इनमें
=,<=, और>=जैसे तुलना करने वाले ऑपरेटर इस्तेमाल किए जा सकते हैं. टाइमस्टैंप के लिए, डबल कोट में बंद RFC-3339 फ़ॉर्मैट वाली स्ट्रिंग की ज़रूरत होती है. उदाहरण के लिए,"2020-01-01T12:00:00Z"या"2012-04-21T11:30:00-04:00". तुलना का इस्तेमाल करके, टाइमस्टैंप की क्लोज़्ड रेंज तय की जा सकती हैं. - संगठन की इकाई के हिसाब से फ़िल्टर करना:
org_unit_path(उदाहरण के लिए,org_unit_path=/Marketing) की जानकारी देकर, संगठन की किसी इकाई से जुड़े ब्राउज़र फ़िल्टर किए जा सकते हैं. संगठन की किसी एक इकाई से मैच करने वाले ब्राउज़र फ़िल्टर किए जा सकते हैं. - ग्रुप के हिसाब से फ़िल्टर करना:
in_groupफ़ंक्शन का इस्तेमाल करके, किसी खास Cloud Identity ग्रुप से जुड़े ब्राउज़र फ़िल्टर किए जा सकते हैं. उदाहरण के लिए,in_group("groups/00gjdgxs0lm8l7o").
फ़िल्टर किए जा सकने वाले फ़ील्ड
| फ़ील्ड | जानकारी |
|---|---|
browser_permanent_id
|
Chrome ब्राउज़र वाले डिवाइस का स्थायी यूनीक आइडेंटिफ़ायर. |
last_policy_fetch_time
|
Chrome ब्राउज़र वाले डिवाइस के लिए, पिछली बार नीति फ़ेच करने का समय. |
os_platform
|
Chrome ब्राउज़र वाले डिवाइस के लिए ओएस प्लैटफ़ॉर्म (जैसे, WINDOWS, MAC, LINUX). |
os_architecture
|
Chrome ब्राउज़र डिवाइस का ओएस आर्किटेक्चर. |
os_version |
Chrome ब्राउज़र वाले डिवाइस के ओएस का वर्शन. |
machine_name
|
Chrome ब्राउज़र वाले डिवाइस से जुड़ी मशीन का नाम. |
annotated_location
|
Chrome ब्राउज़र डिवाइस की एनोटेट की गई जगह. |
annotated_user
|
Chrome ब्राउज़र डिवाइस के लिए एनोटेट किया गया उपयोगकर्ता. |
annotated_asset_id
|
Chrome ब्राउज़र डिवाइस के लिए, एनोटेट किया गया ऐसेट का आईडी. |
annotated_note
|
Chrome ब्राउज़र डिवाइस के लिए एनोटेट किए गए नोट. |
org_unit_path
|
Chrome ब्राउज़र वाले डिवाइस के लिए, संगठन की इकाई का पाथ (उदाहरण के लिए, /Marketing). |
org_unit_id
|
Chrome ब्राउज़र डिवाइस के लिए, संगठन की इकाई का आईडी. |
last_registration_time
|
Chrome ब्राउज़र डिवाइस के रजिस्ट्रेशन का समय. |
os_platform_version
|
Chrome ब्राउज़र वाले डिवाइस के लिए ओएस प्लैटफ़ॉर्म और मेजर वर्शन. |
browser_version
|
डिवाइस पर इंस्टॉल किए गए Chrome ब्राउज़र के वर्शन की जानकारी. |
last_status_report_time
|
Chrome ब्राउज़र वाले डिवाइस की पिछली स्टेटस रिपोर्ट का समय. |
extension_count
|
Chrome ब्राउज़र वाले डिवाइस पर इंस्टॉल किए गए एक्सटेंशन की संख्या. |
policy_count
|
Chrome ब्राउज़र डिवाइस पर लागू की गई नीतियों की संख्या. |
last_device_user |
मशीन पर पिछली बार साइन इन करने वाला उपयोगकर्ता. |
last_activity_time
|
Chrome ब्राउज़र वाले डिवाइस पर पिछली बार गतिविधि (नीति फ़ेच करना या रिपोर्ट करना) कब हुई थी. |
device_id_collision
|
क्या डिवाइस आईडी को कई ऐसी मशीनों के साथ शेयर किया गया है जिन्हें Chrome ब्राउज़र एक ही मशीन (true या false) के तौर पर पहचानता है. |
फ़िल्टर के फ़ंक्शन
| फ़ंक्शन | जानकारी |
|---|---|
in_group(string)
|
Chrome ब्राउज़र वाले डिवाइसों की सूची को फ़िल्टर करके, Cloud Identity ग्रुप के दिए गए संसाधन के नाम (फ़ॉर्मैट: in_group("groups/{group_id}")) से जुड़े डिवाइसों को दिखाता है. |
नतीजों को क्रम से लगाना
orderBy क्वेरी पैरामीटर का इस्तेमाल करके, नतीजों का क्रम तय किया जा सकता है. डिफ़ॉल्ट रूप से, डेटा बढ़ते क्रम में लगाया जाता है. किसी फ़ील्ड के लिए घटते क्रम को तय करने के लिए,
फ़ील्ड के नाम में सफ़िक्स " desc" जोड़ें (उदाहरण के लिए, last_activity_time
desc).
अगर कोई जानकारी नहीं दी गई है, तो डिफ़ॉल्ट क्रम browser_permanent_id के बढ़ते क्रम में होता है.
इस्तेमाल किए जा सकने वाले ऑर्डरिंग फ़ील्ड
browser_permanent_idlast_policy_fetch_timeannotated_userannotated_locationannotated_asset_idannotated_notesorg_unit_pathos_versionlast_registration_timeextension_countpolicy_countlast_device_usermachine_namebrowser_version_channelos_platform_versionlast_activity_timebrowser_version
एडमिन के खास अधिकार
Chrome Browsers API, एडमिन की भूमिका के डेलिगेशन का पालन करता है.
| तरीका | एडमिन के खास अधिकार होना ज़रूरी है |
|---|---|
| ListChromeBrowsers | "सेवाएं -> Chrome मैनेजमेंट -> सेटिंग -> मैनेज किए जा रहे ब्राउज़र" या "सेवाएं -> Chrome मैनेजमेंट -> सेटिंग -> मैनेज किए जा रहे ब्राउज़र -> रीड" |
| GetChromeBrowser | "सेवाएं -> Chrome मैनेजमेंट -> सेटिंग -> मैनेज किए जा रहे ब्राउज़र" या "सेवाएं -> Chrome मैनेजमेंट -> सेटिंग -> मैनेज किए जा रहे ब्राउज़र -> रीड" |
| UpdateChromeBrowser | "सेवाएं -> Chrome मैनेजमेंट -> सेटिंग -> मैनेज किए जा रहे ब्राउज़र" |
| MoveChromeBrowsers | "सेवाएं -> Chrome मैनेजमेंट -> सेटिंग -> मैनेज किए जा रहे ब्राउज़र" |
| DeleteChromeBrowser | "सेवाएं -> Chrome मैनेजमेंट -> सेटिंग -> मैनेज किए जा रहे ब्राउज़र" |
एडमिन की भूमिकाओं और खास अधिकारों को मैनेज करने के लिए, "Admin console -> एडमिन की भूमिकाएं" पर जाएं.
एपीआई के स्कोप
Chrome Management Chrome Browsers API के लिए, इन OAuth स्कोप की ज़रूरत होती है:
| तरीका | OAuth के दायरे ज़रूरी हैं |
|---|---|
| ListChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers या https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| GetChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers या https://www.googleapis.com/auth/chrome.management.browsers.readonly |
| UpdateChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
| MoveChromeBrowsers | https://www.googleapis.com/auth/chrome.management.browsers |
| DeleteChromeBrowser | https://www.googleapis.com/auth/chrome.management.browsers |
ज़्यादा जानकारी के लिए, पुष्टि करने की प्रोसेस के बारे में खास जानकारी देखें.