Error message

User warning: The following module is missing from the file system: fast_404. For information about how to fix this, see the documentation page. in _drupal_trigger_error_with_delayed_logging() (line 1143 of /mnt/www/html/ooyala/docroot/includes/bootstrap.inc).

Sindicaciones

Una sindicación consiste en una lista de contenido y un destino en el que desea sindicar el contenido.

Descripción

El tipo de feed determina qué streams se utilizarán en la sindicación (por ejemplo, un stream mp4 o un stream de archivo fuente) y el formato de salida (por ejemplo, MRSS plano o enviando los archivos a YouTube). Ooyala admite actualmente los siguientes destinos para el contenido:

Sindicación Tipo Descripción
Feed 3GP three_gp Feed MRSS con las URL a los archivos contenedor 3GP
Feed MP4 mp4 Feed MRSS con las URL al archivo contenedor MP4
Feed Roku roku Feed MRSS compatible con Roku
Feed avanzado advanced Extensión de TubeMogul para MRSS
Feed de Boxee boxee Feed formateado de acuerdo con la extensión de Boxee para MRSS
Feed de Google google Feed de mapas de sitio de Google
Feed de iPad ipad Feed MRSS compatible con iPad
Feed de iPad con tasa de transmisión de bits adaptable ipad_abr Feed compatible con iPad (tasa de transmisión de bits adaptable)
Feed de iPhone iphone Feed MRSS compatible con iPhone
Feed de iPhone con tasa de transmisión de bits adaptable iphone_abr Feed MRSS (con tasa de transmisión de bits adaptable) compatible con iPhone
Feed de reproductor feed Feed MRSS con los fragmentos de código del reproductor embebidos
Fuente source Feed MRSS con las URL al archivo fuente.
Podcast (iTunes) itunes Feed formateado de acuerdo con la extensión de iTunes para MRSS
Universal universal Feed que utiliza el lenguaje de plantillas de sindicación universal
YouTube youtube Sindicación que envía los vídeos y sus metadatos a YouTube

Tipos de vídeos sindicables

Cualquier tipo de vídeo, excepto los de sonido, se puede sindicar a través de sindicación universal y las consultas API descritas a continuación.

Agregar nueva sindicación

Para agregar una nueva sindicación, debe especificar los parámetros nombre y tipo:

[POST] /v2/syndications 
{
  properties 
}   
   

Enumerar sindicaciones

Para enumerar todas las sindicaciones de su cuenta:

[GET] /v2/syndications
   

Obtener sindicación

Para obtener una sindicación:

[GET] /v2/syndications/syndication_id
   

Cargar una plantilla USTL

Para cargar una plantilla USTL a una sindicación avanzada, debe incluir la plantilla en el cuerpo de la consulta.

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

Atributos de ruta

En la tabla siguiente se describen todos los atributos que se pueden expresar por medio de la ruta.

Atributo de ruta Descripción
syndication_id

El ID de la sindicación. Para obtener una lista de sindicaciones, realice una consulta GET con la ruta /syndications.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: /syndications/d4fe34fe44ea4e648fd07d4509123254

Parámetros de URL de sindicación

La tabla siguiente describe todos los parámetros que pueden expresarse al acceder a la URL de la sindicación.

Note: Estos parámetros no pueden especificarse en la ruta utilizada para crear sindicaciones y modificar sus configuraciones.
Parámetro Descripción ¿Obligatorio?
limit

El número máximo de resultados que devolver. Si recibe más resultados que el valor que especifique, puede obtener la siguiente página de resultados especificando un page_token.

Tipo: Cadena

Por defecto: 20

Valores válidos: 1-500

Ejemplo: http://api.ooyala.com/v2/syndications/6b6e72dd71bd4fa5/feed?pcode=Y4cG06...

No
paging_token

o

page_token
URL a la siguiente página de resultados.
Note: Si el número de resultados para una página determinada es divisible por el valor de limit, el servicio devuelve una respuesta 404.

Tipo: Cadena

Por defecto: Ninguno

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

No
redirect_content

Por defecto, las sindicaciones contienen URL redirigidas. Para obtener la URL redirigida, especifique false.

Tipo: Cadena

Por defecto: true

Ejemplo: http://api.ooyala.com/v2/syndications/6b6e72dd71bd4fa5/feed?pcode=Y4cG06...

No
updated_after

Tipo: Fecha y hora

Por defecto: Devuelve todos los resultados

Ejemplo: http://api.ooyala.com/v2/syndications/6b6e72dd71bd4fa5/feed?pcode=Y4cG06...

No

Propiedades

En la siguiente tabla se describen todas las propiedades que se pueden asociar a una sindicación.

Propiedad Descripción ¿Obligatorio?
album_art_url

URL a los elementos gráficos del contenido. Apple recomienda un JPG de 300x300 para obtener los mejores resultados.

Tipo: Cadena

Por defecto: Ninguno

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

Tipos de sindicación: Podcast (iTunes)

No
asset_defaults Elemento contenedor para otras configuraciones. No
asset_type

El tipo de vídeos para la sindicación.

Tipo: Cadena

