Security Insights API की मदद से, Chrome में डेटा की सुरक्षा से जुड़ी अहम जानकारी पाने की सुविधा चालू या बंद की जा सकती है. साथ ही, यह भी देखा जा सकता है कि यह सुविधा चालू है या नहीं. इसके अलावा, अहम जानकारी से जुड़ा डेटा भी क्वेरी किया जा सकता है. जैसे, कॉन्टेंट ट्रांसफ़र और यूआरएल पर जाने की जानकारी.
एपीआई के तरीकों की खास जानकारी
यूआरएल, https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER के हिसाब से होते हैं
| ब्यौरा | मिलता-जुलता यूआरएल | एचटीटीपी तरीका | अनुरोध के लिए अनुमति वाले पैरामीटर |
|---|---|---|---|
| अपने डोमेन के लिए, अहम जानकारी पाने की सुविधा चालू करना और अपने डोमेन में रूट ओयू/ओयू के किसी खास सेट के लिए, Chrome कनेक्टर कॉन्फ़िगर करना | /enterprise/securityInsights:enable | पोस्ट करें | ज़रूरी नहीं: targetOus |
| अपने डोमेन के लिए, अहम जानकारी पाने की सुविधा बंद करना | /enterprise/securityInsights:disable | पोस्ट करें | |
| अपने डोमेन के लिए, अहम जानकारी पाने की सुविधा चालू है या नहीं, यह देखना | /enterprise/securityInsights:checkEnablementStatus | पाएं | |
| अपने डोमेन के लिए, कॉन्टेंट ट्रांसफ़र की खास जानकारी के लिए क्वेरी करना | /enterprise/securityInsights:queryContentTransfers | पाएं | ज़रूरी नहीं: फ़िल्टर |
| उपयोगकर्ता/डोमेन/कॉन्टेंट की कैटगरी के हिसाब से, कॉन्टेंट ट्रांसफ़र की खास जानकारी के लिए क्वेरी करना | /enterprise/securityInsights:queryContentTransfersBreakdowns | पाएं | ज़रूरी नहीं: फ़िल्टर, मेट्रिक, ब्रेकडाउन, fixedTimeRange, pageSize, pageToken |
| अपने डोमेन के लिए, यूआरएल पर जाने की खास जानकारी के लिए क्वेरी करना | /enterprise/securityInsights:queryUrlVisits | पाएं | ज़रूरी नहीं: फ़िल्टर |
| उपयोगकर्ता/डोमेन के हिसाब से, यूआरएल पर जाने की खास जानकारी के लिए क्वेरी करना | /enterprise/securityInsights:queryUrlVisitsBreakdowns | पाएं | ज़रूरी नहीं: फ़िल्टर, मेट्रिक, ब्रेकडाउन, fixedTimeRange, pageSize, pageToken |
अनुरोधों और जवाबों के उदाहरण के लिए, कोड के नमूने देखें.
सदस्यता के लिए ज़रूरी शर्तें
एपीआई के इन तरीकों के लिए, Chrome Enterprise Premium की चालू सदस्यता होना ज़रूरी है. अगर ग्राहक के पास यह सदस्यता नहीं है, तो अनुरोध ब्लॉक नहीं किए जाते. हालांकि, क्वेरी के नतीजे खाली होंगे.
queryUrlVisitsqueryUrlVisitsBreakdowns
एडमिन के खास अधिकार
जिस तरीके का इस्तेमाल किया जा रहा है उसके हिसाब से, एडमिन के अलग-अलग अधिकारों की ज़रूरत होती है.
| तरीका | एडमिन के ज़रूरी अधिकार |
|---|---|
| चालू करें | "ऑर्गनाइज़ेशनल यूनिट > पढ़ें" "सेवाएं > Chrome मैनेजमेंट > सेटिंग > उपयोगकर्ता की सेटिंग मैनेज करें" "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग मैनेज करें" |
| बंद करें | "ऑर्गनाइज़ेशनल यूनिट > पढ़ें" "सेवाएं > Chrome मैनेजमेंट > सेटिंग > उपयोगकर्ता की सेटिंग मैनेज करें" "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग मैनेज करें" |
| checkEnablementStatus | "ऑर्गनाइज़ेशनल यूनिट > पढ़ें" "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग मैनेज करें" या "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग देखें" |
| queryContentTransfers | "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग देखें" |
| queryContentTransfersBreakdowns | "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग देखें" |
| queryUrlVisits | "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग देखें" |
| queryUrlVisitsBreakdowns | "सेवाएं > Chrome डीएलपी > Chrome डीएलपी ऐप्लिकेशन की अहम जानकारी वाली सेटिंग देखें" |
एडमिन के रोल और अधिकारों को मैनेज करने के लिए, "Admin console -> एडमिन के रोल" पर जाएं.
एपीआई के स्कोप
एपीआई को चालू और बंद करने के लिए, OAuth के इस स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/chrome.management.securityinsights
checkEnablementStatus और क्वेरी के सभी तरीकों के लिए, इन दोनों स्कोप में से किसी एक का इस्तेमाल किया जा सकता है:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
ज़्यादा जानकारी के लिए, पुष्टि करने की खास जानकारी देखें.