Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Identifica los vínculos directos específicos de la plataforma que se muestran en tu contenido

Cuando un usuario inicia Acciones multimedia en el contenido (por ejemplo, cuando hace clic en tu ícono en la Búsqueda de Google), Google lo dirige directamente al contenido en tu app o plataforma a través del vínculo directo del contenido.

Vínculo directo

Estos son los requisitos para los vínculos directos:

urlTemplate (de un objeto de destino) requiere un vínculo directo.
Los vínculos directos deben abrir el contenido al que dirigen en todas las plataformas especificadas.
Los vínculos directos pueden incluir parámetros (&) o etiquetas de anclaje (#).
- Si la reproducción automática no se activa de forma predeterminada, te recomendamos que agregues un parámetro, como &autoplay=true, a la vinculación directa para activar la función de reproducción automática en tu app o plataforma.

A continuación, se muestra un ejemplo de @id, url y urlTemplate:

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "Movie",
   "@id": "http://www.example.com/my_favorite_movie",
   "url": "http://www.example.com/my_favorite_movie",
   "name": "My Favorite Movie",
   "potentialAction": {
     "@type": "WatchAction",
     "target": {
       "@type": "EntryPoint",
       "urlTemplate": "http://www.example.com/my_favorite_movie&autoplay=true",
       ...
     },
   ...
   },
   ...
}

Usa vínculos directos para iniciar la reproducción

El siguiente seudocódigo representa el comportamiento deseado cuando un usuario inicia la reproducción:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

Para lograr el comportamiento de reproducción deseado, cumple con los siguientes requisitos específicos de la plataforma:

iOS: Debes usar vínculos universales.
Android y Android TV: Puedes usar Android App Links o vínculos de esquemas personalizados.

Vínculos de esquemas personalizados para Android y Android TV

En Android y Android TV, también puedes usar vínculos de esquemas personalizados. El elemento package_id de tu app debe incluirse en el URI del esquema personalizado. Esto garantiza que el usuario sea redireccionado a la página de tu app en Play Store si no está instalada. Por lo tanto, los siguientes formatos de URI son los únicos formatos de esquema personalizado aceptables para las acciones multimedia:

android-app://{package_id}/{scheme}/{path}

Por ejemplo:

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Para obtener más detalles, consulta la especificación completa.

intent://{package_id}/{scheme}/{path}

Por ejemplo:

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Otros formatos de URI, como el del siguiente ejemplo, no son vínculos de esquemas personalizados aceptables para las Acciones multimedia:

scheme://{path}: Por ejemplo:
mynetwork://play?series=20114&title=21141&media=e90c89fa4

Prácticas recomendadas

En el caso de que tu app no esté instalada y no tengas un reproductor web, configura tu servidor web para que redireccione automáticamente al usuario a Play Store o a App Store para que instale tu app. Para redireccionar, usa Firebase Dynamic Links o plataformas de vínculos inteligentes de terceros.

En el caso de que tu app no esté instalada y tengas un reproductor web, proporciona un vínculo o un banner inteligente a Play Store o a App Store para que los usuarios instalen tu app. A continuación, se muestra un ejemplo de un banner inteligente implementado:

Ejemplo de un banner inteligente implementado

Resumen de los requisitos y las limitaciones de los vínculos directos

En la siguiente tabla, se muestran los requisitos y las limitaciones de los vínculos directos en relación con iOS, Android y Android TV:

	iOS	Android y Android TV
http:// o https://	Obligatorio	Se recomienda si el sitio web para dispositivos móviles admite la reproducción.
android-app:// o intent://	N/A	Se recomienda si el sitio web para dispositivos móviles no admite la reproducción.
foo:// (cadena arbitraria)	No se permite	No se permite

Tipos de plataformas

Para asegurarte de que tu contenido esté disponible en las múltiples plataformas de Google que admiten acciones multimedia, cumple con los siguientes requisitos:

Todas las plataformas compatibles con socios requieren un vínculo directo a tu contenido.
En el caso de las plataformas de Chromecast, debes compilar un receptor con el SDK de CAF Receiver más reciente.
En el caso de las plataformas para dispositivos móviles (Android y iOS), consulta los requisitos en la sección Usa vínculos directos para iniciar la reproducción.

En la siguiente tabla, se incluye una lista de las plataformas que admiten las Acciones multimedia:

Plataforma	Descripción
`http://schema.org/DesktopWebPlatform`	Plataforma de búsqueda en un navegador web para computadoras.
`http://schema.org/MobileWebPlatform`	Plataforma de búsqueda en un navegador web para dispositivos móviles.
`http://schema.org/AndroidPlatform`	Plataformas de búsqueda y PlayGuide en la app para Android
`http://schema.org/AndroidTVPlatform`	Plataforma de Android TV en la app para Android TV.
`http://schema.org/IOSPlatform`	Plataforma de búsqueda en la app para iOS
`http://schema.googleapis.com/GoogleVideoCast`	Plataformas de transmisión y de Home en un dispositivo Chromecast.
`http://schema.googleapis.com/GoogleAudioCast`	Solo acciones de escucha Plataformas de transmisión y de Home en un dispositivo Chromecast.

