खास जानकारी

Alert Center API की मदद से, अपने डोमेन को प्रभावित करने वाले अलर्ट मैनेज किए जा सकते हैं. अलर्ट, सुरक्षा से जुड़ी किसी संभावित समस्या के बारे में चेतावनी होती है. Google को इस समस्या का पता चला होता है. अलर्ट में यह जानकारी शामिल होती है:

  • वह सोर्स जिससे अलर्ट जनरेट हुआ.
  • अलर्ट का नाम.
  • अलर्ट जनरेट होने का समय.
  • इस अलर्ट से जुड़ा खास डेटा.

डोमेन के एडमिन, Google Admin console से मैन्युअल तरीके से अलर्ट देख और मैनेज कर सकते हैं. Alert Center API की मदद से, आपके बनाए गए ऐप्लिकेशन, अलर्ट का डेटा और अलर्ट के बारे में मिली प्रतिक्रिया को वापस पा सकते हैं. यह एपीआई, मौजूदा अलर्ट के लिए, अलर्ट के बारे में नई प्रतिक्रिया भी जनरेट कर सकता है.

उदाहरण के लिए, मॉनिटरिंग ऐप्लिकेशन, Alert Center API का इस्तेमाल करके, किसी डोमेन के लिए हाल ही में जनरेट हुए अलर्ट वापस पा सकता है. साथ ही, उन्हें प्राथमिकता दे सकता है और फिर आपकी कंपनी के सदस्यों को सूचना भेज सकता है. आपकी टीम के अलर्ट का जवाब देने के बाद, ऐप्लिकेशन अपनी खोज के आधार पर, अलर्ट में प्रतिक्रिया जोड़ सकता है.

Alert Center API का इस्तेमाल करना

Alert Center API का इस्तेमाल करने से पहले, आपको नया Google Cloud प्रोजेक्ट सेट अप करना होगा. साथ ही, Alert Center API को चालू करना होगा. एपीआई को ऐक्सेस करते समय, आपके प्रोजेक्ट को सेवा खाते का इस्तेमाल करना होगा.

अगर आपके ऐप्लिकेशन के पास ऐसा Google Cloud प्रोजेक्ट है जो ज़रूरी शर्तें पूरी करता है और जिसे सही तरीके से अनुमति दी गई है, तो वह Alert 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);