Chrome Management Chrome Browsers API

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_id
  • last_policy_fetch_time
  • annotated_user
  • annotated_location
  • annotated_asset_id
  • annotated_notes
  • org_unit_path
  • os_version
  • last_registration_time
  • extension_count
  • policy_count
  • last_device_user
  • machine_name
  • browser_version_channel
  • os_platform_version
  • last_activity_time
  • browser_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

ज़्यादा जानकारी के लिए, पुष्टि करने की प्रोसेस के बारे में खास जानकारी देखें.