Synupv1
Schlüssel erstellen
v1Ressourcen/Posts/postBeitrag erstellen

Beitrag erstellen

Erstellt einen Beitrag für einen Standort oder Kunden und übermittelt ihn an die ausgewählten Plattformen. Dies veröffentlicht echten Inhalt: Sofern nicht scheduledFor gesetzt oder draft true ist, geht der Beitrag sofort auf seinen Zielplattformen live. Eine angeforderte Plattform ohne aktive Verbindung, oder ein Beitrag, dem ein für die Veröffentlichung erforderliches Feld fehlt, lässt den Aufruf nie fehlschlagen — der Inhalt wird stattdessen als Entwurf gespeichert; siehe das Antwortschema dafür, wie das gemeldet wird.

post/api/v1/posts
posts:write
Anfragetext
locationIdstringoptional
Der Standort, an den gepostet werden soll. Geben Sie diesen oder clientId an.
clientIdstringoptional
Der Kunde, für den auf Markenebene gepostet werden soll. Geben Sie diesen oder locationId an.
namestringerforderlich
Interner Name/Bezeichnung des Beitrags. Erforderlich, nicht leer.
postTypestring (announcement | event | offer)erforderlich
Beitragstyp. event und offer sind Google-exklusiv.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok)erforderlich
Zielplattformen. Mindestens eine ist erforderlich.
connectionIdsarray of stringoptional
Explizite Verbindungs-IDs, über die veröffentlicht werden soll, anstatt Plattformen zu Verbindungen aufzulösen.
messageGooglestringoptional
Text für Google. Erforderlich, wenn google ausgewählt ist, außer bei draft.
messageFacebookstringoptional
Gemeinsam genutzter Social-Text für jede ausgewählte Nicht-Google-Plattform. Erforderlich, außer bei draft.
ctaTypestring (learn_more | sign_up | order_online | book | buy | call_now)optional
Call-to-Action-Typ.
ctaUrlstringoptional
Ziel-URL des Call-to-Action.
mediaUrlsarray of objectoptional
Anzuhängende Medien, ein Eintrag je Plattform-Anhang.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Titel des Events oder Angebots. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventStartAtstringoptional
Start des Events oder Angebots, als ISO-8601-Zeitstempel. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventEndAtstringoptional
Ende des Events oder Angebots, als ISO-8601-Zeitstempel. Muss nach dem Start liegen.
offerTermsstringoptional
Bedingungen des Angebots.
offerCouponCodestringoptional
Gutscheincode des Angebots.
offerRedeemUrlstringoptional
Einlöse-URL des Angebots.
scheduledForstringoptional
Zu diesem zukünftigen ISO-8601-Zeitstempel veröffentlichen, anstatt sofort.
draftbooleanoptional
Ohne Veröffentlichung speichern. Überspringt Pflichtfeld-Prüfungen; strukturelle Prüfungen (Limits, Medienregeln) gelten weiterhin.
Antwort
dataobjectoptional
Eine angeforderte Plattform ohne aktive Verbindung, oder ein Pflichtfeld, das der Beitrag benötigt, bevor er live gehen kann, lässt diesen Aufruf nie fehlschlagen — der Beitrag wird trotzdem gespeichert. Liegt eine dieser Lücken vor, ist status "no_connection" oder "incomplete", und der Beitrag liegt darunter als post.{id,status}; bei einer sauberen Veröffentlichung beschreiben id/status auf oberster Ebene den Beitrag direkt.
idstringoptional
Eindeutige Kennung des Beitrags.
statusstringoptional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
missingFieldsarray of stringoptional
Felder, die vor der Veröffentlichung dieses Beitrags noch benötigt werden, falls vorhanden.
missingPlatformsarray of stringoptional
Angeforderte Plattformen ohne aktive Verbindung, falls vorhanden.
scopestring (location | client)optional
Ob die Verbindungs-/Feld-Lücke auf Standort- oder Kundenebene gilt.
postobjectoptional
Der erstellte oder aktualisierte Beitrag.
idstringoptional
Eindeutige Kennung des Beitrags.
statusstringoptional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/posts
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "id": "cm_post_abc123",
    "status": "scheduled"
  }
}