변경 기록

Data Plan Agent API

2019년 12월

  1. DPA가 구현할 register CPID API 정의를 도입했습니다.
  2. 클라이언트가 새 CPID를 요청할 때 CPID를 생성하고 저장하는 방법에 관한 제안이 추가되었습니다.
  3. 알림 전송에 사용할 CPID를 선택하는 방법에 관한 문서가 추가되었습니다.
  4. GTAF가 DPA를 호출할 때와 DPA가 GTAF를 호출할 때 사용자 언어 환경설정을 결정하는 방법을 명확히 했습니다.

2019년 10월

  1. CPID 엔드포인트에 연결할 때마다 새 CPID가 필요합니다. 이는 CPID 생성 알고리즘에 타임스탬프를 추가하여 달성할 수 있습니다.
  2. 지금까지 필수 필드로 표시되었던 Offer에서 planLanguage를 삭제합니다.

2019년 9월

  1. 데이터 만료 경고 알림과 구분되는 데이터 만료 알림 지원이 추가되었습니다.

2019년 7월

  1. 가능한 클라이언트 식별자 값을 명확하게 설명했습니다.
  2. 계정 충전 알림 지원을 추가했습니다.
  3. CPID 엔드포인트가 호출될 때마다 새 CPID가 필요하다는 요구사항에서 완화되었습니다.
  4. Mobile Data Plan Sharing API를 호출할 때 GTAF에서 발생하는 다양한 오류 응답에 관한 문서 추가

2019년 6월

  1. 운송업체가 _clientid를 쿼리 매개변수로 수락하도록 요구하는 DPA API 사양이 업데이트되었습니다.
  2. 이동통신사가 특정 클라이언트의 사용자 요금제 정보를 Google과 공유할 수 있도록 모바일 데이터 요금제 공유 API가 업데이트되었습니다.
  3. 사용자에게 혜택이 표시되는 순서는 GTAF에 혜택이 제공되는 순서와 다를 수 있습니다.
  4. GTAF는 모바일 데이터 요금제 UI와 10개 이상의 요금제를 공유할 수 있습니다.

2019년 5월

  1. 계획이 만료되지 않는 경우를 제외하고 ExpirationTime은 필수입니다.
  2. RFC 6749에 따라 OAuth 서버 응답에서 token_type을 필수 항목으로 표시
  3. 이동통신사가 GTAF에 요금제 상태를 푸시할 때 사용자에게 전송된 알림 유형을 반환합니다.

2019년 4월

  1. 선불 구독자에게는 AccountInfo가 필요합니다.
  2. CPID 생성 시 일반 텍스트에 언어를 포함하도록 권장 CPID 생성 방법을 업데이트합니다.
  3. 혜택에서 moreInfoUrl, operatorLogoUrl, purchaseUrl 지원이 삭제되었습니다. 이러한 필드는 모바일 데이터 요금제 UI에서 지원되지 않았습니다. 이 변경사항은 이전 버전과 호환됩니다.
  4. 사용자가 종량제 상태에서 데이터를 사용하여 계정 잔액을 소진할 때 알림을 전송하는 지원이 추가되었습니다.
  5. 계획 모듈에서 유연한 시간대 지원이 삭제되었습니다. 이 변경사항은 이전 버전과 호환됩니다. 따라서 작업자가 유연한 시간대를 전송하는 경우 응답이 수락됩니다.

2019년 3월

  1. 필수 필드 세트에서 offerInfo.promoMessage를 삭제합니다. MDP는 사용자에게 혜택을 표시할 때 이 필드를 사용하지 않습니다.
  2. CPID가 URL로 인코딩되어야 한다고 설명하는 문서 버그 수정 대신 GTAF는 RFC2396에 따라 CPID를 인코딩합니다.
  3. 푸시 알림 요구사항이 추가되었습니다.

2019년 2월

  1. 데이터 요금제 공유 API를 사용하여 Google과 PlanOffer를 공유하는 지원이 삭제되었습니다.

2019년 1월

  1. ISP 포털을 사용하여 이동통신사 구성을 업데이트하는 가이드가 추가되었습니다.
  2. 데이터 요금제 에이전트 API의 OAuth 구현 가이드가 추가되었습니다.
  3. Mobile Data Plan Sharing API 통합 가이드의 이름이 변경되고 재구성되었습니다.

2018년 11월

  1. 요금제 활성화 알림 지원을 추가했습니다.
  2. APP_STORE 계획 모듈 트래픽 카테고리 지원이 추가되었습니다.

2018년 9월

  1. 사용자 동의를 운영자에게 보고하는 API가 추가되었습니다.
  2. 할당량을 주기적으로 새로고침하는 요금제에 대한 지원이 PlanModule 및 Offer에 추가되었습니다.
  3. 만료 알림 지원이 추가되었습니다.
  4. PlanModuleState를 PlanState로 이름을 바꿨습니다. 이는 운영자에게 영향을 미치지 않는 문서 변경사항입니다.

2018년 8월

  1. 이동통신사가 PlanStatus의 일부로 계정 잔액을 지정할 수 있는 기능이 추가되었습니다.

2018년 6월

  1. 계획 상태 및 계획 혜택의 업데이트, 가져오기 메서드가 삭제되었습니다.
  2. 바이트 잔액 또는 시간 잔액이 채워질 때 대략적인 잔액 수준이 동시에 채워지도록 허용
  3. 혜택에 연결 유형이 추가되었습니다.
  4. 운영자가 사용자가 구매했지만 아직 활성화되지 않은 요금제를 나타낼 수 있도록 PlanModule에 plan module state 필드가 추가되었습니다. 필수 입력란이 아닙니다.
  5. DataPlan이 Plan으로 이름이 변경되었습니다. 이는 운영자에게 영향을 미치지 않는 문서 변경사항입니다.
  6. PlanOffer에 formOfPayment 필드를 추가하여 운영자가 사용자의 구매에 대한 요금이 청구되는 방식을 지정할 수 있습니다. 기본적으로 요금제 잔액에서 차감됩니다.

2018년 5월

  1. CPID 응답을 업데이트하여 응답이 이전 버전과 호환되도록 했습니다.
  2. PlanStatus의 제목이 추가되었습니다. 제목은 설정 UI의 헤더를 채우는 데 사용됩니다.
  3. PlanModule의 모듈 이름과 사용된 바이트를 추가했습니다.
  4. GTAF에 구매 응답 콜백이 추가되었습니다.

2018년 3월

이 업데이트에는 데이터 요금제 에이전트 API에 대한 다음과 같은 변경사항이 포함되어 있습니다. 이러한 변경사항은 여기에 호스팅된 데이터 요금제 API v4.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는 사용자가 사용할 수 있는 모든 데이터 요금제를 반환해야 합니다(MUST). 이전에는 선택사항이었습니다.
  7. GTAF가 DPA에 알림을 위한 MSISDN을 등록할 수 있도록 MSISDN 등록 엔드포인트를 추가합니다.

Google Mobile Data Plan Sharing API

2018년 3월

이 업데이트에는 Google 모바일 데이터 요금제 공유 API에 대한 다음과 같은 변경사항이 포함되어 있습니다.

  1. 작업자가 GTAF에 추가로 푸시되어 사용자 기기에 푸시될 수 있는 업셀 제안 정보를 푸시할 수 있는 새로운 API 호출을 도입합니다. 이러한 새로운 호출을 통해 운영자는 Google에 혜택을 푸시할 수 있습니다.
  2. PlanGroup에 마지막 업데이트 시간 필드를 도입합니다.
  3. 유연한 시간대에서 데이터 크레딧 비율 필드를 삭제합니다.