문제 해결

Display & Video 360 API로 작업할 때 오류가 발생할 수 있는 시나리오는 많이 있습니다. 이는 코드의 버그, 잘못된 사용자 입력 또는 API 자체의 문제와 관련이 있을 수 있습니다. 이유가 무엇이든, 오류를 해결하는 방법을 아는 것은 개발 프로세스에서 중요한 부분입니다. 이 가이드에서는 시작하는 데 도움이 되는 몇 가지 권장사항 팁을 제공합니다.

기본사항 검토

  1. 기본 요건 가이드를 검토합니다. Display & Video 360 및 올바르게 구성된 API 프로젝트에 액세스할 수 있는지 확인하세요.
  2. 응답에 HTTP 오류가 포함되어 있으면 오류를 주의 깊게 검토하고 요청이 올바른 API 및 서비스에 전달되는지 확인하세요.
  3. 승인 가이드를 검토합니다. 요청에 필요한 OAuth 2.0 사용자 인증 정보가 포함되어 있는지 확인하세요.
  4. 올바른 사용자 인증 정보를 사용하고 있는지 확인합니다. 사용자 인증 정보 생성에 대한 자세한 내용은 애플리케이션 설정 가이드를 참조하세요. 액세스 토큰을 Google OAuth2 API의 tokeninfo 엔드포인트에 전달하여 올바른 API 프로젝트로 발급되고 올바른 범위에 대해 승인되었는지 확인할 수도 있습니다.

    POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}
    
    200 OK
    
    {
     "issued_to": "{API_PROJECT_CLIENT_ID}",
     "audience": "...",
     "scope": "{API_SCOPES}",
     "expires_in": ...
    }
    

오류 이해하기

API에 오류가 발생하면 일반적으로 error 객체가 포함된 JSON 응답을 반환합니다. 이 객체는 발생한 특정 오류에 대한 추가 컨텍스트를 제공합니다.

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

일반적으로 error 객체의 콘텐츠에는 문제를 식별하는 데 도움이 되는 충분한 정보가 포함됩니다. 그렇지 않은 경우 오류의 의미를 파악하기 위해 몇 가지 추가 조사를 해야 할 수 있습니다.

오류 조사

  1. 가장 자주 발생하는 일부 오류에 대한 세부정보를 제공하는 일반적인 오류 섹션을 참고하세요.

  2. 일반적인 오류 섹션에서 오류를 다루지 않는다면 참조 문서를 참조하여 오류 코드, 상태, 메시지를 검색해 보세요.

  3. 문서화되지 않은 오류가 발생하면 Google에 알려주세요.

근본 원인 파악

이제 오류를 식별하고 그 의미를 이해했습니다. 그렇지 않은 경우 오류 이해하기로 돌아가거나 API에서 직접 해결할 수 없는 오류를 발견했다고 생각되면 도움말 확인으로 이동하세요.

오류를 해결하려면 먼저 문제의 원인을 파악해야 합니다. 이는 코드의 버그나 잘못된 입력 값인 경우가 많습니다.

문제가 코드의 버그와 관련이 있는지 확인하려면 먼저 코드가 의도한 대로 작동하는지 확인해야 합니다. 첫 번째 단계로, 실패한 요청을 실행하는 코드 섹션을 검토하여 명백한 문제가 있는지 확인하는 것이 좋습니다. 경우에 따라 디버깅 도구를 사용하여 코드가 올바르게 작동하는지 한 줄씩 단계별로 실행해야 할 수 있습니다.

HTTP 요청 검사는 잠재적인 버그와 잘못된 입력 사례를 식별하는 또 다른 유용한 방법입니다. 대부분의 공식 클라이언트 라이브러리는 HTTP 요청 및 응답을 로깅하도록 구성할 수 있습니다. 자세한 내용은 선택한 라이브러리의 문서를 참조하세요. Charles, Squid, Fiddler와 같은 HTTP 프록시를 사용하여 요청 및 응답 로그를 캡처할 수도 있습니다. 이러한 로그를 얻은 후에는 이를 검토하여 애플리케이션에서 제공하는 요청 매개변수 값이 올바르고 예상과 일치하는지 확인하세요.

오류를 일으킨 버그나 잘못된 입력을 파악했다면 해결 방법이 명확할 것입니다. 잘 모르겠거나 문제를 가장 잘 해결하는 방법을 잘 모르겠다면 지금까지 수집한 정보를 활용하여 도움을 받을 수 있습니다.

지원 받기

오류를 직접 해결할 수 없는 경우 Display & Video 360 고객센터에 있는 이 양식을 통해 지원팀에 문의할 수 있습니다.

이 양식을 작성할 때는 발생한 문제와 이미 시도한 문제 해결 단계에 관한 정보를 최대한 많이 포함해야 합니다. 다음과 같은 유용한 정보를 포함해야 합니다.

  • HTTP 요청 및 응답 로그 OAuth 2.0 액세스 토큰, 이메일 주소 등 민감한 정보는 수정해야 합니다
  • 코드 스니펫 문제를 코드의 특정 섹션으로 분리할 수 있거나 언어와 관련된 문제라고 의심되면 현재 진행 중인 작업을 보여주는 작은 스니펫을 포함합니다.
  • 런타임/인터프리터 버전 및 플랫폼 같은 추가 정보. 문제를 재현하려는 다른 사용자에게 유용할 수 있습니다.

문제 해결

문제의 원인을 파악하고 해결책을 제시했다면 이제 해결 방법을 실행할 차례입니다. 가능하면 프로덕션에 배포하기 전에 통제된 환경 (예: 테스트를 위해 특별히 구성된 파트너 또는 광고주)에서 좋은 입력과 잘못된 입력 범위 모두에 대해 수정사항을 테스트합니다.