CMS API 오류 메시지 참조

CMS API에서 반환한 오류 메시지에 대한 참조입니다. 참조 Dynamic Ingest API에 대한 오류 메시지 참조 , 이는 다음과 함께 사용됩니다. CMS API비디오를 수집하기 위해.

일반 오류 메시지

상태 이름 메시지 원인
400 BAD_REQUEST ILLEGAL_PATH: A request for more than 10 videos is not supported 기본GET /videos/video_ids요청은 10개 이상의 동영상을 요청할 수 없습니다.
400 INVALID_SORT Attempted to sort by invalid property: '[property name]' sort매개변수가 유효하지 않거나 존재하지 않는 필드를 가리켰습니다.
400 INVALID_SEARCH Search string was invalid 검색 문자열 구문이 잘못되었거나 검색 문자열을 URIEncode하지 못했습니다.
400 ILLEGAL_QUERY There was a problem with the query string 검색 문자열 구문이 잘못되었습니다. 예: 1) 쉼표로 끝나거나 닫히지 않은 따옴표가 있는tags검색 수행
400 BAD_VALUE Unrecognized field in the submitted data 맞춤법 오류 또는 존재하지 않는 필드의 다른 사용
400 AD_CONFIG_NOT_FOUND Ad config not found SSAI 요청에 지정된 광고 구성을 찾을 수 없습니다.
400 AD_CONFIG_INACTIVE Ad config is inactive SSAI 요청에 지정된 광고 구성이 비활성 상태입니다.
400 REFERENCES_EXIST This video is referenced by at least one playlist. 하나 이상의 재생 목록에 포함 된 동영상을 삭제하려고합니다.
400 SHARED_VIDEO Delete of shared video failed. 공유 비디오 삭제는 아직 지원되지 않습니다.
401 UNAUTHORIZED Permission denied. OAuth 액세스 토큰이 없거나 잘못되었습니다. 액세스 토큰을 제공 한 경우이 요청에 대한 적절한 범위가 없을 수 있습니다.
403 NOT_AVAILABLE Resource is not available. 요청한 리소스를 일시적으로 사용할 수 없습니다. 비디오 처리가 진행 중일 때 일시적인 조건일 수 있지만 메시지가 지속되면 지원 센터에 문의하십시오.
404 RESOURCE_NOT_FOUND Resource does not exist. 존재하지 않는 리소스를 요청하셨습니다. 경로 항목의 맞춤법을 확인하세요.
405 METHOD_NOT_ALLOWED The HTTP method used for the request is not allowed for this resource 가장 일반적인 원인은 PUT, POST, PATCH 또는 DELETE를 읽기 전용 리소스로 보내는 것입니다.
406 NOT_ACCEPTABLE The HTTP Accept header has a value not allowed. Accept헤더에는 값이 있어야 합니다application/json . 와 같은 값을 입력하지 application/x-www-form-urlencoded않으면 이 오류와 함께 요청이 거부됩니다.
409 LIVE_VIDEOS_NOT_SHAREABLE This video cannot be shared because it is live. 라이브 스트리밍 비디오와 그로부터 생성 된 클립은 공유 할 수 없습니다.
409 REFERENCE_ID_IN_USE Reference id is already in use. 이미 사용중인 참조 ID로 동영상을 만들거나 다른 동영상에서 이미 사용중인 동영상에 참조 ID를 추가하려고했습니다.
409 CONCURRENT_UPDATE Update failed because of another update at the same time. Please try again. 별도의 API 요청, Studio 사용자 또는 일부 시스템 프로세스가 현재 동영상을 업데이트하고 있습니다. 이는 동일한 비디오에 대한 API 업데이트 요청을 비동기식으로 빠르게 연속적으로 수행하는 경우에도 발생할 수 있습니다.
409 CONFLICT Reference id is already in use. 참조 ID의 고유성을 보장하기 위해 참조 ID와 관련된 작업은 최대 3 분 동안 ID를 잠급니다. 즉, 참조 ID를 만들거나 변경하는 요청을 한 다음 해당 참조 ID를 사용하는 다른 요청을 즉시 수행하면 작업이 409 오류와 함께 실패합니다. 여기에는 다음이 포함됩니다. 1) 동영상을 삭제 한 다음 다른 동영상에 참조 ID를 할당하려고합니다. 2) 503 (서비스를 사용할 수 없음) 오류와 함께 실패한 새 비디오를 만들고 동일한 요청을 다시 시도합니다.

이 오류가 발생한 후 작업을 다시 시도하기 전에 3 분 이상 기다리십시오. 참조 ID를 사용하여 비디오를 만들려고 시도했지만 시도가 실패하면 (참조 ID와 관련이 없는 이유로) 해당 참조 ID가 30초 동안 잠기고 반복 동영상 만들기 시도는 참조 ID가 잠금 해제될 때까지 충분히 오래 기다릴 때까지 실패합니다.

