بررسی اجمالی

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 است که پیش نیازها را برآورده می کند و به درستی مجاز است، می تواند درخواست های Alert Center API REST را ارائه دهد. هنگام استفاده از کتابخانه های مشتری موجود، ایجاد درخواست های API آسان تر است.

مثال زیر نحوه فهرست کردن هشدارهای موجود با استفاده از API را نشان می‌دهد:

جاوا

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