Post di Threads

Puoi usare l'API Threads per pubblicare post con immagini, video, testo o carosello.

Questo documento tratta i seguenti argomenti:

• Post di Threads singoli
• Post carosello
• Tag degli argomenti e link nei post

Post di Threads singoli

Pubblicare un singolo post con immagine, video o testo è un processo che implica due passaggi:

1. Usa l'endpoint POST /{threads-user-id}/threads per creare un contenitore multimediale usando un'immagine o un video ospitati sul tuo server pubblico e con testo facoltativo. In alternativa, usa questo endpoint per creare un contenitore multimediale con solo testo.
2. Usa l'endpoint POST /{threads-user-id}/threads_publish per pubblicare il contenitore.

Limitazioni

• I post di testo sono limitati a 500 caratteri.

Passaggio 1: crea un contenitore multimediale di Threads

Usa l'endpoint POST /{threads-user-id}/threads per creare un contenitore multimediale di Threads.

Parametri

I seguenti parametri sono obbligatori. Per ulteriori parametri supportati fare riferimento al riferimento per l'endpoint POST /{threads-user-id}/threads.

• is_carousel_item: il valore predefinito è false per i post con thread singolo. Indica un'immagine o un video che saranno visualizzati in un carosello.
• image_url (solo per le immagini): il percorso all'immagine. Useremo la funzione cURL con l'immagine utilizzando l'URL fornito, quindi l'immagine deve trovarsi su un server pubblico.
• media_type: impostalo su TEXT, IMAGE o VIDEO. Indica il tipo di contenuto multimediale corrente. Nota: il tipo CAROUSEL non è disponibile per i post con thread singoli.
• video_url (solo per i video): il percorso al video. Sottoporremo il tuo video a cURL utilizzando l'URL fornito, quindi il video deve trovarsi su un server pubblico.
• text: il testo associato al post. Il primo URL incluso nel campo text verrà utilizzato come anteprima del link per il post. Per i post di solo testo, questo parametro è obbligatorio.

Esempio di richiesta

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=IMAGE&image_url=https://www.example.com/images/bronz-fonz.jpg&text=#BronzFonz&access_token=<ACCESS_TOKEN>"

Esempio di risposta

{
  "id": "1234567" // Threads Media Container ID
}

Passaggio 2: pubblica un contenitore multimediale di Threads

Usa l'endpoint POST /{ig-user-id}/media_publish per pubblicare l'ID contenitore restituito nel corso del passaggio precedente. Si consiglia di aspettare in media 30 secondi prima di pubblicare un contenitore multimediale Threads per dare al nostro server il tempo sufficiente per elaborare completamente il caricamento. Consulta l'endpoint media container status per maggiori dettagli.

Parametri

• creation_id: identificatore del contenitore del contenuto multimediale di Threads creato dall'endpoint /threads.

Esempio di richiesta

curl -i -X POST \ 
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish?creation_id=<MEDIA_CONTAINER_ID>&access_token=<ACCESS_TOKEN>"

Esempio di risposta

{
  "id": "1234567" // Threads Media ID
}

Post carosello

In un post carosello puoi pubblicare fino a 20 immagini, video o un mix di immagini e video. La procedura di pubblicazione di caroselli si compone di tre passaggi:

1. Usa l'endpoint POST /{threads-user-id}/threads per creare singoli contenitori di elementi per ogni immagine o video che saranno inclusi nel carosello.
2. Usa nuovamente l'endpoint POST /{threads-user-id}/threads per creare un singolo contenitore carosello per gli elementi.
3. Usa l'endpoint POST /{threads-user-id}/threads_publish per la pubblicazione del contenitore carosello.

Ai fini del rate limiting del profilo, i post carosello vengono conteggiati come un singolo post.

Limitazioni

• I caroselli sono limitati a 20 immagini, video o un mix di immagini e video.
• Per i caroselli sono necessari almeno due elementi secondari.

Passaggio 1: creare un contenitore di elementi

Usa l'endpoint POST /{threads-user-id}/threads per creare un contenitore di articoli per l'immagine o il video che apparirà in un carosello.

Parametri

I seguenti parametri sono obbligatori. Per ulteriori parametri supportati fare riferimento al riferimento per l'endpoint POST /{threads-user-id}/threads.

• is_carousel_item: impostato su true. Indica che l'immagine o il video sarà visibile in un carosello.
• image_url (solo per le immagini): il percorso all'immagine. Useremo la funzione cURL con l'immagine utilizzando l'URL passato, quindi l'immagine deve trovarsi su un server pubblico.
• media_type: impostato su IMAGE o VIDEO. Indica che il contenuto multimediale è un'immagine o un video.
• video_url (solo per i video): il percorso al video. Useremo la funzione cURL con il video utilizzando l'URL passato, quindi il video deve trovarsi su un server pubblico.

Nota: sebbene il campo text sia facoltativo per i post carosello, il primo URL incluso nel campo text sarà usato come anteprima del link per il post.

Se l'operazione va a buon fine, l'API restituirà un ID contenitore di elementi che può essere utilizzato durante la creazione del contenitore carosello.

Ripeti questa procedura per ogni immagine o video da includere nel carosello.

Esempio di richiesta

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?image_url=https%3A%2F%2Fsol...&is_carousel_item=true&access_token=<ACCESS_TOKEN>"

Esempio di risposta

{
  "id": "1234567"
}

Passaggio 2: creare un contenitore carosello

Usa l'endpoint POST /{threads-user-id}/threads per creare un contenitore carosello.

