오류 및 경고

이 페이지에서는 발생할 수 있는 다양한 유형의 오류 및 경고에 관해 설명합니다. Display &Video 360을 사용할 때 발생하는 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 비율 제한 또는 일일 요청 할당량. 다음을 사용하여 API 사용량을 검사합니다. Google API 콘솔로 이동하여 기존 할당량 내에서 작동하도록 제한하기 때문입니다. 자세한 내용은 할당량 최적화를 참조하세요.

계정 내에서 작업을 완료할 수 없는 경우 일일 할당량을 지정하면 추가 할당량을 요청할 수 있습니다.

500 INTERNAL API에 내부 오류가 발생했습니다. 잠시만 기다려 주세요. 초 후 요청을 재시도합니다. 오류가 문제가 계속되면 지원팀에 문의하세요.
504 DEADLINE_EXCEEDED API가 요청을 완료하는 데 너무 오래 걸렸습니다. 몇 초 정도 기다린 후 요청을 다시 시도하세요. 만약 오류가 지속되는 경우 지원팀에 문의하세요.

SDF 오류

디스플레이 및 Video 360 API는 구조화된 데이터 파일 (SDF) 생성 및 다운로드 이 작업 SDF 생성 에 발생한 오류는 완료된 SDF에 반환됩니다. 다운로드 작업을 선택합니다. SDF 다운로드 작업이 error에 완료되는 경우 완료로 표시되지만 미디어 리소스 이름 대신 오류 필드가 채워져 있음 아래 예에 표시된 대로 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 함수를 사용하여 일괄적으로 처리합니다. 만약 광고 항목이 예기치 않은 경고를 생성하고 있다면 이 문제를 해결해야 합니다 즉시 사용을 중단하고 게재에 미치는 영향을 줄일 수 있습니다

광고 항목의 설정이나 타겟팅이 변경되지 않은 경우에도 문제가 발생할 수 있습니다. 예를 들어 상위 게재 신청서의 일시중지 또는 만료와 사용자 목록 또는 기타 타겟팅 지원 중단