Publicaciones cruzadas - API de vídeo - Documentación

Publicación cruzada de vídeos

En este documento se explica cómo utilizar la API de vídeo para publicar un vídeo en varias páginas sin subirlo a cada una de ellas. Por ejemplo, si tienes una página principal con varias páginas secundarias, puedes subir y publicar un vídeo en la página principal y, a continuación, publicarlo en todas las páginas secundarias sin necesidad de subirlo a cada página.

Para usar un vídeo en publicaciones cruzadas, debes poder realizar la tarea CREATE en las páginas y habilitar la publicación del vídeo en páginas específicas. Necesitarás el identificador del vídeo y los identificadores de las páginas en las que quieres publicarlo, además de los identificadores de acceso a la página de la página en la que el vídeo se publicó inicialmente y de las páginas en las que quieres publicarlo.

Puedes utilizar la API para determinar si un vídeo puede usarse en publicaciones cruzadas o si ya se ha usado en este tipo de publicaciones, así como activar la publicación cruzada en todas las páginas que administra una cuenta de Business Manager y obtener una lista de las páginas que admiten el uso en varias publicaciones.

Consulta nuestra guía de publicación de reels para obtener información sobre cómo hacer una publicación cruzada con un reel en la página de Facebook de un colaborador.

Limitaciones

Si se ha publicado un vídeo en tu página mediante una publicación cruzada, pero no tienes un rol en la página en la que el vídeo se publicó inicialmente, no puedes cambiar ningún permiso del vídeo.

Paso 1. Habilitar la publicación cruzada

Para hacer publicación cruzada de un vídeo en varias páginas, debes activar la publicación cruzada del vídeo en dichas páginas.

Necesitarás lo siguiente:

El identificador del vídeo que quieres usar en la publicación cruzada.
Los identificadores de las páginas en las que quieres publicar el vídeo.
Un identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.
El permiso publish_video.
El permiso pages_manage_posts.
El permiso pages_read_engagement.

Envía una solicitud POST al extremo de vídeo:

POST /{api-version}/{video-id}
  ?allow_crossposting_for_pages=[{page_id:{page-a-id},allow:true},{page_id:{page-b-id},allow:true}]
  &access_token={page-access-token}

Incluye los siguientes parámetros:

Nombre del parámetro	Valor
`allow_crossposting_for_pages`	Matriz JSON de los identificadores de las páginas en las que quieres publicar el vídeo. Establece `allow` en `true` para activar la publicación o en `false` para desactivarla.
`access_token`	Identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.

Ejemplo de solicitud

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "allow_crossposting_for_pages=[{page_id:104371193424796,allow:true},{page_id:115969103185286",allow:true}] \
  -F "access_token=EAABkW..."

Ejemplo de respuesta

{
  "success": true
}

Paso 2. Usar el vídeo en publicaciones cruzadas

Necesitarás lo siguiente:

El identificador del vídeo que quieres usar en publicaciones cruzadas.
El identificador de la página en la que quieres publicar el vídeo.
El identificador de acceso a la página perteneciente a la página en la que quieres publicar el vídeo.
El permiso publish_video.
El permiso pages_manage_posts.
El permiso pages_read_engagement.

Envía una solicitud POST al extremo de vídeos de página:

POST /{api-version}/{page-id}/videos
    ?crossposted_video_id={video-id}
    &access_token={page-access-token}

Incluye los siguientes parámetros:

Nombre del parámetro	Valor
`crossposted_video_id`	Identificador del vídeo que vas a usar en publicaciones cruzadas.
`access_token`	Identificador de acceso a la página perteneciente a la página en la que vas a publicar el vídeo.

Ejemplo de solicitud

curl -X POST \
  "https://graph.facebook.com/104371193424796/videos?crossposted_video_id=2918040388250909&access_token=EAABk..."

Ejemplo de respuesta JSON

{
  "id":"577600939847873"
}

Comprobar si un vídeo puede usarse en publicaciones cruzadas

Para determinar si un vídeo puede usarse en publicaciones cruzadas, envía una solicitud GET al extremo de vídeo con el campo is_crossposting_eligible.

