2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은 지원 중단 페이지를 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

오류 및 경고

이 페이지에서는 Display & Video 360 API를 사용할 때 발생할 수 있는 다양한 유형의 오류 및 경고를 설명합니다.

API 오류

완료할 수 없는 API 요청은 오류 메시지를 반환합니다. 오류를 반환하는 요청은 사용자 할당량에 반영되며 추가 할당량 요청을 검토할 때 고려됩니다. 향후 오류를 방지하려면 오류 응답을 처리해야 합니다.

오류 응답은 다음 형식을 따르며 HTTP 응답 코드, 오류 메시지, Google RPC 코드 상태를 포함합니다.

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

다음은 일반적인 API 오류 목록과 이러한 오류가 반환될 때 취해야 하는 권장 조치입니다.

코드	RPC	권장 작업
`400`	`INVALID_ARGUMENT`	요청에 문제가 있습니다. 오류 응답의 메시지 필드를 검토하고 그에 따라 요청을 수정합니다.
`401`	`UNAUTHENTICATED`	요청을 제대로 인증할 수 없습니다. 요청에 유효한 OAuth 사용자 인증 정보를 포함하고 있는지 확인합니다. 자세한 내용은 시작 가이드를 참고하세요.
`403`	`PERMISSION_DENIED`	요청을 완료하는 데 필요한 권한이 없습니다. 사용자 계정에 관련 파트너 또는 광고주에 대한 적절한 권한이 있는지 확인합니다.
`404`	`NOT_FOUND`	가져오려는 리소스를 찾을 수 없습니다. 사용 중인 ID가 올바르고 검색 중인 리소스 유형에 맞는지 확인합니다.
`409`	`ABORTED`	수정하려는 리소스가 다른 곳에서 수정되고 있습니다. 몇 초 정도 기다린 후 요청을 다시 시도합니다.
`429`	`RESOURCE_EXHAUSTED`	비율 한도 또는 일일 요청 한도를 초과했습니다. Google API 콘솔을 사용하여 API 사용량을 검사하고 기존 할당량 한도 내에서 작동하도록 워크플로를 수정합니다. 자세한 내용은 할당량 최적화 페이지를 참고하세요.
`500`	`INTERNAL`	API에 내부 오류가 발생했습니다. 몇 초 정도 기다린 후 요청을 다시 시도합니다. 오류가 계속되면 지원팀에 문의하세요.
`504`	`DEADLINE_EXCEEDED`	API가 요청을 완료하는 데 시간이 너무 오래 걸렸습니다. 몇 초 정도 기다린 후 요청을 다시 시도합니다. 오류가 계속되면 지원팀에 문의하세요.

SDF 오류

Display & Video 360 API는 구조화된 데이터 파일 (SDF)을 생성하고 다운로드하는 데 비동기 메서드를 사용합니다. 따라서 SDF 생성 중에 발생한 오류는 완료된 SDF 다운로드 작업에서 반환됩니다. error에서 완료되는 SDF 다운로드 작업은 완료된 것으로 표시되지만, 잘린 예와 같이 response 필드에 미디어 리소스 이름 대신 채워진 오류 필드가 있습니다.

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

SDF를 생성하려고 할 때 조치 가능한 오류 메시지가 표시되면 그에 따라 조치를 취해야 합니다. 오류 메시지로 명확하게 조치를 취할 수 없는 경우 다음 조치를 취하는 것이 좋습니다.

사용자에게 상위 파트너 또는 광고주 리소스에 대한 적절한 권한이 있는지 확인합니다.
필터에 제공된 ID가 정확하고 의도한 리소스 유형과 일치하며 지정된 루트 ID의 컨텍스트 내에 있는지 확인합니다.
사용자당 동시 SDF 다운로드 작업 20개 제한을 초과하지 않아야 합니다.

그래도 오류가 발생하면 지원팀에 문의하여 문제를 신고하세요.

차단하지 않는 경고

비차단형 경고는 광고 항목의 게재에 영향을 줄 수 있는 문제를 나타내기 위해 광고 항목에 할당됩니다. 이와 유사한 경고는 알림 배너를 통해 UI에 전달됩니다. 이러한 경고는 수동적이며 광고 항목의 warningMessages 필드에 표시됩니다.

이러한 경고를 유발하는 문제는 수동적이지만 광고 항목의 게재에 영향을 미쳐 게재를 완전히 차단할 수도 있습니다.

예방

다음을 비롯한 광고 항목 설정을 올바르게 구성하면 비차단 경고를 유발하는 많은 문제를 방지할 수 있습니다.

게재 기간: 광고 항목의 게재 기간이 유효하지 않거나 상위 게재 신청서의 게재 기간이 만료된 경우 광고 항목에 경고가 표시되고 광고가 게재되지 않습니다. 후자의 문제를 방지하려면 광고 항목의 게재 기간이 상위 게재 신청서의 게재 기간보다 늦게 종료되지 않도록 하세요.
할당된 광고 소재: 광고 항목에 유효한 광고 소재가 할당되지 않은 경우 광고 항목에 경고가 표시되고 광고가 게재되지 않습니다.
타겟팅: 광고 항목의 타겟팅이 올바르게 할당되지 않으면 광고 항목에 경고가 표시되고 게재가 영향을 받거나 완전히 차단될 수 있습니다.

기존 광고 항목에서 구성을 복제하는 경우 기존 광고 항목에서 예상치 못한 경고가 발생하지 않는지 확인합니다.

모니터링

광고 항목이 실행되는 동안 차단하지 않는 경고를 유발하는 문제가 발생할 수 있습니다. 광고 항목이 올바르게 게재되는지 확인하려면 활성 광고 항목에서 새로 생성된 경고를 모니터링하세요. advertisers.lineItems.list 함수를 사용하여 광고 항목을 일괄적으로 가져올 수 있습니다. 광고 항목에서 예기치 않은 경고가 발생하는 경우 게재에 미치는 영향을 줄이기 위해 즉시 문제를 해결해야 합니다.

광고 항목의 설정이나 타겟팅이 변경되지 않았더라도 문제가 발생할 수 있습니다. 상위 게재 신청의 일시중지 또는 만료, 사용자 목록 또는 기타 타겟팅의 지원 중단 등이 여기에 해당합니다.