Valores válidos: video | ad | remote_asset | live_stream

Por defecto: Ninguno

Ejemplo: "live_stream"

Tipos de sindicación: Todos

No
author

El autor del contenido de la sindicación.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "Varios"

Tipos de sindicación: Podcast (iTunes)

No
category

La categoría a la que pertenece la sindicación.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "comedia"

Tipos de sindicación: Advanced, Podcast (iTunes)

No
description

Descripción de la sindicación.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "Contiene vídeos de demostración enviados por los espectadores."

Tipos de sindicación: Advanced, Boxee, iPhone, iPhone (tasa de transmisión de bits adaptable), iPad, MP4, Roku, Source

No
destination_url

Solo lectura. La URL a la sindicación.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "http://backlot.ooyala.com/syndication/advanced?id=fd25caa0-977e-4dbd-bba..."

Tipos de sindicación: Advanced, Boxee, iPhone, iPhone (tasa de transmisión de bits adaptable), iPad, MP4, Roku, Source

No
include_all_content

Especifica si se sindica todo el contenido asociado a la cuenta. Si se establece en false, Ooyala sindica el contenido especificado por include_labels.

Tipo: Booleano

Valores válidos: true | false

Por defecto: false

Condiciones: Obligatorio si no se han especificado etiquetas en include_labels.

Ejemplo: "true"

Tipos de sindicación: Todos

Condicional
include_labels

Especifica las etiquetas que se asociarán a la sindicación. Cualquier vídeo que se asigne a una de las etiquetas especificadas se incluye automáticamente con esta sindicación.

Tipo: Conjunto de cadenas

Por defecto: Ninguno

Condiciones: Obligatorio cuando include_all_content se establece en false.

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

Tipos de sindicación: Todos

Condicional
keywords

Palabras clave para la sindicación.

Tipo: Conjunto de cadenas

Por defecto: Ninguno

Ejemplo: ["apasionante", "convincente", "insomnio"]:

Tipos de sindicación: Podcast (iTunes)

No
name

Nombre de la sindicación.

Tipo: Cadena

Ejemplo: "Contenido publicitario de YouTube"

Tipos de sindicación: Todos

password

Nombre de usuario de la cuenta.

Tipo: Cadena

Por defecto: Ninguno

Condiciones: Obligatorio para sindicaciones en YouTube.

Ejemplo: "myyoutubepassword"

Tipos de sindicación: YouTube

Condicional
private

Indica privacidad para la sindicación con YouTube y otros servicios. Cuando se establece en true, el vídeo es privado.

Tipo: Cadena

Valores válidos: true | false

Por defecto: false

Ejemplo: true

No
should_create_youtube_videos

Crea automáticamente vídeos de YouTube añadidos a la sindicación.

Tipo: Booleano

Valores válidos: true | false

Por defecto: true

Ejemplo: true

Tipos de sindicación: YouTube

No
should_delete_youtube_videos

Elimina automáticamente los vídeos de YouTube al quitarlos de la sindicación.

Tipo: Cadena

Valores válidos: true | false

Por defecto: Ninguno

Ejemplo: true

Tipos de sindicación: YouTube

No
subtitle

Los subtítulos de la sindicación.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "Completo y sin editar"

Tipos de sindicación: Podcast (iTunes)

No
title

Título de la sindicación.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: "Lo mejor de la televisión casera"

Tipos de sindicación: Advanced, Boxee, iPhone, iPhone (tasa de transmisión de bits adaptable), iPad, MP4, Roku, Source

No
type

El tipo de sindicación.

Tipo: Cadena

Valores válidos: Remítase a la tabla del principio de esta sección.

Por defecto: Ninguno

Ejemplo: "boxee"

Tipos de sindicación: Todos

unrestricted_youtube_account

Si se establece en "true", le permite cargar vídeos de más de 15 minutos.

Tipo: Cadena

Valores válidos: true | false

Por defecto: false

Ejemplo: false

Tipos de sindicación: YouTube

Note: Asegúrese de que su cuenta de YouTube esté activada para permitir vídeos más largos. De lo contrario, la sindicación podría fallar. Para más información, póngase en contacto con YouTube.
No
username

Nombre de usuario de la cuenta.

Tipo: Cadena

Por defecto: Ninguno

Condiciones: Obligatorio para sindicaciones en YouTube.

Ejemplo: "myyoutubeaccount"

Tipos de sindicación: YouTube

Condicional

Ejemplos

En este ejemplo la API obtiene la sindicación con el código embebido ODUzYWNiZGJiZ?:

[GET] /v2/syndications/ODUzYWNiZGJiZ
    

y devuelve esta respuesta:

{
  "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
	}     
    

Ordenando Pruébelo

Este ejemplo modifica una sindicación:

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

Ordenando Pruébelo

Este ejemplo elimina una sindicación:

[DELETE] /v2/syndications/ODUzYWNiZGJiZ
    

Ordenando Pruébelo

Este ejemplo muestra los resultados 11-20 de la sindicación ODUzYWNiZGJiZ:

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

Este ejemplo realiza los vídeos de la sindicación pública 982147856bouiguhwfoihw:

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