ภาพรวม

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