चेतावनी केंद्र एपीआई की मदद से, आप अपने डोमेन पर असर डालने वाली सूचनाएं मैनेज कर सकते हैं. Google को मिली सुरक्षा से जुड़ी संभावित समस्या के बारे में चेतावनी देने वाली चेतावनी दिखती है. सूचनाओं में यह जानकारी शामिल होती है:
- वह सोर्स जिससे सूचना मिली है.
- सूचना का नाम.
- यह चेतावनी मिलने का समय.
- इस चेतावनी से जुड़ा खास डेटा.
डोमेन एडमिन, Google Admin console से मैन्युअल तौर पर सूचनाएं देख सकते हैं और उन्हें मैनेज कर सकते हैं. Alerts Center API की मदद से, आपके बनाए गए ऐप्लिकेशन को चेतावनी का डेटा और सूचना से जुड़े सुझाव, राय या शिकायतें मिल सकती हैं. एपीआई मौजूदा सूचनाओं के लिए, सूचना से जुड़े नए सुझाव भी बना सकता है.
उदाहरण के लिए, निगरानी करने वाला कोई ऐप्लिकेशन चेतावनी केंद्र एपीआई का इस्तेमाल करके, किसी डोमेन से जुड़ी हाल ही में मिली सूचनाओं को वापस ला सकता है और उन्हें प्राथमिकता दे सकता है. इसके बाद, वह आपके संगठन के सदस्यों को सूचना भेज सकता है. जब आपकी टीम चेतावनी का जवाब दे देती है, तो ऐप्लिकेशन उससे मिली जानकारी के आधार पर उस सूचना में सुझाव अटैच कर सकता है.
चेतावनी केंद्र एपीआई का इस्तेमाल करें
चेतावनी केंद्र एपीआई का इस्तेमाल करने से पहले, आपको एक नया Cloud Platform प्रोजेक्ट सेट अप करना और चेतावनी केंद्र एपीआई को चालू करना होगा. एपीआई ऐक्सेस करते समय, आपके प्रोजेक्ट को सेवा खाते का इस्तेमाल करना चाहिए.
जब आपके ऐप्लिकेशन में ऐसा क्लाउड प्रोजेक्ट हो जो ज़रूरी शर्तें पूरी करता हो और उसे सही तरीके से अनुमति दी गई हो, तो यह Alerts Center API REST के लिए अनुरोध कर सकता है. उपलब्ध क्लाइंट लाइब्रेरी का इस्तेमाल करते समय, एपीआई अनुरोध करना आसान होता है.
यहां दिए गए उदाहरण में, एपीआई का इस्तेमाल करके उपलब्ध चेतावनियों की सूची बनाने का तरीका बताया गया है:
Java
// First, authorize the API and create a client to make requests with.
URL serviceAccountUrl = AuthUtils.class.getResource("/client_secret.json");
GoogleCredentials credentials = ServiceAccountCredentials
.fromStream(serviceAccountUrl.openStream())
.createDelegated("admin@xxxx.com")
.createScoped(Collections.singleton("https://www.googleapis.com/auth/apps.alerts"));
ApacheHttpTransport transport = new ApacheHttpTransport();
HttpCredentialsAdapter adapter = new HttpCredentialsAdapter(credentials);
AlertCenter alertCenter = new AlertCenter.Builder(transport, new JacksonFactory(), adapter)
.setApplicationName("Alert Center client")
.build();
// List alerts in pages, printing each alert discovered.
String pageToken = null;
do {
ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)
.setPageSize(20).execute();
if (listResponse.getAlerts() != null) {
for (Alert alert : listResponse.getAlerts()) {
System.out.println(alert);
}
}
pageToken = listResponse.getNextPageToken();
} while (pageToken != null);