Crosspostage - API Video - Documentation

Crossposter une vidéo

Ce document explique comment utiliser l'API Video pour publier une vidéo sur plusieurs pages sans avoir à l’importer vers chaque Page. Par exemple, si vous possédez une Page parent qui comporte plusieurs Pages enfant, vous pouvez importer et publier une vidéo sur la Page parent, puis publier la vidéo sur toutes les Pages enfant sans qu’il soit nécessaire de l’importer vers chacune de ces Pages.

Pour crossposter une vidéo, vous devez être autorisé à exécuter la tâche CREATE sur les Pages et activer la publication de la vidéo sur les Pages spécifiques. Vous aurez besoin de l’ID de la vidéo et des ID des Pages sur lesquelles vous souhaitez publier la vidéo, ainsi que d’un token d’accès pour la Page sur laquelle la vidéo a été initialement publiée et pour les Pages sur lesquelles vous souhaitez la publier.

L’API peut également vous aider à déterminer si une vidéo est éligible au crosspostage ou s’il s’agit déjà d’une vidéo crosspostée, à savoir activer le crosspostage sur toutes les Pages gérées par votre Business Manager et obtenir une liste des Pages disponibles pour le crosspostage.

Consultez notre guide de publication de reels pour obtenir des informations sur le crosspostage d’un reel sur la Page Facebook d’un collaborateur.

Limites

Si une vidéo a été crosspostée sur votre Page, mais que vous ne disposez d’aucun rôle sur la Page sur laquelle la vidéo a été initialement publiée, vous ne pouvez pas modifier les autorisations associées à la vidéo.

Étape 1 : Activer le crosspostage

Si vous souhaitez publier une vidéo sur plusieurs Pages, vous devez activer le crosspostage de la vidéo sur ces Pages.

Vous aurez besoin des éléments suivants :

L’ID de la vidéo à crossposter
Les ID des Pages sur lesquelles publier la vidéo
Un token d’accès de la Page sur laquelle la vidéo a été initialement publiée
L’autorisation publish_video
L’autorisation pages_manage_posts
L’autorisation pages_read_engagement

Envoyez une requête POST au point de terminaison Vidéo :

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}

Indiquez les paramètres suivants :

Nom du paramètre	Valeur
`allow_crossposting_for_pages`	Tableau JSON des ID de Pages sur lesquelles vous souhaitez publier la vidéo. Affectez à `allow` la valeur `true` pour activer la publication ou la valeur `false` pour désactiver la publication.
`access_token`	Token d’accès de la Page sur laquelle la vidéo a été initialement publiée.

Exemple de requête

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

Exemple de réponse

{
  "success": true
}

Étape 2 : Crossposter la vidéo

Vous aurez besoin des éléments suivants :

L’ID de la vidéo à crossposter
L’ID de la Page sur laquelle vous souhaitez publier la vidéo
Un token d’accès de la Page sur laquelle vous souhaitez publier la vidéo
L’autorisation publish_video
L’autorisation pages_manage_posts
L’autorisation pages_read_engagement

Envoyez une requête POST au point de terminaison Vidéos de Page :

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

Indiquez les paramètres suivants :

Nom du paramètre	Valeur
`crossposted_video_id`	ID de la vidéo crosspostée.
`access_token`	Token d’accès de la Page sur laquelle vous publiez la vidéo.

Exemple de requête

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

Exemple de réponse JSON

{
  "id":"577600939847873"
}

Éligibilité au crosspostage de vidéo

Pour déterminer si une vidéo peut être crosspostée, envoyez une requête GET au point de terminaison Vidéo avec le champ is_crossposting_eligible.

Vous aurez besoin des éléments suivants :

L’ID de la vidéo à crossposter
Un token d’accès de la Page sur laquelle la vidéo a été initialement publiée
L’autorisation pages_manage_posts
L’autorisation pages_read_engagement

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

Exemple de requête

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

Exemple de réponse

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

Nom du paramètre	Valeur
`is_crossposting_eligible`	Indique si la vidéo peut être crosspostée.
`access_token`	Token d’accès de la Page sur laquelle la vidéo a été initialement publiée.

Obtenir le statut de crosspostage d’une vidéo

Pour déterminer si la vidéo est une vidéo crosspostée, envoyez une requête GET au point de terminaison Vidéo avec le champ is_crosspost_video.

Vous aurez besoin des éléments suivants :

L’ID de la vidéo à vérifier
Un token d’accès de la Page sur laquelle la vidéo a été initialement publiée
L’autorisation publish_video
L’autorisation pages_manage_posts
L’autorisation pages_read_engagement

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

Indiquez les paramètres suivants :

Nom du paramètre	Valeur
`is_crosspost_video`	Indique s’il s’agit de la vidéo d’origine ou d’une vidéo crosspostée.
`access_token`	Token d’accès de la Page sur laquelle la vidéo a été initialement publiée.

Exemple de requête

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

Exemple de réponse

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

Obtenir la liste des Pages éligibles au crosspostage

Vous aurez besoin des éléments suivants :

L’ID de la Page sur laquelle la vidéo a été initialement publiée
Un token d’accès de la Page sur laquelle la vidéo a été initialement publiée
L’autorisation pages_manage_posts
L’autorisation pages_read_engagement

Envoyez une requête GET au point de terminaison Page CrosspostWhitelistedPages.

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

Exemple de requête

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

Exemple de réponse

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

Activer le crosspostage sur toutes vos Pages Business Manager

Pour autoriser le crosspostage sur toutes les Pages gérées par votre Business Manager, envoyez une requête POST au point de terminaison Vidéo.

Vous aurez besoin des éléments suivants :

L’ID de la vidéo à crossposter
Un token d’accès de la Page sur laquelle la vidéo a été initialement publiée
L’autorisation pages_manage_posts
L’autorisation pages_read_engagement

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

Indiquez les paramètres suivants :

Nom du paramètre	Valeur
`allow_bm_crossposting`	Définissez `allow` sur true pour activer le crosspostage ou sur false pour le désactiver.
`access_token`	Token d’accès de la Page sur laquelle la vidéo a été initialement publiée.

Exemple de requête

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

Exemple de réponse

{
  "success": true
}

Insights

Chaque vidéo crosspostée possède son propre video_id unique. Vous pouvez afficher des statistiques de chaque vidéo et chaque Page.

Voir aussi

Pour en savoir plus sur le crosspostage, consultez nos pages d’aide.