Display & Video 360 API는 여러 오류와 경고로 응답할 수 있습니다. 정상적인 API 솔루션은 이러한 오류를 처리해야 합니다.
API 오류
의도한 작업을 수행하지 못하는 API 요청은 오류를 반환합니다. 오류 응답을 포착하여 처리해야 합니다.
API 오류 응답에는 HTTP 응답 코드, 오류 메시지, Google RPC 코드 상태가 있습니다. 형식은 다음과 같습니다.
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
다음은 일반적인 API 오류와 권장 조치 목록입니다.
| 오류 코드 | |
|---|---|
400 |
INVALID_ARGUMENT요청에 문제가 있습니다. 오류 응답의 메시지 필드를 검토하고 요청을 그에 따라 업데이트합니다. |
401 |
UNAUTHENTICATED요청을 적절하게 인증할 수 없습니다. 요청에 유효한 OAuth 사용자 인증 정보가 포함되어 있는지 확인합니다. 자세한 내용은 빠른 시작 가이드를 참고하세요. |
403 |
PERMISSION_DENIED요청을 완료하는 데 필요한 권한이 없습니다. 사용자 계정에 관련 파트너 또는 광고주에 대한 적절한 권한이 있는지 확인합니다. |
404 |
NOT_FOUND가져오려는 리소스를 찾을 수 없습니다. 사용 중인 ID가 올바르고 검색 중인 리소스 유형에 해당하는지 확인합니다. |
409 |
ABORTED수정하려는 리소스가 다른 곳에서 수정되고 있습니다. 몇 초 정도 기다린 후 요청을 다시 시도합니다. |
429 |
RESOURCE_EXHAUSTED비율 제한 또는 일일 요청 할당량을 초과했습니다. Google Cloud 콘솔을 사용하여 API 사용량을 검사합니다. 기존 할당량 한도 내에서 실행되도록 워크플로를 업데이트합니다. 자세한 내용은 사용량 최적화 가이드를 참고하세요. |
500 |
INTERNALAPI에 내부 오류가 발생했습니다. 몇 초 정도 기다린 후 요청을 다시 시도합니다. 오류가 계속되면 지원팀에 문의하세요. |
504 |
DEADLINE_EXCEEDEDAPI가 요청을 완료하는 데 너무 오래 걸렸습니다. 몇 초 정도 기다린 후 요청을 다시 시도합니다. 오류가 계속되면 지원팀에 문의하세요. |
SDF 오류
Display & Video 360 API는 장기 실행 작업을 사용하여 구조화된 데이터 파일(SDF)을 생성합니다. SDF 생성의 오류는 완료된 operation에 반환됩니다. error 필드에 세부정보가 포함됩니다.
다음과 같이 잘린 예를 참고하세요.
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
오류 메시지가 명확하지 않은 경우 다음을 권장합니다.
- 사용자에게 상위 파트너 또는 광고주에 대한 일반 사용자 역할이 하나 이상 있는지 확인합니다.
- 필터에 제공된 ID가 정확한지 확인합니다. ID는 의도한 리소스 유형과 일치해야 하며 루트 ID의 하위 리소스여야 합니다.
- 사용자에게 동시 SDF 다운로드 작업이 20개 미만인지 확인합니다.
오류가 계속 표시되면 지원팀에 문의하세요.
차단하지 않는 경고
차단되지 않는 경고는 광고 항목의 광고 게재에 영향을 줄 수 있는 문제를 나타냅니다. UI에도 유사한 경고가 표시됩니다. 이러한 경고는 수동적이며 광고 항목에 나열됩니다.
경고의 근본 원인은 광고 항목의 게재에 영향을 미칠 수 있습니다. 경우에 따라 광고 게재가 완전히 중단될 수도 있습니다.
예방
차단되지 않는 일부 경고는 광고 항목의 잘못된 구성으로 인해 발생합니다.
- 게재 기간: 게재 기간이 유효하지 않거나 게재 신청서의 게재 기간이 만료된 경우 광고 항목에서 광고가 게재되지 않습니다. 광고 항목의 게재 기간이 게재 신청서의 게재 기간 내에 있는지 확인합니다.
- 할당된 광고 소재: 유효한 광고 소재가 광고 항목에 할당되지 않으면 광고 항목이 게재될 수 없습니다.
- 타겟팅: 광고 항목의 타겟팅이 올바르게 할당되지 않으면 광고 게재가 영향을 받거나 완전히 중단될 수 있습니다.
새 광고 항목에서 기존 광고 항목의 구성을 사용하기 전에 기존 광고 항목에서 경고가 생성되지 않는지 확인하세요.
모니터링
광고 항목이 게재되는 동안 차단되지 않는 경고가 표시될 수 있습니다. 활성 광고 항목에 새로운 경고가 있는지 모니터링하여 광고가 올바르게 게재되는지 확인하세요.
list 요청으로 광고 항목을 일괄적으로 가져옵니다. 광고 항목에서 예기치 않은 경고가 반환되면 게재에 미치는 영향을 줄이기 위해 최대한 빨리 문제를 해결하세요.
설정이나 타겟팅이 변경되지 않았더라도 경고가 추가될 수 있습니다. 예를 들면 다음과 같습니다.
- 게재 신청서가 일시중지되거나 만료됩니다.
- 사용자 목록 또는 타겟팅 옵션이 지원 중단되었습니다.