Display & Video 360 API를 사용할 때 오류가 발생할 수 있는 시나리오는 다양합니다. 이러한 오류는 코드의 버그, 잘못된 사용자 입력 또는 API 자체의 문제와 관련이 있을 수 있습니다. 이유가 무엇이든 오류를 해결하는 방법을 아는 것은 개발 프로세스에서 중요한 부분입니다. 이 가이드에서는 시작하는 데 도움이 되는 몇 가지 권장사항을 제공합니다.
기본사항 검토
- 기본 요건 가이드를 검토합니다. Display & Video 360 및 올바르게 구성된 API 프로젝트에 액세스할 수 있는지 확인합니다.
- 응답에 HTTP 오류가 포함된 경우 이를 신중하게 검토하고 올바른 API 및 서비스에 요청이 이루어지고 있는지 확인합니다.
- 승인 가이드를 검토합니다. 요청에 필요한 OAuth 2.0 사용자 인증 정보가 포함되어 있는지 확인합니다.
올바른 사용자 인증 정보를 사용하고 있는지 확인합니다. 인증 사용자 인증 정보 생성에 관한 자세한 내용은 애플리케이션 설정 가이드를 참고하세요. 액세스 토큰을 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 객체의 콘텐츠에는 문제가 무엇인지 식별하는 데 도움이 되는 충분한 정보가 포함됩니다. 그렇지 않은 경우 오류의 의미를 파악하기 위해 추가 조사를 해야 할 수 있습니다.
오류 조사
가장 자주 발생하는 오류에 관한 세부정보가 나와 있는 일반적인 오류 섹션을 참고하세요.
일반적인 오류 섹션에 해당 오류가 포함되어 있지 않으면 참조 문서를 참고하여 오류 코드, 상태, 메시지를 검색해 보세요.
문서화되지 않은 오류가 발견되면 알려주세요.
근본 원인 파악
이제 오류를 파악하고 그 의미를 이해했습니다. 그렇지 않은 경우 오류 이해하기로 돌아가거나 직접 해결할 수 없는 API 오류가 발생했다고 생각되면 도움말 확인으로 이동하세요.
오류를 수정하려면 먼저 오류의 원인을 파악해야 합니다. 이는 코드의 버그나 잘못된 입력 값인 경우가 많습니다.
문제가 코드의 버그와 관련이 있는지 확인하려면 먼저 코드가 의도한 대로 작동하는지 확인해야 합니다. 첫 번째 단계로, 실패하는 요청을 실행하는 코드 섹션을 검토하여 명백한 문제를 확인해 보세요. 경우에 따라 디버깅 도구를 사용하여 코드를 한 줄씩 단계별로 살펴보고 올바르게 작동하는지 확인해야 할 수 있습니다.
HTTP 요청을 검사하는 것도 잠재적인 버그와 잘못된 입력 사례를 식별하는 데 유용한 방법입니다. 많은 공식 클라이언트 라이브러리를 HTTP 요청 및 응답을 로깅하도록 구성할 수 있습니다. 자세한 내용은 사용 중인 라이브러리의 문서를 참고하세요. Charles, Squid, Fiddler와 같은 HTTP 프록시를 사용하여 요청 및 응답 로그를 캡처할 수도 있습니다. 이러한 로그를 가져온 후 로그를 검토하여 애플리케이션에서 제공하는 요청 매개변수 값이 올바르고 예상과 일치하는지 확인합니다.
오류를 일으킨 버그 또는 잘못된 입력을 파악하면 해결 방법이 명확해질 것입니다. 문제가 해결되지 않거나 문제를 해결하는 가장 좋은 방법을 잘 모르겠다면 지금까지 수집한 정보를 사용하여 도움을 받을 수 있습니다.
도움 받기
오류를 직접 해결할 수 없는 경우 Display & Video 360 고객센터에 있는 이 양식을 통해 지원팀에 문의할 수 있습니다.
이 양식을 작성할 때는 발생한 문제와 이미 취한 문제 해결 단계에 관한 정보를 최대한 많이 포함해야 합니다. 포함할 유용한 정보:
- HTTP 요청 및 응답 로그 OAuth 2.0 액세스 토큰, 이메일 주소와 같은 민감한 정보는 삭제해야 합니다.
- 코드 스니펫 문제를 코드의 특정 섹션으로 분리할 수 있거나 문제가 언어별 문제라고 생각되면 수행 중인 작업을 보여주는 작은 스니펫을 포함하세요.
- 문제를 재현하려는 다른 사용자에게 유용할 수 있는 추가 정보(예: 런타임/인터프리터 버전 및 플랫폼)
문제 해결
문제의 원인을 파악하고 해결 방법을 찾았다면 이제 수정사항을 구현할 차례입니다. 가능하면 프로덕션에 배포하기 전에 제어된 환경 (예: 테스트용으로 구성된 파트너 또는 광고주)에서 다양한 유효한 입력과 잘못된 입력에 대해 수정사항을 테스트합니다.