Краткое руководство по Java

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

В кратких руководствах объясняется, как настроить и запустить приложение, которое вызывает API Google Workspace.

В кратких руководствах по Google Workspace используются клиентские библиотеки API для обработки некоторых деталей процесса аутентификации и авторизации. Мы рекомендуем вам использовать клиентские библиотеки для ваших собственных приложений. Прежде чем вы сможете запустить пример приложения, в каждом кратком руководстве необходимо включить проверку подлинности и авторизацию. Если вы не знакомы с аутентификацией и авторизацией для API Google Workspace, прочтите обзор аутентификации и авторизации .

Как администратор Google Workspace, вы можете использовать API Центра оповещений для доступа к оповещениям о проблемах, затрагивающих ваш домен.

Цели

  • Настройте свою среду.
  • Настройте и запустите образец.

Предпосылки

Настройте свою среду

Включите API

Прежде чем использовать Google API, вам необходимо включить их в проекте Google Cloud. Вы можете включить один или несколько API в одном проекте Google Cloud.
  • В консоли Google Cloud включите API Центра оповещений.

    Включите API

Создать учетную запись службы

Учетная запись службы — это особый тип учетной записи, используемой приложением, а не человеком. Вы можете использовать учетную запись службы для доступа к данным или выполнения действий с помощью учетной записи робота или для доступа к данным от имени пользователей Google Workspace или Cloud Identity. Дополнительные сведения см. в разделе Общие сведения об учетных записях служб .
  1. В консоли Google Cloud > IAM и администратор > Сервисные аккаунты .

    Перейти к сервисным аккаунтам

  2. Щелкните Создать сервисный аккаунт .
  3. Заполните данные учетной записи службы, затем нажмите « Создать и продолжить ».
  4. Необязательно: назначьте роли своей учетной записи службы, чтобы предоставить доступ к ресурсам вашего проекта Google Cloud. Дополнительные сведения см. в разделе Предоставление, изменение и отзыв доступа к ресурсам .
  5. Нажмите Продолжить .
  6. Необязательно: введите пользователей или группы, которые могут управлять этой учетной записью службы и выполнять действия с ней. Дополнительные сведения см. в разделе Управление олицетворением учетной записи службы .
  7. Щелкните Готово .

Создание учетных данных для учетной записи службы

Вам необходимо получить учетные данные в виде пары открытый/закрытый ключ. Эти учетные данные используются вашим кодом для авторизации действий с учетной записью службы в вашем приложении.
  1. В консоли Google Cloud > IAM и администратор > Сервисные аккаунты .

    Перейти к сервисным аккаунтам

  2. Выберите учетную запись службы.
  3. Нажмите «Ключи » > « Добавить ключ » > «Создать новый ключ ».
  4. Выберите JSON и нажмите «Создать ».

    Ваша новая пара открытого и закрытого ключей будет сгенерирована и загружена на ваш компьютер в виде нового файла. Этот файл является единственной копией этого ключа. Сведения о безопасном хранении ключа см. в разделе Управление ключами сервисных учетных записей .

  5. Щелкните Закрыть .

Настройка и запуск образца

  1. Получить учетные данные:

    adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java
    InputStream in = AdminSDKAlertCenterQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);
    if (in == null) {
      throw new FileNotFoundException("Resource not found: " + CREDENTIALS_FILE_PATH);
    }
    GoogleCredentials credentials = ServiceAccountCredentials
        .fromStream(in)
        .createDelegated(delegatedAdminEmail)
        .createScoped(SCOPES);
  2. Создайте экземпляр клиента:

    adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java
    NetHttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
    AlertCenter service = new AlertCenter.Builder(transport, JSON_FACTORY,
        new HttpCredentialsAdapter(getCredentials(DELEGATED_ADMIN_EMAIL)))
        .setApplicationName(APPLICATION_NAME)
        .build();
  3. Показать все оповещения:

    adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java
    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);
  4. Отправьте отзыв о заданном предупреждении:

    adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java
    AlertFeedback newFeedback = new AlertFeedback();
    newFeedback.setType("VERY_USEFUL");
    AlertFeedback feedback = service.alerts().feedback().create(alertId, newFeedback).execute();
    System.out.println(feedback);