खास जानकारी

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

• जिस सोर्स से सूचना भेजी गई थी.
• सूचना का नाम.
• यह सूचना किस समय दी गई.
• इस सूचना से जुड़ा खास डेटा.

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

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

Alerts Center API का इस्तेमाल करें

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

जब आपके ऐप्लिकेशन में ऐसा क्लाउड प्रोजेक्ट होता है जो ज़रूरी शर्तों को पूरा करता है और सही तरीके से अनुमति मिल जाती है, तो यह 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);