Ejemplo de una entidad con dos vínculos directos diferentes:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

Comportamiento de reproducción

En el caso de la mayoría del contenido, cuando Google dirige a los usuarios a tu app o plataforma, te exigimos que reproduzcas automáticamente el contenido seleccionado. Esto permite que los usuarios comiencen a mirar o escuchar el contenido rápidamente.

Comportamiento de reproducción de las acciones de visualización

Para las acciones de visualización, requerimos el siguiente comportamiento de reproducción.

Todos los vínculos directos: Movie, TVEpisode, TVSeries y TVSeason

Comportamiento de compra o acceso: Si tu servicio requiere acceso o compra, la película o el episodio deben reproducirse después, según corresponda a su tipo. Para obtener más detalles, consulta los siguientes lineamientos sobre vínculos directos.
Reproducción: Si tu servicio hace un seguimiento del estado de un usuario, la reproducción debe comenzar desde el marcador anterior del usuario en la película o el episodio. De lo contrario, la reproducción debe comenzar desde el principio del contenido.
Reproducción automática: Según la plataforma, se requiere que tu servicio reproduzca el contenido de forma destacada después de que el usuario seleccione el episodio o la película de destino.
- Búsqueda: Se recomienda la reproducción automática, pero no es obligatoria. Si no se admite la reproducción automática, el contenido debe reproducirse con un solo clic después de que se dirija al usuario a tu app o servicio.
- Android TV: La reproducción automática es obligatoria para las películas y los episodios.

Solo vínculos directos a TVSeries y TVSeason

Selección del episodio objetivo: Debes seleccionar el episodio objetivo correcto. Si tu servicio hace un seguimiento del estado del usuario, el episodio de destino debe ser el episodio que el usuario dejó de mirar por última vez. O bien, si el usuario terminó de ver el episodio que estaba mirando, haz que el episodio de destino sea el episodio siguiente. De lo contrario, el episodio de destino debe ser uno de los siguientes a tu discreción:

TVSeries
- Es el primer episodio de la serie. Se recomienda para programas serializados.
- Es el primer episodio de la temporada más reciente. Se recomienda para programas serializados de larga duración.
- El episodio más reciente. Se recomienda para programas diarios o relacionados con noticias.
TVSeason
- Es el primer episodio de la temporada. Se recomienda para programas serializados.
- El episodio más reciente. Se recomienda para programas diarios o relacionados con noticias.

El vínculo directo para TVSeries o TVSeason debe ser estático (no cambiar) y resolverse en el episodio de destino. No uses el vínculo directo para un episodio específico.

En la siguiente tabla, se proporcionan varios ejemplos que demuestran la lógica de selección de episodios objetivo requerida para los tipos de entidades TVSeries, TVSeason y TVEpisode:

	Episodio objetivo si el usuario miró por última vez el episodio 24 de la temporada 6	Episodio objetivo si el usuario no miró ningún episodio
Vínculo directo de la serie	S6E24 (si el usuario no terminó de ver S6E24) S6E25 (si el usuario terminó de mirar S6E24)	Uno de los siguientes: Primer episodio de la serie Primer episodio de la temporada más reciente Episodio más reciente
Vínculo directo de la temporada (S1 a S5)	El último episodio que el usuario miró en esa temporada o el primer episodio de la temporada si el usuario no miró ningún episodio en esa temporada.	Primer episodio de la temporada
Vínculo directo de la temporada (S6)	S6E24 (si el usuario no terminó de ver S6E24) S6E25 (si el usuario terminó de mirar S6E24)	Uno de los siguientes: Primer episodio de la temporada Episodio más reciente
Vínculo directo al episodio	Es el episodio específico en el que se hizo clic.	Es el episodio específico en el que se hizo clic.

Comportamiento de reproducción de las acciones de escucha

En el caso de las acciones de escucha, requerimos el siguiente comportamiento de reproducción:

El contenido debe reproducirse con un solo clic después de que el usuario sea redireccionado a tu app o servicio.
Si tu app o plataforma requiere acceso, debe reproducir el contenido de inmediato o con un solo clic después del acceso.
Tu app o plataforma debe ofrecer, al menos, una forma para que todos los usuarios reproduzcan la canción, el álbum, el artista o la playlist exactos.
- En el caso de los usuarios que no cumplen con los requisitos para reproducir el contenido exacto (por ejemplo, no tienen la suscripción requerida), tu servicio debe explicar qué debe hacer el usuario para cumplir con los requisitos y reproducir el contenido exacto cuando llegue a tu app o plataforma.

Te recomendamos que sigas estas prácticas recomendadas para tu app o plataforma:

En el caso de MusicGroup, reproduce contenido diferente del artista cada vez que un usuario lo seleccione.
En el caso de MusicAlbum, reproduce el contenido en el orden en que aparece en el álbum.
En el caso de MusicPlaylist, reproduce contenido diferente de la playlist cada vez que un usuario la seleccione.