Cross-posting - API Video - Documentazione

Cross-posting di un video

Questo documento spiega come utilizzare l'API Video per pubblicare un video su più Pagine senza dover caricare il video su ciascuna Pagina. Ad esempio, se hai una Pagina principale con diverse pagine secondarie, puoi caricare e pubblicare un video sulla Pagina principale e poi pubblicarlo su tutte le Pagine secondarie senza doverlo caricare su ciascuna Pagina.

Per effettuare il cross-posting di un video, devi essere in grado di eseguire l'attività CREATE sulle Pagine e abilitare la pubblicazione del video su Pagine specifiche. Avrai bisogno dell'ID del video e degli ID delle Pagine in cui desideri pubblicare il video, nonché dei token d'accesso della Pagina in cui il video è stato pubblicato originariamente e di quelle in cui vuoi pubblicarlo.

Puoi utilizzare l'API per determinare se un video è già idoneo per il cross-posting o se si tratta di un video con cross-posting, per sapere come abilitare il cross-posting per tutte le Pagine gestite dal tuo Business Manager e per ottenere una lista di Pagine su cui poter eseguire il cross-posting.

Consulta la nostra Guida a Reels Publishing per informazioni sul cross-posting di un reel sulla Pagina Facebook di un collaboratore.

Limitazioni

Se un video è stato sottoposto a cross-posting sulla tua Pagina ma non hai un ruolo nella Pagina dove il video è stato pubblicato originariamente, non puoi modificare le autorizzazioni del video.

Passaggio 1. Abilitazione del cross-posting

Per pubblicare un video su più Pagine è necessario abilitare il cross-posting del video su queste Pagine.

Ecco cosa ti servirà:

L'ID del video di cui eseguire il cross-posting
Gli ID delle Pagine in cui desideri pubblicare il video
Un token d'accesso della Pagina in cui il video è stato originariamente pubblicato
L'autorizzazione publish_video
L'autorizzazione pages_manage_posts
L'autorizzazione pages_read_engagement

Invia una richiesta POST all'endpoint Video:

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}

Includi i seguenti parametri:

Nome del parametro	Valore
`allow_crossposting_for_pages`	Un array JSON di ID delle Pagine in cui desideri pubblicare il video. Imposta `allow` su `true` per abilitare la pubblicazione o su `false` per disabilitarla.
`access_token`	Il token d'accesso della Pagina in cui il video è stato originariamente pubblicato.

Esempio di richiesta

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

Esempio di risposta

{
  "success": true
}

Passaggio 2. Cross-posting del video

Ecco cosa ti servirà:

L'ID del video di cui eseguire il cross-posting
L'ID della Pagina in cui desideri pubblicare il video
Un token d'accesso della Pagina in cui desideri pubblicare il video
L'autorizzazione publish_video
L'autorizzazione pages_manage_posts
L'autorizzazione pages_read_engagement

Invia una richiesta POST all'endpoint Page Videos:

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

Includi i seguenti parametri:

Nome del parametro	Valore
`crossposted_video_id`	L'ID del video di cui eseguire il cross-posting.
`access_token`	Il token d'accesso della Pagina in cui pubblicare il video.

Esempio di richiesta

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

Esempio di risposta JSON

{
  "id":"577600939847873"
}

Idoneità per il cross-posting di un video

Per determinare se un video è idoneo per il cross-posting, invia una richiesta GET all'endpoint Video con il campo is_crossposting_eligible.

Ecco cosa ti servirà:

L'ID del video di cui eseguire il cross-posting
Un token d'accesso della Pagina in cui il video è stato originariamente pubblicato
L'autorizzazione pages_manage_posts
L'autorizzazione pages_read_engagement

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

Esempio di richiesta

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

Esempio di risposta

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

Nome del parametro	Valore
`is_crossposting_eligible`	Viene visualizzato se il video è abilitato per il cross-posting.
`access_token`	Il token d'accesso della Pagina in cui il video è stato originariamente pubblicato.

Stato del cross-posting di un video

Per determinare se un video è stato sottoposto a cross-posting, invia una richiesta GET all'endpoint Video con il campo is_crosspost_video.

Ecco cosa ti servirà:

L'ID del video da controllare
Un token d'accesso della Pagina in cui il video è stato originariamente pubblicato
L'autorizzazione publish_video
L'autorizzazione pages_manage_posts
L'autorizzazione pages_read_engagement

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

Includi i seguenti parametri

Nome del parametro	Valore
`is_crosspost_video`	Viene visualizzato se il video è l'originale o è stato sottoposto a cross-posting.
`access_token`	Il token d'accesso della Pagina in cui il video è stato originariamente pubblicato.

Esempio di richiesta

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

Esempio di risposta

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

Acquisizione di una lista di Pagine idonee per il cross-posting

Ecco cosa ti servirà:

L'ID della Pagina in cui è stato originariamente pubblicato il video
Un token d'accesso della Pagina in cui il video è stato originariamente pubblicato
L'autorizzazione pages_manage_posts
L'autorizzazione pages_read_engagement

Invia una richiesta GET all'endpoint CrosspostWhitelistedPages della Pagina.

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

Esempio di richiesta

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

Esempio di risposta

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

Abilitazione del cross-posting per tutte le Pagine del tuo Business Manager

Per abilitare il cross-posting per tutte le Pagine gestite dal tuo Business Manager, invia una richiesta POST all'endpoint Video.

Ecco cosa ti servirà:

L'ID del video di cui eseguire il cross-posting
Un token d'accesso della Pagina in cui il video è stato originariamente pubblicato
L'autorizzazione pages_manage_posts
L'autorizzazione pages_read_engagement

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

Includi i seguenti parametri

Nome del parametro	Valore
`allow_bm_crossposting`	Imposta `allow` su true per abilitare la pubblicazione o su false per disabilitarla.
`access_token`	Il token d'accesso della Pagina in cui il video è stato originariamente pubblicato.

Esempio di richiesta

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

Esempio di risposta

{
  "success": true
}

Insight

Ogni video con cross-posting ha il suo video_id unico. Puoi vedere gli insight di un video da ogni video e Pagina.

Altri contenuti da consultare

Per ulteriori informazioni sul cross-posting, visita il nostro Centro assistenza.