चेतावनी केंद्र एपीआई की मदद से, अपने डोमेन पर असर डालने वाली सूचनाओं को मैनेज किया जा सकता है. चेतावनी Google को मिली संभावित सुरक्षा समस्या की चेतावनी होती है. सूचनाओं में यह जानकारी शामिल होती है:
- वह सोर्स जहां से सूचना मिली है.
- सूचना का नाम.
- यह चेतावनी मिलने का समय.
- इस चेतावनी से जुड़ा खास डेटा.
डोमेन एडमिन, Google Admin console से मैन्युअल तरीके से सूचनाएं देख सकते हैं और उन्हें मैनेज कर सकते हैं. अलर्ट सेंटर एपीआई आपके बनाए गए ऐप्लिकेशन को चेतावनी का डेटा और अलर्ट के बारे में सुझाव, शिकायत या राय पाने की सुविधा देता है. एपीआई मौजूदा सूचनाओं के लिए, नए अलर्ट भी बना सकता है.
उदाहरण के लिए, निगरानी करने वाला कोई ऐप्लिकेशन चेतावनी केंद्र एपीआई का इस्तेमाल कर सकता है. इसकी मदद से, वह किसी डोमेन से जुड़ी सबसे नई चेतावनियां वापस पा सकता है और उन्हें प्राथमिकता दे सकता है. इसके बाद, वह आपके संगठन के सदस्यों को सूचना भेज सकता है. जब आपकी टीम चेतावनी का जवाब दे देती है, तब रिपोर्ट के नतीजों के आधार पर वह ऐप्लिकेशन उस सूचना से सुझाव, शिकायत या राय अटैच कर सकता है.
चेतावनी केंद्र एपीआई का इस्तेमाल करें
चेतावनी केंद्र एपीआई का इस्तेमाल करने से पहले, आपको एक नया Cloud Platform प्रोजेक्ट सेट अप करना होगा और चेतावनी केंद्र एपीआई चालू करना होगा. एपीआई ऐक्सेस करते समय, आपके प्रोजेक्ट को सेवा खाते का इस्तेमाल करना होगा.
अगर आपके ऐप्लिकेशन में ऐसा क्लाउड प्रोजेक्ट है जो ज़रूरी शर्तों को पूरा करता है और उसे सही तरीके से अनुमति दी गई है, तो यह अलर्ट सेंटर एपीआई 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);