Threads-Beiträge

Mit der Threads API kannst du Bild-, Video-, Text- oder Carousel-Beiträge veröffentlichen.

In diesem Dokument wird Folgendes behandelt:

• Einfache Threads-Beiträge
• Carousel-Beiträge
• Themen-Tags und Links in Beiträgen

Einfache Threads-Beiträge

Zum Veröffentlichen einfacher Bild-, Video- oder Textbeiträge sind zwei Schritte nötig:

1. Erstelle mit dem Endpunkt POST /{threads-user-id}/threads einen Mediencontainer mit einem auf deinem öffentlichen Server gehosteten Bild oder Video und einem optionalen Text. Alternativ kannst du diesen Endpunkt verwenden, um einen Mediencontainer nur mit Text zu erstellen.
2. Verwende dann den Endpunkt POST /{threads-user-id}/threads_publish, um den Container zu veröffentlichen.

Einschränkungen

• Textbeiträge dürfen maximal 500 Zeichen enthalten.

Schritt 1: Threads-Mediencontainer erstellen

Verwende den POST /{threads-user-id}/threads-Endpunkt, um einen Threads-Mediencontainer zu erstellen.

Parameter

Die folgenden Parameter sind erforderlich. Informationen zu weiteren unterstützten Parametern findest du in der Referenz zum POST /{threads-user-id}/threads-Endpunkt.

• is_carousel_item – Der Standardwert ist false für einzelne Threads-Beiträge. Gibt an, dass ein Bild oder Video in einem Carousel erscheint.
• image_url – (Nur für Bilder.) Der Pfad zum Bild. Wir verwenden die URL deines Bilds in einem cURL-Befehl. Daher muss es sich auf einem öffentlichen Server befinden.
• media_type – Entweder TEXT, IMAGE oder VIDEO. Gibt den aktuellen Medientyp an. Hinweis: Der TypCAROUSEL wird für einzelne Threads-Beiträge nicht unterstützt.
• video_url – (Nur für Videos.) Pfad zum Video. Wir verwenden die URL deines Videos in einem cURL-Befehl. Daher muss es sich auf einem öffentlichen Server befinden.
• text – Der Text für den Beitrag. Die erste URL im Feld text wird als Link-Vorschau für den Beitrag verwendet. Für reine Textbeiträge ist dieser Parameter erforderlich.

Beispielanfrage

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

Beispielantwort

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

Schritt 2: Threads-Mediencontainer veröffentlichen

Verwende den Endpunkt POST /{threads-user-id}/threads_publish, um die im vorherigen Schritt zurückgegebene Container-ID zu veröffentlichen. Warte nach Möglichkeit etwa 30 Sekunden, bevor du einen Threads-Mediencontainer veröffentlichst, um unserem Server genug Zeit zu geben, den Uplad zu verarbeiten. Weitere Informationen findest du unter Publishing Does Not Return a Media ID.

Parameter

• creation_id – ID des Threads-Mediencontainers, der mit dem /threads-Endpunkt erstellt wurde.

Beispielanfrage

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

Beispielantwort

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

Carousel-Posts

Du kannst bis zu 20 Bilder und/oder Videos in einem einzigen Carousel-Beitrag veröffentlichen. Das Veröffentlichen von Carousels besteht aus drei Schritten:

1. Verwende den POST /{threads-user-id}/threads-Endpunkt, um Einzelelementcontainer für jedes im Carousel erscheinende Bild und Video zu erstellen.
2. Verwende den POST /{threads-user-id}/threads-Endpunkt erneut, um einen einzelnen Carousel-Container für die Elemente zu erstellen.
3. Verwende den POST /{threads-user-id}/threads_publish-Endpunkt, um den Carousel-Container zu veröffentlichen.

Carousel-Beiträge zählen als Einzelbeiträge für die Durchsatzratenbegrenzung des Profils.

Einschränkungen

• Carousels sind auf jeweils 20 Bilder und/oder Videos begrenzt.
• Carousels müssen mindestens 2 untergeordnete Elemente enthalten.

Schritt 1: Elementcontainer erstellen

Verwende den POST /{threads-user-id}/threads-Endpunkt, um einen Elementcontainer für das Bild oder Video zu erstellen, das in einem Carousel erscheinen soll.

Parameter

Die folgenden Parameter sind erforderlich. Informationen zu weiteren unterstützten Parametern findest du in der Referenz zum POST /{threads-user-id}/threads-Endpunkt.

• is_carousel_item: Setze diesen Parameter auf true. Gibt an, dass das Bild oder Video in einem Carousel erscheint.
• image_url – (Nur für Bilder.) Der Pfad zum Bild. Wir verwenden die übergebene URL deines Bilds in einem cURL-Befehl. Daher muss es auf einem öffentlichen Server gespeichert sein.
• media_type – Setze diesen Parameter auf IMAGE oder VIDEO. Gibt an, dass das Medium ein Bild oder ein Video ist.
• video_url – (Nur für Videos.) Pfad zum Video. Wir verwenden die übergebene URL deines Videos in einem cURL-Befehl. Daher muss es auf einem öffentlichen Server gespeichert sein.

Hinweis: Das text-Feld ist zwar optional für Carousel-Beiträge, aber die erste URL, die im text-Feld auftaucht, wird als Link-Vorschau für den Beitrag verwendet.

Wenn der Vorgang erfolgreich ist, gibt die API eine Elementcontainer-ID zurück, die beim Erstellen des Carousel-Containers verwendet werden kann.

Wiederhole diesen Vorgang für alle Bilder oder Videos, die im Carousel erscheinen sollen.

