シンジケーション

シンジケーションはコンテンツ一覧と希望のコンテンツ公開先で構成されます。

説明

フィードタイプはシンジケーションで使用されるストリーム (mp4ストリームまたはソースファイルストリーム)と 出力形式(プレーンMRSS、またはYouTubeにファイル送信)を決定します。Ooyala現在、次のコンテンツ公開先をサポートします:

外部公開(シンジケーション) タイプ 説明
3GPフィード three_gp 3GPコンテナーファイルへのURLを含むMRSSフィード
Advancedフィード advanced TubeMogulのMRSS拡張
Boxeeフィード boxee BoxeeのMRSS拡張に基づいてフォーマットされたフィード
Googleフィード google Googleサイトマップフィード
MP4フィード mp4 MP4コンテナーファイルへのURLを含むMRSSフィード
Podcast (iTunes) itunes iTunesのMRSS拡張に基づいてフォーマットされたフィード
Roku フィード roku Roku互換のMRSSフィード
YouTube youtube アセットとメタデータをYouTubeへプッシュするシンジケーション
iPad 適応ビットレートフィード ipad_abr iPad (適応ビットレート)互換のフィード
iPadフィード ipad iPad互換のMRSSフィード
iPhoneフィード iphone iPhone互換のMRSSフィード
iPhone適応ビットレートフィード iphone_abr iPhone (適応ビットレート)互換のMRSSフィード
ソース source ソースファイルへのURLを含むMRSSフィード
プレイヤーフィード フィード プレイヤー埋め込みスニペットを含むMRSSフィード
ユニバーサル ユニバーサル ユニバーサルシンジケーションテンプレート言語を使うフィード

シンジケーションのアセットタイプ

オーディオアセット以外のあらゆるタイプのアセットが、ここで解説されているユニバーサルシンジケーションとAPIリクエストを通じて公開できます。

新規シンジケーションの追加

新規シンジケーションを追加するには、nameおよびtypeパラメーターを指定します。

[POST] /v2/syndications 
{
  properties 
}   
   

シンジケーションの一覧表示

アカウントのシンジケーションを一覧表示。

[GET] /v2/syndications
   

シンジケーションの取得

シンジケーションを取得するには、

[GET] /v2/syndications/syndication_id
   

USTLテンプレートのアップロード

高度なシンジケーションにUSTLテンプレートをアップロードするには、リクエストボディ内にテンプレートを組み込んで下さい。

[PUT] /v2/syndications/syndication_id/template
<template>
   

ルート属性

次の表はルートに表示されるすべて属性を示しています。

ルート属性 説明
syndication_id

シンジケーションのID。シンジケーション一覧を取得するために、/syndicationsルートに対してGETを実行してください。

タイプ:文字列

デフォルト:なし

例:/syndications/d4fe34fe44ea4e648fd07d4509123254

シンジケーションURLパラメータ

次の表はシンジケーションのURLにアクセスする時に表示されるすべてのパラメータを示しています。

Note: これらのパラメータは、シンジケーションの作成およびその設定の修正に使用されるルートでは指定出来ません。
パラメータ 説明 必須?
limit

返される結果の最大数。指定した値以上の結果が返ってきた場合、 page_tokenを指定することで、次のページに結果が表示されます。

タイプ:文字列

デフォルト:20

有効値:1-500

例: http://api.ooyala.com/v2/syndications/6b6e72dd71bd4fa5/feed?pcode=Y4cG06BlqYMLIj&limit=50

いいえ
paging_token

または

page_token
次の結果ページへのURL。
Note: ページに表示する結果数がlimitの値で分割可能な場合、サービスが404レスポンスを返します。

タイプ:文字列

デフォルト:なし

例:[GET] /v2/analytics/reports/account/performance/videos/2012-01-01...2012-01-24?page_token=W1siY29sdW1uIiwiMzRTYUun1yJdLFsiaW5kZXgiLDEwXSxbInZhbHVlIiwxXV0=

いいえ
redirect_content

デフォルトで、シンジケーションはリダイレクトURLを含みます。ダイレクトURLを取得するには、 falseを指定してください。

タイプ:文字列

デフォルト:true

例: http://api.ooyala.com/v2/syndications/6b6e72dd71bd4fa5/feed?pcode=Y4cG06BlqYMLIj&redirect_content=false

いいえ
updated_after

タイプ:DateTime

デフォルト:すべての結果を返します

例: http://api.ooyala.com/v2/syndications/6b6e72dd71bd4fa5/feed?pcode=Y4cG06BlqYMLIj&updated_after=2011-01-01T00:00:00Z

いいえ

プロパティ

次の表はシンジケーションと関連付けることができるすべてのプロパティを示しています。

プロパティ 説明 必須?
album_art_url

コンテンツのアルバムアートのURL。最良の結果を得るために、300x300のJPGを使用することをAppleは推奨しています。

タイプ:文字列

デフォルト:なし

例:"http://mywebsite.com/myartwork.jpg"

シンジケーションタイプ:Podcast (iTunes)

いいえ
asset_defaults その他の設定のコンテナ要素。 いいえ
asset_type

シンジケーションのアセットタイプ

タイプ:文字列

有効値:video| ad | remote_asset | live_stream

デフォルト:なし

例:"live_stream"

シンジケーションタイプ:すべて

いいえ
author

シンジケーション内のコンテンツの著作者

タイプ:文字列

デフォルト:なし

例:"Various"

シンジケーションタイプ:Podcast (iTunes)

いいえ
category

シンジケーションが属するカテゴリー。

タイプ:文字列

デフォルト:なし

例:"comedy"

シンジケーションタイプ:Advanced, Podcast (iTunes)

