Журнал изменений

API агента тарифного плана

Декабрь 2019 г.

  1. Введено определение API регистра CPID для реализации DPA.
  2. Добавлены рекомендации по генерации CPID и его сохранению, когда клиент запрашивает новый CPID.
  3. Добавлена документация по выбору CPID, используемого для отправки уведомлений.
  4. Уточнен порядок определения языковых предпочтений пользователя, когда GTAF вызывает DPA и когда DPA вызывает GTAF.

Октябрь 2019 г.

  1. Требовать новый CPID при каждом обращении к конечной точке CPID. Это можно сделать, добавив временную метку в алгоритм генерации CPID.
  2. Удалить поле planLanguage из предложения , которое до сих пор было отмечено как обязательное поле.

Сентябрь 2019 г.

  1. Добавлена поддержка уведомлений об истечении срока действия данных, отличных от уведомлений-предупреждений об истечении срока действия данных.

Июль 2019 г.

  1. Уточнены возможные значения идентификатора клиента.
  2. Добавлена поддержка уведомлений о пополнении счета.
  3. Смягчены требования к генерации CPID: больше не требуется вводить новый CPID при каждом вызове конечной точки CPID.
  4. Добавьте документацию по различным сообщениям об ошибках от GTAF при вызове API совместного использования мобильных тарифных планов.

Июнь 2019 г.

  1. Обновленная спецификация API DPA требует от операторов принимать идентификатор _client в качестве параметра запроса.
  2. Обновленный API совместного использования тарифных планов мобильных данных позволяет операторам связи обмениваться с Google информацией о тарифных планах пользователя для конкретного клиента.
  3. Порядок, в котором предложения показываются пользователю, может не совпадать с порядком, в котором предложения предоставляются GTAF.
  4. GTAF может использовать более 10 тарифных планов совместно с Mobile Data Plan UI.

Май 2019 г.

  1. Поле ExpirationTime обязательно, если срок действия плана не истек.
  2. Согласно RFC 6749, отметьте token_type как обязательный в ответе сервера OAuth.
  3. Возвращает тип уведомлений, отправляемых пользователю, когда оператор передает статус плана в GTAF.

Апрель 2019 г.

  1. Для предоплаченных абонентов требуется AccountInfo.
  2. Обновите рекомендуемый метод генерации CPID, чтобы включить язык в простой текст при генерации CPID.
  3. Удалена поддержка moreInfoUrl, operatorLogoUrl и purchaseUrl из предложений. Эти поля не поддерживались пользовательским интерфейсом тарифного плана мобильной связи. Изменение обратно совместимо.
  4. Добавлена поддержка отправки уведомлений, когда пользователь расходует остаток на счете, используя данные в режиме оплаты по мере использования.
  5. Удалена поддержка гибких временных интервалов из модулей планов. Изменение обратно совместимо. Таким образом, если оператор отправляет нам гибкие временные интервалы, ответ будет принят.

Март 2019 г.

  1. Удалите offerInfo.promoMessage из набора обязательных полей. MDP не использует это поле при показе предложений пользователям.
  2. Исправлена ошибка в документации, из-за которой CPID должен быть закодирован в URL. Вместо этого GTAF кодирует CPID согласно RFC2396 .
  3. Добавлены требования к push-уведомлениям.

Февраль 2019 г.

  1. Удалена поддержка совместного использования PlanOffer с Google с помощью API совместного использования тарифных планов.

Январь 2019 г.

  1. Добавлено руководство по обновлению конфигурации оператора с помощью портала интернет-провайдера.
  2. Добавлено руководство по внедрению OAuth для API Data Plan Agent.
  3. Переименовано и реорганизовано руководство по интеграции API совместного использования мобильных данных.

Ноябрь 2018 г.

  1. Добавлена поддержка уведомлений об активации плана.
  2. Добавлена поддержка категории трафика модуля плана APP_STORE.

Сентябрь 2018 г.

  1. Добавлен API для передачи операторам согласия пользователя .
  2. Добавлена поддержка планов, которые периодически обновляют свою квоту в PlanModule и Offer .
  3. Добавлена поддержка уведомлений об истечении срока действия.
  4. PlanModuleState переименован в PlanState . Это изменение документации, которое не должно повлиять на операторов.

Август 2018 г.

  1. Добавлена возможность операторам связи указывать баланс счета как часть PlanStatus .

Июнь 2018 г.

  1. Удалено обновление, методы получения статуса плана и предложений плана.
  2. Разрешено заполнение уровня грубого баланса одновременно с заполнением баланса байтов или баланса времени.
  3. Добавлен тип подключения к предложению .
  4. В PlanModule добавлено поле «Состояние модуля тарифного плана» , позволяющее оператору указывать тарифные планы, которые пользователь приобрел, но ещё не активировал. Это поле не является обязательным.
  5. DataPlan переименован в Plan . Это изменение документации не должно повлиять на операторов.
  6. Добавлено поле formOfPayment в PlanOffer , позволяющее оператору указать, как с пользователя будет взиматься плата за покупку. По умолчанию она вычитается из баланса плана.

Май 2018 г.

  1. Обновлен ответ CPID для сохранения обратной совместимости.
  2. Добавлен заголовок для PlanStatus . Он будет использоваться для заполнения заголовка в интерфейсе настроек.
  3. Добавлено имя модуля и используемые байты для PlanModule .
  4. Добавлен обратный звонок в ответ на покупку в GTAF.

Март 2018 г.

Это обновление включает следующие изменения в API агента Data Plan. Эти изменения относятся к Data Plan API версии 4.2, размещённой здесь .

  1. Делает устаревшими следующие вызовы API:
    1. Запрос учетной записи пользователя (DPA_URL/{data_plan_key_string}/account).
    2. Запрос приобретенных планов (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. Изменяет URL-адрес, который мы вызываем для получения информации о состоянии тарифного плана. Новый URL-адрес описан здесь . Ожидается, что DPA вернет экземпляр PlanStatus .
  3. Изменяет URL-адрес, который мы вызываем для предложений тарифных планов. Новый URL-адрес описан здесь . Ожидается, что DPA вернет экземпляр PlanOffer .
  4. Изменяет тело запроса, отправляемого в DPA при покупке тарифного плана. Обратите внимание, что вызов API остался прежним. Тело запроса теперь содержит экземпляр TransactionRequest . Обратите внимание на удаление уровня вложенности по сравнению с предыдущей версией API.
  5. Изменился ответ на запрос покупки. Мы используем тип валюты, определяемый протоколом Google. В случае успешной покупки мы ожидаем, что тело ответа будет содержать экземпляр TransactionResponse .
  6. Если plan_id не указан, API для проверки соответствия требованиям ДОЛЖЕН возвращать все тарифные планы, доступные пользователю. Ранее это было необязательно.
  7. Добавляет конечную точку регистрации MSISDN для GTAF для регистрации MSISDN для уведомлений в DPA.

API совместного использования тарифного плана Google Mobile Data

Март 2018 г.

Это обновление включает в себя следующие изменения в API совместного использования мобильных данных Google:

  1. Вводит новые вызовы API, позволяющие оператору передавать информацию о предложениях допродаж в GTAF для дальнейшей передачи на устройства пользователей. Эти новые вызовы позволяют оператору отправлять предложения в Google.
  2. Вводит поле времени последнего обновления в PlanGroup.
  3. Удаляет поле процента кредита данных из окна гибкого времени.