Beispielanfrage

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

Beispielantwort

{
  "id": "1234567"
}

Schritt 2: Carousel-Container erstellen

Verwende den POST /{threads-user-id}/threads-Endpunkt, um einen Carousel-Container zu erstellen.

Parameter

Die folgenden Parameter sind erforderlich. Informationen zu weiteren unterstützten Parametern findest du in der Referenz zum POST /{threads-user-id}/threads-Endpunkt.

• media_type – Setze diesen Parameter auf CAROUSEL. Gibt an, dass der Container für ein Carousel verwendet wird.
• children – Ein Array mit bis zu 20 Container-IDs der Bilder und/oder Videos, die im veröffentlichten Carousel erscheinen sollen. Carousels können zwischen 2 und 20 Bilder und/oder Videos enthalten.
• text – (Optional.) Der Text für den Beitrag.

Beispielanfrage

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

Beispielantwort

{
  "id": "1234567"
}

Schritt 3: Carousel-Container veröffentlichen

Verwende den POST /{threads-user-id}/threads_publish-Endpunkt, um einen Carousel-Beitrag zu veröffentlichen. Jedes Profil kann innerhalb von 24 Stunden maximal 250 Beiträge veröffentlichen. Ein Carousel gilt dabei als einzelner Beitrag.

Parameter

Die folgenden Parameter sind erforderlich.

• creation_id – Die Carousel-Container-ID.

Wenn der Vorgang erfolgreich ist, gibt die API die Threads-Medien-ID des Carousel-Albums zurück.

Beispielanfrage

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

Beispielantwort

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

Themen-Tags und Links in Beiträgen

Themen und Links erscheinen in Beiträgen, um Interaktionen zu fördern.

Themen-Tags

Themen ermöglichen zentrale Diskussionsthemen, um Beiträge interaktiver zu machen. Du kannst Themen in Beiträge einfügen, indem du entweder den topic_tag-Parameter verwendest oder einen Tag direkt im Text des Beitrags angibst.

topic_tag-Parameter verwenden

Hinweis: Die folgenden Zeichen sind in Themen-Tags nicht zulässig:

• Punkt (.)
• Ampersand (&)

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

Themen-Tags im Text verwenden

Hinweis: Diese Methode ist nicht optimal, wird jedoch aus Gründen der Abwärtskompatibilität beibehalten.

Du kannst auch ein Thema an einen Beitrag anhängen, indem du es inline im Beitragstext einfügst. Pro Beitrag ist nur ein Themen-Tag zulässig. Daher wird der erste gültige Tag in einem Beitrag über die API als Tag für den entsprechenden Beitrag verwendet – unabhängig von seinem jeweiligen Typ (nur Text, Bild, Video, Carousel).

Beachte beim Hinzufügen von Themen-Tags zu Beiträgen die folgenden wichtigen Informationen:

• Gültige Tags beginnen mit einem Hash-Zeichen (#).
• Der Text wird in der App auch ohne das Hash-Zeichen konfiguriert.
• Ganze Zahlen mit voranstehendem Hash-Zeichen (z. B. #1) werden nicht in Tags umgewandelt. Dies liegt daran, dass davon ausgegangen wird, dass das Hash-Zeichen in diesem Szenario als numerisches Zeichen verwendet wurde.
• Die folgenden Zeichen sind beim Verwenden von Tags im Beitragstext mit der Threads API nicht zulässig. Tags im Beitragstext, die mit einem Hash-Zeichen beginnen, werden daher vor diesen Zeichen abgeschnitten:

  • Leerzeichen, Tabulator, Zeilenumbrüche
  • Punkt (.)
  • Ampersand (&)
  • At-Zeichen (@)
  • Ausrufezeichen (!)
  • Fragezeichen (?)
  • Komma (,)
  • Semikolon (;)
  • Doppelpunkt (:)

Links

Verwende den link_attachment-Parameter beim Erstellen eines Medienobjekts, um deinem Beitrag einen Link anzuhängen. Wenn du keinen link_attachment-Parameter angibst, wird der erste Link in einem reinen Textbeitrag mit der API als Link-Anhang konfiguriert. Dieser Anhang wird als Vorschaukarte angezeigt, um Interaktionen und Klicks zu vereinfachen.

Einschränkungen

• Diese Funktion ist nur für reine Textbeiträge verfügbar. Sie ist für Bild-, Video- und Carousel-Beiträge nicht verfügbar.

Veröffentlichung

Du Links anhängen, wenn du eine Anfrage an den POST /threads-Endpunkt stellst, um ein Medienobjekt zu erstellen. Deine API-Anfrage muss den folgenden Parameter enthalten:

• link_attachment – (Nur für Textbeiträge.) Die URL, die an einen Threads-Beitrag angehängt und als Link-Vorschau angezeigt werden soll. Dieses Feld muss eine gültige, öffentlich erreichbare URL enthalten.

Beispielanfrage

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/

Beispielantwort

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

Die obige Anfrage erstellt einen Threads-Beitragscontainer, der nach der Veröffentlichung eine Link-Vorschau an dein Medium anhängt enthält.

Medien abrufen

Du kannst den Wert des Link-Anhangs abrufen, wenn du eine Anfrage an den GET /threads- oder GET /{threads_media_id}-Endpunkt stellst, um Medienobjekte abzurufen. Deine API-Anfrage muss das folgende Feld enthalten:

• link_attachment_url – Die an einen Threads-Beitrag angehängte URL.

Beispielanfrage

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

Beispielantwort

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

Medienspezifikationen