Список изменений

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. Обновлена ​​спецификация DPA API, требующая от операторов принимать идентификатор _client в качестве параметра запроса.
  2. Обновленный API обмена мобильными данными, позволяющий операторам связи обмениваться информацией о тарифных планах пользователя для конкретного клиента с Google.
  3. Порядок, в котором предложения отображаются пользователю, может не совпадать с порядком, в котором предложения предоставляются GTAF.
  4. GTAF может совместно использовать более 10 планов с пользовательским интерфейсом Mobile Data Plan.

май 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. Добавлено руководство по обновлению конфигурации оператора с помощью портала ISP.
  2. Добавлено руководство по реализации OAuth для API агента плана данных.
  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. В PlanOffer добавлено поле formOfPayment , позволяющее оператору указать, как с пользователя будет взиматься плата за покупку. По умолчанию это вычитается из баланса плана.

май 2018 г.

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

март 2018 г.

Это обновление включает следующие изменения в API агента плана данных. Эти изменения относятся к 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 protobuf. В ответ на успешную покупку мы ожидаем, что тело ответа будет содержать экземпляр TransactionResponse .
  6. Если plan_id не указан, то API приемлемости ДОЛЖЕН возвращать все планы данных, на которые имеет право пользователь. Раньше это было необязательным.
  7. Добавляет конечную точку регистрации MSISDN для GTAF для регистрации MSISDN для уведомлений с помощью DPA.

API обмена тарифными планами Google для мобильных устройств

март 2018 г.

Это обновление включает следующие изменения в Google Mobile Data Plan Sharing API:

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