Google Business: Posting-Regeln und Einstellungen
Was der Kanal Google Business in Posty annimmt: Medien, Limits, Pflichtfelder, und die Felder des settings-Objekts für die API.
Der Kanal Google Business ist fertig, aber die Plattform hat die Verbindung noch nicht freigegeben. Deshalb kannst du ihn heute noch nicht verbinden. Die Felder unten nimmt Posty nach der Freigabe an.
Eckdaten
gmbBeitragstypen
Derselbe Kanal akzeptiert mehrere Beitragstypen. Jeder verlangt etwas anderes. Die Tabelle zeigt, was du wofür brauchst.
| Typ | Medien | Hinweis |
|---|---|---|
| Allgemein | Bild oder Video, optional | topicType: STANDARD. |
| Veranstaltung | optional | topicType: EVENT. Titel und Zeitpunkt der Veranstaltung sind nötig. |
| Angebot | optional | topicType: OFFER. Gutscheincode und Einlöse-URL kannst du angeben. |
Regeln
- Es gibt drei Beitragstypen: allgemein, Event und Angebot. Event und Angebot bringen eigene Pflichtfelder mit.
- Die URL am Button muss eine gültige Adresse sein.
Einstellungsfelder
Diese Felder kommen in das settings-Objekt des Beitrags, neben das Feld __type. In der Oberfläche füllst du dieselben im Einstellungsbereich des Kanals aus.
| Feld | Typ | Pflicht | Was es tut |
|---|---|---|---|
| topicType | "STANDARD" | "EVENT" | "OFFER" | nein | Der Beitragstyp. Die Vorgabe ist allgemein. |
| callToActionType | "NONE" | "BOOK" | "ORDER" | "SHOP" | "LEARN_MORE" | "SIGN_UP" | "GET_OFFER" | "CALL" | nein | Der Typ des Buttons unter dem Beitrag. |
| callToActionUrl | string (URL) | nein | Die Zieladresse des Buttons. |
| eventTitle | string | nein | Der Titel des Events. Beim Typ EVENT Pflicht. |
| eventStartDate, eventEndDate, eventStartTime, eventEndTime | string | nein | Beginn und Ende des Events, Datum und Uhrzeit in getrennten Feldern. |
| offerCouponCode, offerRedeemUrl, offerTerms | string | nein | Gutscheincode, Einlöse-URL und Bedingungen des Angebots. Wird beim Typ OFFER verwendet. |
Zulässige Werte
Die aufgeführten Felder akzeptieren nur diese Werte. Bei jedem anderen Wert bekommst du einen 400er-Fehler. Die Antwort nennt das Feld.
topicType
| Wert | Bedeutung |
|---|---|
| STANDARD | Allgemeiner Beitrag. |
| EVENT | Veranstaltung, mit Start- und Endzeit. |
| OFFER | Angebot, mit Gutschein und Bedingungen. |
callToActionType
| Wert | Bedeutung |
|---|---|
| NONE | Kein Button. |
| BOOK | Buchen. |
| ORDER | Bestellen. |
| SHOP | Einkaufen. |
| LEARN_MORE | Weitere Informationen. |
| SIGN_UP | Registrieren. |
| GET_OFFER | Angebot einlösen. |
| CALL | Anrufen. |
Beispiele
Jedes Beispiel ist ein Element im posts-Array der Anfrage POST /public/v1/posts. Der Rahmen darum ist immer dieser:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* das Element unten */ ]
}Allgemeiner Beitrag mit Button
{
"integration": { "id": "<gmb-kanal>" },
"value": [{ "content": "<p>Neue Öffnungszeiten ab Januar.</p>", "image": [] }],
"settings": {
"__type": "gmb",
"topicType": "STANDARD",
"callToActionType": "LEARN_MORE",
"callToActionUrl": "https://beispiel.de/oeffnungszeiten"
}
}Veranstaltung
{
"integration": { "id": "<gmb-kanal>" },
"value": [{ "content": "<p>Tag der offenen Tür in der Werkstatt.</p>", "image": [] }],
"settings": {
"__type": "gmb",
"topicType": "EVENT",
"eventTitle": "Tag der offenen Tür",
"eventStartDate": "2026-10-04",
"eventStartTime": "10:00",
"eventEndDate": "2026-10-04",
"eventEndTime": "16:00"
}
}Angebot
{
"integration": { "id": "<gmb-kanal>" },
"value": [{ "content": "<p>Angebot im Oktober.</p>", "image": [] }],
"settings": {
"__type": "gmb",
"topicType": "OFFER",
"offerCouponCode": "OKT20",
"offerRedeemUrl": "https://beispiel.de/angebot",
"offerTerms": "Gültig für einen Einkauf."
}
}Die Kanalliste liefert die Kanal-ID, der Medien-Upload den path-Wert für Bilder und Videos. Das genaue Schema für das verbundene Konto gibt der Endpunkt für das Einstellungsschema zurück. Von der Kommandozeile aus geht dasselbe mit dem Flag --settings, siehe die CLI-Beispiele.