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

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

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

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

Цели

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

Предпосылки

• Java 1.8 или выше
• Облачный проект Google
• Аккаунт Google

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

Включите API

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

• В консоли Google Cloud включите API Центра оповещений.

  Включите API

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

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

1. В консоли Google Cloud выберите > IAM и администратор > Сервисные аккаунты .

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

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

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

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

1. В консоли Google Cloud выберите > IAM и администратор > Сервисные аккаунты .

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

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

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

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

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

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

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   Посмотреть на GitHub

   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

   Посмотреть на GitHub

   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

   Посмотреть на GitHub

   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

   Посмотреть на GitHub

   AlertFeedback newFeedback = new AlertFeedback();
   newFeedback.setType("VERY_USEFUL");
   AlertFeedback feedback = service.alerts().feedback().create(alertId, newFeedback).execute();
   System.out.println(feedback);