ภาพรวม

API ของศูนย์แจ้งเตือนช่วยให้คุณจัดการการแจ้งเตือนที่ส่งผลกระทบต่อโดเมนได้ การแจ้งเตือนคือคำเตือนเกี่ยวกับปัญหาด้านความปลอดภัยที่อาจเกิดขึ้นซึ่ง Google ตรวจพบ การแจ้งเตือนประกอบด้วยข้อมูลต่อไปนี้

  • แหล่งที่มาของการแจ้งเตือน
  • ชื่อของการแจ้งเตือน
  • เวลาที่เกิดการแจ้งเตือนนี้
  • ข้อมูลเฉพาะที่เชื่อมโยงกับการแจ้งเตือนนี้

ผู้ดูแลระบบโดเมนสามารถดูและจัดการการแจ้งเตือนด้วยตนเองได้จากคอนโซลผู้ดูแลระบบของ Google Alert Center API จะอนุญาตให้แอปที่คุณสร้างไว้เรียกดูข้อมูลการแจ้งเตือนและความคิดเห็นต่อการแจ้งเตือนนั้นได้ API ดังกล่าวยังสามารถสร้างความคิดเห็นใหม่ต่อการแจ้งเตือนที่มีอยู่ได้ด้วย

เช่น แอปตรวจสอบอาจใช้ Alert Center API เพื่อเรียกดูการแจ้งเตือนล่าสุดสําหรับโดเมน จัดลําดับความสําคัญการแจ้งเตือนเหล่านั้น แล้วแจ้งให้สมาชิกในองค์กรทราบ หลังจากทีมตอบกลับการแจ้งเตือนแล้ว แอปจะแนบความคิดเห็นไปยังการแจ้งเตือนโดยอิงจากผลการตรวจสอบ

ใช้ Alert Center API

ก่อนใช้ Alert Center API คุณต้องตั้งค่าโปรเจ็กต์ Cloud Platform ใหม่และเปิดใช้ Alert Center API โปรเจ็กต์ต้องใช้บัญชีบริการ เมื่อเข้าถึง API

เมื่อแอปมีโปรเจ็กต์ Cloud ที่เป็นไปตามข้อกำหนดเบื้องต้นและได้รับการให้สิทธิ์อย่างถูกต้องแล้ว แอปจะส่งคำขอ REST ของ Alert Center API ได้ การส่งคำขอ API จะง่ายขึ้นเมื่อใช้ไลบรารีของไคลเอ็นต์ที่มีอยู่

ตัวอย่างต่อไปนี้แสดงวิธีแสดงการแจ้งเตือนที่พร้อมใช้งานโดยใช้ API

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