개요: 소셜 신디케이션 API

오류 메시지

API 요청이 실패하면 오류 메시지가 반환됩니다. 오류 응답은 다음과 같습니다.

  [
    {
      "error_code" : "Application error code 1",
      "message" : "Application error message 1"
    }, {
      "error_code" : "Application error code 2",
      "message" : "Application error message 2"
    }
  ]

신디케이션 만들기

방법: POST

엔드포인트: /accounts/{account_id}/mrss/syndications

샘플 요청 본문:

  {
    "name": "my mp4 feed",
    "type": "mp4"
  }

name및type필드는 필수라는 점에 유의하십시오. 기타는 선택 사항입니다.

신디케이션 업데이트

방법: PATCH

엔드포인트: /accounts/{account_id}/mrss/syndications/{syndication_id}

샘플 요청 본문:

  {
    "name": "my new name"
  }

PATCH 요청에 대한 요청 본문은 ~ 아니다필드( type , id그리고syndication_url ).

신디케이션 삭제

방법: DELETE

엔드포인트: /accounts/{account_id}/mrss/syndications/{syndication_id}

계정에 대한 모든 신디케이션 가져 오기

방법: GET

엔드포인트: /accounts/{account_id}/mrss/syndications

특정 신디케이션 받기

방법: GET

엔드포인트: /accounts/{account_id}/mrss/syndications/{syndication_id}

범용 신디케이션을위한 템플릿 설정

방법: PUT

엔드포인트: /accounts/{account_id}/mrss/syndications/{syndication_id}/template

샘플 요청 본문:

  <feed header>My Feed Header</feed header>
  

위 템플릿은 다음과 유사한 피드를 생성합니다.

  <feed header>My Feed Header</feed header>
    <item>
      <title>Title for Video 1</title>
      <video_info>Description for Video 1</video_info>
    </item>
    <item>
      <title>Title for Video 2</title>
      <video_info>Description for Video 2</video_info>
    </item>

범용 신디케이션을위한 템플릿 가져 오기

방법: GET

엔드포인트: /accounts/{account_id}/mrss/syndications/{syndication_id}/template

신디케이션과 관련된 피드 가져 오기

피드 URL은 신디케이션syndication_url필드에서 가져오거나 수동으로 생성할 수 있습니다. 신디케이션 피드 API를 사용하여 인증 없이 피드를 검색할수도 있습니다.

방법: GET

엔드포인트: /accounts/{account_id}/mrss/syndications/{syndication_id}/feed

최상위 속성

신디케이션 필드에서 파생 됨

• album_art_url
• author
• category
• description
• destination_url
• explicit
• keywords
• name
• owner_name
• owner_email
• subtitle
• syndication_id
• syndication_url
• title

Video Cloud 계정 ID

• account_id

VideoCloud 기본 플레이어 페이지 URL 접두사

다음과 같이 사용하십시오.

  <media:player url="//default_default/index.html?videoId=">

• player_url

피드의 다음 페이지 URL

• next_page

카탈로그에서 검색된 비디오 자산 모음 (자세한 내용은 아래 참조)

• assets

자산 속성

자산 컬렉션의 리소스는 CMS Get Videos API 메서드에서 반환 된 비디오 리소스에서 파생되며 다음을 포함하되 이에 국한되지 않는 모든 동일한 속성이 지원됩니다.

• created_at
• description
• duration
• id
• images
• images.thumbnail
• images.poster
• long_description
• name
• original_filename
• published_at
• schedule
• state
• tags
• text_tracks
• updated_at

자산 리소스는 다음 속성도 지원합니다.

• sources (비디오 소스 모음-소스 속성은 다음 섹션 참조)
• digital_master (디지털 마스터가 없으면 비어 있음-디지털 마스터 속성은 아래 참조)
• best_mp4_source (최고 품질의 MP4 소스-MP4 소스가없는 경우 비어있을 수 있습니다. 속성은sources ) 에서 반환된 항목과 동일합니다.
• hls_source (HLS 소스를 반환-존재하지 않으면 비어 있음)
• best_dynamic_rendition_quality (동영상에 대해 동적 변환 메타 데이터를 가져온 경우 프레임 크기가 가장 큰 동영상의 동적 변환의 비디오 품질을 반환합니다. 허용되는 값은 "SD", "HD", "FHD"및 "UHD"입니다.)

