오류 사례

다음 섹션에서는 모바일 데이터 요금제 공유 API가 호출자에게 오류를 반환하는 가장 일반적인 시나리오를 강조합니다. 오류가 계속되면 mdp-support@google.com에 문의하여 지원을 받고 호출되는 URL과 요청 본문을 공유하세요.

HTTP 404 찾을 수 없음

HTTP 404 오류가 발생하는 가장 일반적인 이유는 GTAF가 알림을 전송해야 하는 사용자의 GCM 토큰을 찾을 수 없는 경우입니다. 이는 기기가 GTAF에 CPID와 연결된 GCM 토큰을 등록할 기회를 얻지 못했거나 등록에 실패한 경우에 발생합니다. 기기가 GTAF의 사전 프로덕션 인스턴스에 등록되어 있고 알림이 GTAF의 프로덕션 인스턴스로 전송되는 경우에도 발생할 수 있습니다.

이 오류를 진단하려면 다음 단계를 따르세요.

  1. MDP UI가 기기에 성공적으로 로드되는지 확인합니다.
  2. 호출의 경로 매개변수와 쿼리 매개변수가 URL로 인코딩되어 있는지 확인합니다.
  3. 사전 프로덕션 (preprod-mobiledataplansharing.googleapis.com) 및 프로덕션 엔드포인트 (mobiledataplansharing.googleapis.com)를 모두 시도합니다.

HTTP 400 잘못된 요청

이 오류는 GTAF에 전송된 요청의 본문이 잘못된 경우 발생합니다. 가장 일반적인 시나리오는 다음과 같습니다.

  1. PlanStatus의 updateTime이 제공되지 않거나 미래입니다.
  2. PlanStatus의 expireTime이 제공되지 않았거나 과거입니다.
  3. userKey 쿼리 매개변수가 누락되었습니다.
  4. 알림을 구성하는 데 필요한 모든 필드가 없습니다. 알림을 트리거하는 방법에 관한 자세한 내용은 알림 가이드라인을 참고하세요.

HTTP 409 충돌

캐시에 있는 PlanStatus가 요청에서 전송되는 것보다 최신인 경우 (즉, updateTime이 최신인 경우) GTAF는 이 오류를 호출자에게 반환합니다. 로그를 확인하여 이 사용자에 대해 PlanStatus가 푸시되었는지 확인하세요.

HTTP 403 금지됨

호출자가 URL에 사용된 특정 ASN에 대해 모바일 데이터 요금제 공유 API를 호출할 권한이 없는 경우 GTAF는 이 오류를 반환합니다. 이 오류를 진단하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔 API 라이브러리에서 API가 사용 설정되어 있는지 확인합니다.
  2. 호출에 사용되는 서비스 계정이 이동통신사의 ISP 포털에 추가되었습니다.