Parametri

I seguenti parametri sono obbligatori. Per ulteriori parametri supportati fare riferimento al riferimento per l'endpoint POST /{threads-user-id}/threads.

• media_type: impostato su CAROUSEL. Indica che il contenitore è per un carosello.
• children: una lista separata da virgole di massimo 20 ID contenitore di ogni immagine e/o video che devono essere visualizzati nel carosello pubblicato. I caroselli possono contenere almeno 2 e massimo 20 immagini o video o un mix di immagini e video.
• text - (Facoltativo.) Il testo associato al post.

Esempio di richiesta

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=CAROUSEL&children=<MEDIA_ID_1>,<MEDIA_ID_2>,<MEDIA_ID_3>&access_token=<ACCESS_TOKEN>"

Esempio di risposta

{
  "id": "1234567"
}

Passaggio 3: pubblicare il contenitore carosello

Usa l'endpoint POST /{threads-user-id}/threads_publish per pubblicare un post carosello. I profili hanno un limite di pubblicazione di 250 post entro 24 ore. La pubblicazione di un carosello viene conteggiata come un singolo post.

Parametri

I seguenti parametri sono obbligatori.

• creation_id: l'ID del contenitore carosello.

Se l'operazione viene eseguita correttamente, l'API restituisce l'ID del contenuto multimediale di Threads di un album carosello.

Esempio di richiesta

curl -i -X POST \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish?creation_id=<MEDIA_CONTAINER_ID>&access_token=<ACCESS_TOKEN>"

Esempio di risposta

{
  "id": "1234567" // Threads Media ID
}

Tag degli argomenti e link nei post

Gli argomenti e i link vengono visualizzati nei post in modo tale da incoraggiare le interazioni.

Tag degli argomenti

Gli argomenti rendono i post più social consentendo argomenti centrali di discussione. Puoi includere un argomento in un post utilizzando il parametro topic_tag o includendo un tag nel testo di un post.

Utilizzo del parametro topic_tag

Nota: i seguenti caratteri non sono permessi nei tag degli argomenti:

• Punti (.)
• E commerciali (&)

curl -i -X POST \  
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=TEXT&text=Text&access_token=<ACCESS_TOKEN>"
  -d topic_tag=TAG

Utilizzo di un tag dell'argomento nel testo

Nota: questo metodo non è il preferito, ma viene mantenuto per la retrocompatibilità.

Un argomento può essere allegato anche a un post includendone uno in linea nel testo del post. È consentito un solo tag dell'argomento per post, quindi il primo tag valido incluso in un post di qualsiasi tipo (solo testo, immagine, video, carosello) tramite l'API viene considerato il tag per quel post.

Informazioni da ricordare quando si aggiunge un tag dell'argomento a un post utilizzando un tag nel testo:

• I tag validi iniziano con un simbolo cancelletto (#).
• Anche il testo è configurato nell'app senza il simbolo cancelletto.
• Numeri interi preceduti da un simbolo cancelletto (ad esempio, #1) non vengono convertiti in tag. Questo perché si presume che in questo scenario # indichi il simbolo del numero in lingua inglese.
• I seguenti caratteri non sono consentiti quando si usano i tag nel testo con l'API Threads, quindi qualsiasi tag nel testo che inizia con un simbolo cancelletto terminerà subito prima di questi caratteri:

  • Spazio, segno di tabulazione, carattere di nuova riga
  • Punti (.)
  • E commerciali (&)
  • Chiocciola (@)
  • Punto esclamativo (!)
  • Punto di domanda (?)
  • Virgola (,)
  • Punto e virgola (;)
  • Due punti (:)

Link

Per allegare un link al post, usa il parametro link_attachment quando crei un elemento multimediale. Se non viene fornito alcun parametro link_attachment, il primo link creato in un post di solo testo tramite l'API viene configurato come link allegato, che viene visualizzato come scheda di anteprima, per facilitare l'interazione e il clic.

Limitazioni

• Questa funzione è disponibile solo per i post di solo testo. Non funziona su post con immagini, video e carosello.

Pubblicazione

I link possono essere allegati quando si fa una richiesta all'endpoint POST /threads di creare un elemento multimediale. Assicurati di includere il seguente parametro con la tua richiesta API:

• link_attachment (per i post di solo testo): l'URL che dovrebbe essere allegato a un post di Threads e visualizzato come anteprima del link. Deve essere un URL valido e accessibile pubblicamente.

Esempio di richiesta

curl -i -X POST \  
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads?media_type=TEXT&text=Link&access_token=<ACCESS_TOKEN>" 
  -d link_attachment=https://developers.facebook.com/

Esempio di risposta

{
  "id": "1234567" // Threads Media Container ID
}

La richiesta sopra crea un contenitore post di Threads che, una volta pubblicato, allegherà un link di anteprima al contenuto multimediale.

Recupero dei contenuti multimediali

Il valore dell'URL del link allegato può essere recuperato quando si fa una richiesta all'endpoint GET /threads o GET /{threads_media_id} per recuperare elementi multimediali. Assicurati di includere il seguente campo nella tua richiesta API:

• link_attachment_url: l'URL allegato a un post di Threads.

Esempio di richiesta

curl -s -X GET \ "https://graph.threads.net/v1.0/<THREADS_MEDIA_ID>?fields=id,link_attachment_url&access_token=<ACCESS_TOKEN>"

Esempio di risposta

{
   "id": "12312312312123",
   "link_attachment_url": "https://developers.facebook.com/",
}

Specifiche contenuti multimediali