소스 속성

자산에 대한 소스 컬렉션의 리소스는 CMS Get Video Sources API 메서드에서 반환 된 비디오 소스 리소스에서 파생됩니다. 다음 속성이 지원됩니다.

• app_name
• asset_id
• codec
• container
• created_at
• duration
• encoding_rate
• height
• size
• src
• stream_name
• type
• uploaded_at
• width

디지털 마스터 속성

자산의digital_master리소스는 CMS Get Digital Master Info API 메서드에서 반환된 디지털 마스터 리소스에서 파생됩니다. 다음 속성이 지원됩니다.

• duration
• encoding_rate
• height
• size
• url
• width

동적 변환 속성

자산의dynamic_renditions리소스는 CMS Get Digital Master Info API 메서드에서 반환된 동적 변환에서 파생됩니다. 다음 속성이 지원됩니다.

• rendition_id
• frame_height
• frame_width
• media_type
• encoding_rate
• created_at
• updated_at
• size
• duration
• audio_configuration
• language
• variant

Liquid 확장

toUTC 필터

대부분의 표준 ISO-8601 날짜 / 시간 문자열 형식을 구문 분석하고 표준 UTC 날짜 / 시간 문자열로 변환하는 toUTC 필터를 지원하도록 Liquid 파서를 확장했습니다. 이 형식은 Liquid의 날짜 필터에 적합하며, 이 필터는 타임스탬프를 원하는 형식의 날짜/시간 문자열로 다시 포맷하는 데 사용할 수 있습니다. 예:

  <pubDate>{{asset.published_at | toUTC | date: "%a, %d %b %Y %H:%M:%S %Z"}}</pubDate>

그러면 asset.published_at의 값이 2019-08-09T 13:32:52 .031Z인 경우 다음과 같은 출력이 생성됩니다.

  <pubDate>Fri, 09 Aug 2019 09:32:52 +0000</pubDate>

toEpoch 필터

우리가 사용하는 Liquid 파서는 날짜를 Unix epoch 타임 스탬프로 변환하기위한 날짜 필터에서 "% s"토큰을 지원하지 않습니다. 이를 해결하기 위해 유효한 날짜 사양을 epoch 형식으로 변환하는 데 사용할 수있는 toEpoch 사용자 지정 필터가 제공됩니다. 필터는 수학적 필터에 대한 입력에 적합한 에포크 이후 밀리 초를 나타내는 숫자 데이터 값을 반환합니다. 예:

  <toEpochMillis>{{"now" | toEpoch }}</toEpochMillis>
  <toEpochSeconds>{{"now" | toEpoch | divided_by : 1000 }}</toEpochSeconds>
  <thirtyDaysAgo>{{'now' | toEpoch | minus:2592000000 | fromEpoch }}</thirtyDaysAgo>

다음과 같은 출력을 생성합니다.

  <toEpochMillis>1580917253024</toEpochMillis>
  <toEpochSeconds>1580917253</toEpochSeconds>
  <thirtyDaysAgo>2020-01-06T15:40:53.055Z</thirtyDaysAgo>

fromEpoch 필터

FromEpoch 필터는 에포크 이후 밀리초를 나타내는 숫자를 UTC 날짜 문자열로 변환합니다. 필터는 또한 epoch 값 자릿수를 포함하는 문자열을 입력으로 받아들입니다. 필요한 경우 다시 형식화하기 위해 출력을 날짜 필터로 전달할 수 있습니다.

예:

  
  <fromEpochMillis>{{"now" | toEpoch | fromEpoch }}</fromEpochMillis>
  <thirtyDaysAgoAltFormat>{{1580917253024 | fromEpoch | date:"%Y-%m-%d" }}</thirtyDaysAgo>
  

다음과 같은 출력을 생성합니다.

  
  <fromEpochMillis>2020-02-05T16:09:37.809Z</fromEpochMillis>
  <thirtyDaysAgoAltFormat>2020-02-05</thirtyDaysAgo>