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.
Základní údaje
gmbTypy příspěvků
Stejný kanál přijímá víc druhů příspěvků. Každý má jiné požadavky. Tabulka ukáže, co k čemu potřebujete.
| Typ | Média | Poznámka |
|---|---|---|
| Obecný | obrázek nebo video, volitelné | topicType: STANDARD. |
| Událost | volitelné | topicType: EVENT. Potřebujete název události a čas. |
| Nabídka | volitelné | topicType: OFFER. Můžete zadat kód kuponu a URL pro uplatnění. |
Pravidla
- Jsou tři typy příspěvků: obecný, událost a nabídka. Událost a nabídka si nesou vlastní povinná pole.
- URL u tlačítka musí být platná adresa.
Pole nastavení
Tato pole jdou do objektu settings příspěvku, vedle pole __type. V rozhraní je vyplníte v rozbalovací sekci nastavení kanálu.
| Pole | Typ | Povinné | Co dělá |
|---|---|---|---|
| topicType | "STANDARD" | "EVENT" | "OFFER" | ne | Typ příspěvku. Výchozí hodnota je obecný. |
| callToActionType | "NONE" | "BOOK" | "ORDER" | "SHOP" | "LEARN_MORE" | "SIGN_UP" | "GET_OFFER" | "CALL" | ne | Typ tlačítka pod příspěvkem. |
| callToActionUrl | string (URL) | ne | Cílová adresa tlačítka. |
| eventTitle | string | ne | Název události. U typu EVENT povinné. |
| eventStartDate, eventEndDate, eventStartTime, eventEndTime | string | ne | Začátek a konec události, datum a čas v oddělených polích. |
| offerCouponCode, offerRedeemUrl, offerTerms | string | ne | Kód kupónu nabídky, adresa pro uplatnění a podmínky. Používá se u typu OFFER. |
Povolené hodnoty
Uvedená pole přijímají jen tyto hodnoty. U jakékoli jiné hodnoty dostanete chybu 400 a odpověď pojmenuje pole.
topicType
| Hodnota | Co znamená |
|---|---|
| STANDARD | Obecný příspěvek. |
| EVENT | Událost se začátkem a koncem. |
| OFFER | Nabídka s kuponem a podmínkami. |
callToActionType
| Hodnota | Co znamená |
|---|---|
| NONE | Žádné tlačítko. |
| BOOK | Rezervace. |
| ORDER | Objednávka. |
| SHOP | Nákup. |
| LEARN_MORE | Další informace. |
| SIGN_UP | Registrace. |
| GET_OFFER | Využití nabídky. |
| CALL | Hovor. |
Příklady
Každý příklad je jedna položka v poli posts požadavku POST /public/v1/posts. Obálka kolem něj je vždy tato:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Obecný příspěvek s tlačítkem
{
"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"
}
}Událost
{
"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"
}
}Nabídka
{
"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."
}
}Identifikátor kanálu získáte ze seznamu kanálů. Hodnoty path u obrázků a videí z nahrání médií. Přesné schéma platné pro propojený účet vrací endpoint se schématem nastavení. Z příkazové řádky to samé uděláte přepínačem --settings, viz příklady CLI.