खास जानकारी

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

• वह सोर्स जिससे सूचना मिली.
• सूचना का नाम.
• यह सूचना कब मिली.
• इस सूचना से जुड़ा खास डेटा.

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

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

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

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

जब आपके ऐप्लिकेशन में ज़रूरी शर्तें पूरी करने वाला और सही तरीके से अनुमति वाला Cloud प्रोजेक्ट हो, तो वह Alert Center API REST अनुरोध कर सकता है. उपलब्ध क्लाइंट लाइब्रेरी का इस्तेमाल करके, एपीआई रिक्वेस्ट करना आसान होता है.

इस उदाहरण में, एपीआई का इस्तेमाल करके उपलब्ध सूचनाओं की सूची बनाने का तरीका बताया गया है:

// 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);