Google Business: posztolási szabályok és beállítások
Mit fogad el a Google Business csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
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": [ /* az alábbi elem */ ]
}Allgemeiner Beitrag mit Button
{
"integration": { "id": "<gmb-csatorna>" },
"value": [{ "content": "<p>Új nyitvatartás januártól.</p>", "image": [] }],
"settings": {
"__type": "gmb",
"topicType": "STANDARD",
"callToActionType": "LEARN_MORE",
"callToActionUrl": "https://pelda.hu/nyitvatartas"
}
}Veranstaltung
{
"integration": { "id": "<gmb-csatorna>" },
"value": [{ "content": "<p>Nyílt nap a műhelyben.</p>", "image": [] }],
"settings": {
"__type": "gmb",
"topicType": "EVENT",
"eventTitle": "Nyílt nap",
"eventStartDate": "2026-10-04",
"eventStartTime": "10:00",
"eventEndDate": "2026-10-04",
"eventEndTime": "16:00"
}
}Angebot
{
"integration": { "id": "<gmb-csatorna>" },
"value": [{ "content": "<p>Októberi ajánlat.</p>", "image": [] }],
"settings": {
"__type": "gmb",
"topicType": "OFFER",
"offerCouponCode": "OKT20",
"offerRedeemUrl": "https://pelda.hu/ajanlat",
"offerTerms": "Egy vásárlásra érvényes."
}
}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.