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).

Segmentos de pista

Un segmento de pista se define como una instancia de un vídeo virtual con un tiempo de inicio/final programado dentro de una pista.

Cada segmento de pista tiene asignado un identificador único a través de todos los segmentos de la pista en el programa (no solo dentro de una pista). Los segmentos de pista en la misma pista no pueden coincidir en el tiempo; sin embargo, los segmentos de la pista en diferentes pistas sí pueden. Los segmentos de pista tienen la siguiente estructura.
Note: Las propiedades external_id y override_stream_asset_id son opcionales.
  
{
     "id": "4fc59badbf9a4f26be1df179082c5459",
     "track_id": "4fcb0f981d70459a9693472d6d05d7b7",
     "start_time": "2013-08-13T11:42:14Z", 
     "end_time": "2013-05-13T13:49:14Z",
     "status": "online", 
     "virtual_asset_id": "9a6519637be3446e920228c36da18315",
     "external_id": "PAC12_447355812",
     "override_stream_asset_id”: "0yMTVoMzpqSB_nCyAJwvaAXSePizm6I3" 
}
  

Crear un segmento de pista

[POST] /v2/track_segments
{
    properties
}   
   

Ver todos los segmentos de pista

[GET] /v2/track_segments
   

Ver un segmento de pista

Los usuarios pueden utilizar el ID público generado por Ooyala o utilizar el ID externo para consultar los segmentos de pista.
[GET] /v2/track_segments/track_segment_id  
   

Incluir información de vídeos virtuales

También puede recuperar la información de vídeos virtuales, en lugar de solo el ID del vídeo virtual, especificando el parámetro de cadena de consulta include=virtual_asset.
[GET] /v2/track_segments?include=virtual_asset  
   

Acceso en ventana de tiempo del lote a los segmentos de pista

Para habilitar las vistas de representación de "¿Qué pasa hoy?" en el estilo de un calendario, se puede acceder a los segmentos de pista en el lote para una ventana de tiempo determinado (por ejemplo, "¿cuáles son los segmentos de pista que comienzan el miércoles?"). La siguiente consulta devuelve todos los segmentos de pista para el 15 de agosto de 2013.

  • Puede especificar una o dos de las opciones from_time y to_time.
  • Los valores de estos parámetros deben estar codificaos en URI.
  • La consulta devuelve todos los segmentos de pista entre from_time y to_time.
[GET] /v2/track_segments?from_time=2013-08-13-00:00:00Z&to_time=2013-08-14-00:00:00Z
   

Eliminar un segmento de pista

[DELETE] /v2/track_segments/track_segment_id  
   

Modificar un segmento de pista

[PATCH] /v2/track_segments/track_segment_id
{
      "start_time": "2012-08-13T11:30:00Z"
}  
   

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
track_segment_id

El ID de la pista. Para obtener una lista de pistas, realice una consulta GET contra la ruta /tracks.

Tipo: Cadena

Por defecto: Ninguno

Ejemplo: 4fc59badbf9a4f26be1df179082c5459

Parámetros de la cadena de consulta

En la siguiente tabla se describen todos los parámetros que se pueden expresar mediante la cadena de consulta.

Parámetro Descripción ¿Obligatorio?
from_time

Inicio del periodo de tiempo

Tipo: Fecha y hora

Ejemplo: [GET] /v2/track_segments?from_time=2013-08-13-00:00:00Z

No
include=object Incluir cualquiera de los siguientes:
  • virtual_asset
  • virtual_asset.metadata
  • virtual_asset.track_segment_instances
  • virtual_asset.asset_instances

Tipo: Cadena

Ejemplo: [GET] /v2/track_segments?include=virtual_asset

No
to_time

Final del periodo de tiempo

Tipo: Cadena

Ejemplo: [GET] /v2/track_segments?to_time=2013-08-14-00:00:00Z

No

Propiedades

En la siguiente tabla se describen todas las propiedades que se pueden asociar a una pista.

Propiedad Descripción ¿Obligatorio?
end_time

Hora de finalización del segmento de pista

Tipo: fecha/hora en el formato de hora universal coordinada (UTC) ISO-8601

Ejemplo: "2013-08-13T13:30:00Z"

external_id Identificador para uso con sistemas externos

Tipo: Cadena

Ejemplo: "PAC12_447355812"

No
override_stream_asset_id

Identificador de un vídeo que anula cualquier vídeo asociado a la pista de la que forma parte este segmento.

Tipo: Cadena

Ejemplo: "hvZGZmMzqaWtUHDm4RGuY9O8xsYzGV3x"

No
start_time

Hora de inicio del segmento de pista

Tipo: fecha/hora en el formato de hora universal coordinada (UTC) ISO-8601

Ejemplo: "2013-08-13T11:00:00Z"

status

Estado del segmento

Valores válidos: online | offline

Tipo: Cadena

Ejemplo: "online"

track_segment_id

Identificador del segmento de pista

Tipo: Cadena

Ejemplo: "8ffbfcda77fb40b0af6425ae24752254"

virtual_asset_id

Identificador de los vídeos virtuales asociados al segmento de pista.

Tipo: Cadena

Ejemplo: "9a6519637be3446e920228c36da18315"

Ejemplos

Este ejemplo crea un segmento de pista. La propiedad override_stream_asset_id es opcional.

[POST] /v2/track_segments
{
    "track_id": "8ffbfcda77fb40b0af6425ae24752254",
    "start_time": "2013-08-13T11:00:00Z",
    "end_time": "2013-08-13T13:30:00Z",
    "status": "online",
    "virtual_asset_id": "9a6519637be3446e920228c36da18315",
    "override_stream_asset_id”: "hvZGZmMzqaWtUHDm4RGuY9O8xsYzGV3x" 
} 
    

Backlot devuelve una respuesta similar a la siguiente:

{
 "end_time": "2013-08-13T13:30:00Z",
 "broadcast_status": "",
 "created_at": "2013-01-28T21:01:57Z",
 "track_id": "8ffbfcda77fb40b0af6425ae24752254",
 "id": "ecb02d1014bb46fdbcb55cfa87d2c860",
 "updated_at": "2013-01-28T21:01:57Z",
 "virtual_asset_id": "9a6519637be3446e920228c36da18315",
 "status": "online",
 "external_id": "",
 "start_time": "2013-08-13T11:00:00Z"
}	   
    

Ordenando Pruébelo