いいえ
description

シンジケーションの説明。

タイプ:文字列

デフォルト:なし

例:"Contains viewer-submitted demo reels."

シンジケーションタイプ:Advanced, Boxee, iPhone, iPhone (適応ビットレート), iPad, MP4, Roku, ソース

いいえ
destination_url

読み取り専用。シンジケーションへのURL。

タイプ:文字列

デフォルト:なし

例:"http://backlot.ooyala.com/syndication/advanced?id=fd25caa0-977e-4dbd-bbaf-fakefake"

シンジケーションタイプ:Advanced, Boxee, iPhone, iPhone (適応ビットレート), iPad, MP4, Roku, ソース

いいえ
include_all_content

アカウントと関連づけられたすべてのコンテンツを公開するかどうかを指定します。falseに設定すると、Ooyalaはinclude_labelsで指定されたコンテンツを公開します。

タイプ:ブーリアン

有効値: true | false

デフォルト:false

条件:include_labelsで何もラベルが指定されてない場合、必須。

例:"true"

シンジケーションタイプ:すべて

条件付き
include_labels

シンジケーションと関連づけるラベルを指定します。指定されたラベルに割り当てられたアセットは自動的にこのシンジケーションに含まれます。

タイプ:文字列の配列

デフォルト:なし

条件:include_all_contentがfalseに設定されている場合、必須。

例:["/label1", "/label2", "/label3"]

シンジケーションタイプ:すべて

条件付き
keywords

シンジケーションのキーワード。

タイプ:文字列の配列

デフォルト:なし

例:["exciting", "compelling", "insomnia"]

シンジケーションタイプ:Podcast (iTunes)

いいえ
name

シンジケーションの名前。

タイプ:文字列

例:"YouTube Advertising Content"

シンジケーションタイプ:すべて

はい
password

アカウントのパスワード。

タイプ:文字列

デフォルト:なし

条件:YouTubeシンジケーションの場合、必須。

例:"myyoutubepassword"

シンジケーションタイプ:YouTube

条件付き
private

YouTubeとその他のサービスを持つシンジケーションのプライバシーを示します。trueに設定すると、 アセットをプライベートにします。

タイプ:文字列

有効値: true | false

デフォルト:false

例: true

いいえ
should_create_youtube_videos

シンジケーションに追加されたYouTubeビデオを自動的に作成します。

タイプ:ブーリアン

有効値: true | false

デフォルト:true

例: true

シンジケーションタイプ:YouTube

いいえ
should_delete_youtube_videos

シンジケーションから削除されると、自動的にYouTube ビデオを削除します。

タイプ:文字列

有効値: true | false

デフォルト:なし

例: true

シンジケーションタイプ:YouTube

いいえ
subtitle

シンジケーションの字幕。

タイプ:文字列

デフォルト:なし

例:"Full length and unedited"

シンジケーションタイプ:Podcast (iTunes)

いいえ
title

シンジケーションのタイトル。

タイプ:文字列

デフォルト:なし

例:"Best of Homemade Reality TV"

シンジケーションタイプ:Advanced, Boxee, iPhone, iPhone (適応ビットレート), iPad, MP4, Roku, ソース

いいえ
type

シンジケーションのタイプ。

タイプ:文字列

有効値:このセクション先頭の表を参照してください。

デフォルト:なし

例:"boxee"

シンジケーションタイプ:すべて

はい
unrestricted_youtube_account

trueに設定すると、15分以上の長さを持つビデオをアップロードできるようになります。

タイプ:文字列

有効値: true | false

デフォルト:false

例: false

シンジケーションタイプ:YouTube

Note: YouTubeアカウントが長いビデオを公開できるようになっているか確認してください。そうでなければ、シンジケーションに失敗します。詳しくは、YouTubeにお問い合わせください。
いいえ
username

アカウントのパスワード。

タイプ:文字列

デフォルト:なし

条件:YouTubeシンジケーションの場合、必須。

例:"myyoutubeaccount"

シンジケーションタイプ:YouTube

条件付き

このAPI例はembedコードODUzYWNiZGJiZ?のシンジケーションを取得します。

[GET] /v2/syndications/ODUzYWNiZGJiZ
    

そして、このレスポンスを返します。

{
  "author": null, 
  "category": null, 
  "description": "", 
  "destination_url": "", 
  "id": "ODUzYWNiZGJiZ", 
  "include_all_content": true, 
  "include_labels": [], 
  "keywords": null, 
  "name": "Source MRSS", 
  "should_create_youtube_videos": null, 
  "should_delete_youtube_videos": null, 
  "subtitle": null, 
  "syndication_url": "http://api.ooyala.com/syndications/ODUzYWNiZ/feed", 
  "title": "", 
  "type": "source", 
  "yt_username": null
	}     
    

Sorting 試行する

こちらの例はシンジケーションを修正します。

[PATCH] /v2/syndications/ODUzYWNiZGJiZ
{
		title: "MY BOLD NEW TITLE", 
		description: "Isn't the new title great?"
}
    

Sorting 試行する

こちらの例はシンジケーションを削除します。

[DELETE] /v2/syndications/ODUzYWNiZGJiZ
    

Sorting 試行する

この例は、11~20件目のODUzYWNiZGJiZシンジケーションの結果を表示します。

http://api.ooyala.com/v2/syndications/ODUzYWNiZGJiZ/feed?pcode=Y4cG06BlqYMLIjPGy&limit=10
    

この例は、982147856bouiguhwfoihwシンジケーションのアセットをパブリックにします。

[PATCH /v2/syndications/982147856bouiguhwfoihw
{
    "assets_default": {
        "private" : false
}    
    

この記事はお役にたちましたか?