Necesitarás lo siguiente:

El identificador del vídeo que quieres usar en publicaciones cruzadas.
Un identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.
El permiso pages_manage_posts.
El permiso pages_read_engagement.

GET /{api-version}/{video-id}
   ?fields=is_crossposting_eligible
   &access_token={page-access-token}

Ejemplo de solicitud

curl -X GET \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "is_crossposting_eligible" \
  -F "access_token=EAABkW..."

Ejemplo de respuesta

{
  "is_crossposting_eligible": true,
  "id": "2918040388250909"
}

Nombre del parámetro	Valor
`is_crossposting_eligible`	Muestra si el uso del vídeo en publicaciones cruzadas está habilitado.
`access_token`	Identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.

Comprobar si un vídeo puede usarse en publicaciones cruzadas

Para comprobar si un vídeo puede usarse en publicaciones cruzadas, envía una solicitud GET al extremo de vídeo con el campo is_crosspost_video.

Necesitarás lo siguiente:

El identificador del vídeo que quieres consultar.
Un identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.
El permiso publish_video.
El permiso pages_manage_posts.
El permiso pages_read_engagement.

GET /{api-version}/{video-id}
  ?fields=is_crosspost_video
  &access_token={page-access-token}

Incluye los siguientes parámetros:

Nombre del parámetro	Valor
`is_crosspost_video`	Muestra si el vídeo es el original o si es una publicación cruzada.
`access_token`	Identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.

Ejemplo de solicitud

curl -X GET \
 "https://graph.facebook.com/v7.0/577600939847873?fields=is_crosspost_video&access_token=EAABk..."

Ejemplo de respuesta

{
  "is_crosspost_video": true,
  "id": "577600939847873"
}

Obtener una lista de las páginas donde pueden hacerse publicaciones cruzadas

Necesitarás lo siguiente:

El identificador de la página en la que el vídeo se publicó inicialmente.
Un identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.
El permiso pages_manage_posts.
El permiso pages_read_engagement.

Envía una solicitud GET al extremo CrosspostWhitelistedPages de la página.

GET {page-id}/crosspost_whitelisted_pages
  &access_token={page-access-token}

Ejemplo de solicitud

curl -X GET \ "https://graph.facebook.com/v7.0/2918040388250909/crosspost_whitelisted_pages&access_token=EAABk..."

Ejemplo de respuesta

{
  "crosspost_whitelisted_pages": {
    "data": [
      {
        "name": "Obsession, by Margaret",
        "id": "115969103185286"
      },
      {
        "name": "Cisco Dog",
        "id": "422575694827569"
      }
    ],
    "paging": {
      "cursors": {
        "before": "QVFIUn...",
        "after": "QVFIUk4..."
      }
    }
  },
  "id": "1353269864728879"
}

Habilitar las publicaciones cruzadas en todas las páginas de una cuenta de Business Manager

A fin de habilitar las publicaciones cruzadas en todas las páginas que administra una cuenta de Business Manager, envía una solicitud POST al extremo de vídeo.

Necesitarás lo siguiente:

El identificador del vídeo que quieres usar en publicaciones cruzadas.
Un identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.
El permiso pages_manage_posts.
El permiso pages_read_engagement.

POST /{api-version}/{video-id}
  ?allow_bm_crossposting=true
  &access_token={page-access-token}

Incluye los siguientes parámetros:

Nombre del parámetro	Valor
`allow_bm_crossposting`	Establece `allow` en “true” para activar la publicación o en “false” para desactivarla.
`access_token`	Identificador de acceso a la página perteneciente a la página en la que el vídeo se publicó inicialmente.

Ejemplo de solicitud

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909?allow_bm_crossposting=true&access_token=EAABkW..."

Ejemplo de respuesta

{
  "success": true
}

Insights

Cada vídeo usado en publicaciones cruzadas tiene su propio valor de video_id. Puedes consultar los insights de vídeo de cada vídeo y cada página.

Más información

Para obtener más información sobre el uso en publicaciones cruzadas, visita nuestro Servicio de ayuda.