Google Ads API에 요청을 보낼 때 다양한 이유로 요청이 실패할 수 있습니다. 예를 들어 잘못된 인수를 제공하거나 계정에서 새 캠페인 생성 한도에 도달했을 수 있습니다. 이러한 경우 API는 오류를 반환하여 문제가 무엇인지 알려줍니다.
이 가이드에서는 API 오류를 읽고 처리하여 더 강력한 애플리케이션을 빌드하는 방법을 설명합니다.
오류 구조
클라이언트 라이브러리 중 하나를 사용하는 경우 API 오류가 예외로 표시됩니다. 이러한 예외에는 오류가 발생한 이유를 파악하는 데 도움이 되는 세부정보가 포함되어 있습니다.
Google Ads API는 표준 형식으로 오류 정보를 반환합니다. 오류가 발생하면 응답에 GoogleAdsFailure 객체가 포함됩니다. 이 객체에는 개별 GoogleAdsError 객체 목록이 포함되어 있으며 각 객체는 특정 오류를 자세히 설명합니다.
각 GoogleAdsError 객체는 다음을 제공합니다.
error_code: 오류 유형을 알려주는 특정 오류 코드입니다(예:AuthenticationError.NOT_ADS_USER).message: 오류가 발생한 이유에 대해 사람이 읽을 수 있는 설명입니다.trigger: 오류를 일으킨 값입니다(예: '1234').location: 요청의 어느 부분이 오류를 일으켰는지에 관한 세부정보입니다(예: 특정 필드 이름).
오류 목록 외에도 GoogleAdsFailure에는 오류가 발생한 API 요청의 고유 식별자인 requestId이 포함됩니다.
오류 예시
다음은 JSON 형식의 오류 예시입니다. 이 오류는 색인 0의 ad_group에 있는 name 필드가 요청에서 누락되었음을 나타냅니다.
{
"code": 3,
"message": "Request contains an invalid argument.",
"details": [
{
"@type": "type.googleapis.com/google.ads.googleads.v22.errors.GoogleAdsFailure",
"errors": [
{
"errorCode": {
"requestError": "REQUIRED_FIELD_MISSING"
},
"message": "Required field is missing",
"location": {
"fieldPathElements": [
{
"fieldName": "ad_group",
"index": 0
},
{
"fieldName": "name"
}
]
}
}
],
"requestId": "unique_request_id_12345"
}
]
}
오류 처리 방법
오류가 발생하면 다음 단계를 따르세요.
errors목록 검사:GoogleAdsFailure객체에서 각GoogleAdsError을 살펴봅니다.error_code및message을 통해 어떤 문제가 발생했는지 알 수 있습니다.location확인:location필드를 사용하면 요청에서 문제가 발생한 위치를 정확하게 파악할 수 있습니다.- 문서 참고: 특정 오류 코드의 경우 일반적인 오류 페이지 또는 전체 오류 코드 참조에서 오류 및 오류 수정 방법에 관한 자세한 내용을 확인하세요.
- 요청 조정: 오류 메시지에 따라 API 요청을 수정합니다. 예를 들어
REQUIRED_FIELD_MISSING이 표시되면 요청에 해당 필드를 제공해야 합니다. request_id로깅: 오류를 해결하는 방법을 알 수 없어 포럼을 통해 지원팀에 문의해야 하는 경우request_id를 포함하세요. 이 ID는 Google 엔지니어가 문제를 조사하는 데 도움이 됩니다.