Руководство по интеграции

Получить закрытый ключ

Использование встроенного интерфейса

Для интеграции с API необходимо создать проект Google Cloud. После этого создайте учетную запись службы и получите закрытый ключ. Чтобы начать, нажмите следующую кнопку:

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

Генерация ключа вручную

Если указанный выше интерфейс не работает, попробуйте следующее:

  1. Перейдите в облачную консоль Google .
  2. Выберите проект, с помощью которого будет осуществляться доступ к API.
  3. В меню IAM и администратора слева найдите учетные записи служб и создайте новую учетную запись службы, которая будет владельцем проекта.
  4. После создания служебной учетной записи вы должны получить закрытый ключ.

Учетная запись службы белого списка

После создания служебной учетной записи:

  1. Свяжитесь с командой GTAF по адресу mdp-support@google.com , используя учетную запись Google, которая является владельцем проекта. Мы внесем учетную запись Google в белый список для доступа к конечным точкам API совместного использования планов мобильных данных.
  2. Свяжите сервисный аккаунт с оператором связи на портале Google ISP . Оператор связи может установить эту ассоциацию, перейдя в API Access .

Включить библиотеку

После внесения в белый список:

  1. Посетите облачную консоль Google .
  2. Убедитесь, что вы выбрали правильный проект в раскрывающемся списке в верхней строке меню.
  3. Включите API обмена мобильными тарифными планами в библиотеке API .
  4. Включите Preprod Mobile Data Plan Sharing API в библиотеке API .

Тестовый доступ к API

Чтобы проверить доступ к боковым методам Google:

  1. Установите oauth2l .

  2. Получите токен доступа для своей учетной записи службы следующим образом. your-service-account-key-file.json — это ключевой файл вашей служебной учетной записи.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Обратите внимание, что срок действия маркера доступа истекает примерно через час. Перед повторным запуском вышеуказанной команды для нового токена доступа запустите oauth2l reset , чтобы очистить локальный кеш.

  3. Выполните тестовые вызовы следующим образом. YOUR-ASN должен быть одним из ASN, которые вы отправляете нам при настройке GTAF в процессе интеграции. ACCESS-TOKEN-OBTAINED — это вывод вышеуказанной oauth2l fetch . PLAN_STATUS — это текст запроса PlanStatus , который вы хотите отправить в GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Программные вызовы API

Следуйте инструкциям , чтобы выполнять авторизованные вызовы сторонних методов Google со следующей областью действия OAuth:

https://www.googleapis.com/auth/dataplansharing

Совместное владение проектом

Хотя первоначальная настройка включает в себя одну учетную запись Google, рекомендуется, чтобы группа авторизованных пользователей владела проектом. В Google Cloud Console в меню IAM и администратора вы можете добавить новых участников (включая учетную запись групп Google), которые станут владельцами проекта.