변경 로그

데이터 요금제 에이전트 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가 필요하지 않도록 CPID 생성 요구사항이 완화되었습니다.
  4. 모바일 데이터 요금제 공유 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. Data Plan Agent 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에 요금제 모듈 상태 필드가 추가되어 사용자가 구매했지만 아직 활성화되지 않은 요금제를 운영자가 나타낼 수 있습니다. 필수 입력란이 아닙니다.
  5. DataPlan의 이름이 Plan으로 변경되었습니다. 이 변경사항은 연산자에 영향을 주지 않는 문서 변경사항입니다.
  6. PlanOffer에 formOfPayment 필드가 추가되어 사용자가 구매와 관련된 요금 청구 방법을 지정할 수 있습니다. 기본적으로 요금제 잔액에서 차감됩니다.

2018년 5월

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

2018년 3월

이 업데이트에는 Data Plan Agent API가 다음과 같이 변경되었습니다. 이러한 변경사항은 여기에 호스팅된 Data Plan 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은 Google protobuf에서 정의한 통화 유형을 활용합니다. 성공적인 구매에는 응답 본문에 TransactionResponse의 인스턴스가 포함될 것으로 예상됩니다.
  6. plan_id을 지정하지 않으면 자격요건 API는 사용자가 사용할 수 있는 모든 데이터 요금제를 반환해야 합니다. 이전에는 선택사항이었습니다.
  7. GTAF용 MSISDN 등록 엔드포인트를 추가하여 DPA의 알림에 대한 MSISDN을 등록합니다.

Google 모바일 데이터 요금제 공유 API

2018년 3월

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

  1. 운영자가 GTAF에 대한 혜택 판매 정보를 사용자 기기로 더 아래로 푸시할 수 있도록 하는 새로운 API 호출이 도입되었습니다. 이러한 새 호출을 통해 운영자가 Google에 혜택을 푸시할 수 있습니다.
  2. PlanGroup에 마지막으로 업데이트된 시간 필드를 도입합니다.
  3. 가변 기간에 데이터 크레딧 비율 필드가 삭제됩니다.