409 CONFLICT Both accounts must be enabled for media sharing. 마스터 계정에서 미디어 공유를 위해 채널에 제휴 계정을 추가하려는 경우계정 모두 미디어 공유를 활성화해야 합니다.
409 UNSUPPORTED_MEDIA_TYPE   요청에 헤더가 누락되었을 가능성이 큽니다Content-Type: application/json .
415 SHARING_DISABLED Master account is not enabled for media sharing. 미디어 공유가 활성화되지 않은 계정에서 비디오를 공유하려고하면이 오류가 반환됩니다.
422 ILLEGAL_FIELD Unrecognized field in the submitted data 맞춤법 오류 또는 존재하지 않는 필드의 다른 사용
422 VALIDATION_ERROR (JSON 데이터가 유효하지 않음-오류 메시지는 문제에 따라 다릅니다) 메시지 예시:
  • 이름: REQUIRED_FIELD (이름없이 동영상 만들기, 이름을 빈 문자열로 업데이트)
  • 계정 ID: WRONG_ACCOUNT   (URL의 계정 ID가 JSON의 계정 ID와 일치하지 않음)
  • 잘못된 키: id (id는 수정할 수 없으며 JSON에서 키로 표시되어서는 안 됨)
429 TOO_MANY_REQUESTS Too many requests 동시 요청이 너무 많거나 초당 너무 많은 요청을 제출하고 있습니다.
500 UNKNOWN an unknown internal error occurred 브라이트코브 시스템의 문제 - 나중에 다시 시도하십시오.
503 SERVICE_UNAVAILABLE The API is temporarily unavailable 백엔드 문제 - 나중에 다시 시도하십시오.
504 TIMEOUT something took too long 서버 사용량이 너무 많을 수 있습니다. 나중에 다시 시도하십시오.

미디어 공유 오류

미디어 공유 오류는 API 요청에 대한 별도의 오류 응답으로 반환되지 않고 일반 응답의error_message필드에 반환됩니다.

  [
  {
  "video_id" : "394872349182374",
  "affiliate_id" : "234987239487",
  "affiliate_video_id" : "30308254055202",
  "status" : "COMPLETE",
  "shared_at" : "2017-12-11T17:57:45.530Z",
  "updated_at" : "2017-12-11T18:03:32.789Z",
  "error_message" : "[{"error_code":"MISSING_CUSTOM_FIELDS","error_message":"Affiliate account is missing custom fields: [whisky]"}]"
  }
  ]
  
  

error_message json은 오류 객체의 배열이고 객체에는error_code및 가error_message있습니다.

error_code

오류 코드는 일반적으로 공유와 관련이 있지만 비디오의 PATCH (업데이트) 작업에서 반환 할 수있는 유효한 오류 코드 일 수도 있습니다. 공유 특정 오류 코드는 아래 표에 나와 있습니다.

미디어 공유 오류 코드
error_code error_message 원인
MISSING_CUSTOM_FIELDS Affiliate account is missing custom fields: [field1, field2] 마스터가enforce_custom_fieldstrue설정되었지만 공유 중인 동영상은 제휴 계정에 없는 필드를 참조합니다.
CONFLICT Affiliate account is not configured for geo restriction. 마스터는 forced_geo를 true로 설정하고 해당 계정은 지리적 필터링을 위해 구성되었지만 제휴 계정은 지리적 필터링을 위해 구성되지 않았습니다.
SHARING_DISABLED Affiliate account is not enabled for media sharing. 마스터가 미디어 공유가 활성화되지 않은 제휴사와 비디오를 공유하려고했습니다.
NOT_FOUND Resource does not exist. 뭔가 빠졌습니다. 일반적으로 이것은 마스터 비디오가 사라 졌음을 의미합니다. 이것은 마스터 비디오 삭제 후 즉시 공유 요청이 나타나면 발생할 수 있습니다. 이는 또한 마스터 계정에 아직 채널이 없거나 제휴 계정이 존재하지 않거나 채널의 유효한 회원이 아닌 경우를 의미 할 수 있습니다. CMS API미디어 공유로 마이그레이션하는 중에 문제가 발생한 경우 이런 일이 발생할 수 있습니다.
UNKNOWN Sharing failed with an unknown error, error_id INSERT-UNIQUE-ERROR-ID 예상치 못한 일이 발생했습니다. error_message에는 Devops에서 근본적인 원인을 식별하는 데 사용할 수 있는 오류 ID가 포함됩니다. 공유 시도를 다시 시도하면 대부분의 경우 작동합니다.
VALIDATION_ERROR {field}: ILLEGAL_VALUE {field}가 "economics"인 경우 문제는 마스터 비디오가 "AD SUPPORTED"이지만 제휴 계정에 광고가 활성화되어 있지 않다는 것입니다. 또한 광고에 대해 계정이 비활성화 된 경우 비공유 비디오의 비디오 메타 데이터에서 지원되는 광고로 광고를 설정 한 경우에도 발생합니다. {field}가 다른 경우 조사가 필요합니다.
REFERENCE_ID_IN_USE Reference id whatever-you-used is already in use. 참조 ID는 마스터 계정에서 유효했지만 이미 제휴 계정에서 사용 중입니다.