Platformok

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.

Alapadatok

Platform

Google Business

Karakterkorlát

A platform nem ad meg általános korlátot.

Média

Kép vagy videó, opcionálisan.

settings.__type

gmb

Kötelező mezők

Nincs kötelező beállításmező.

A platform oldala

Google Business ütemező

Bejegyzéstípusok

Ugyanaz a csatorna többféle alakú bejegyzést fogad el, és mindegyik mást követel meg. A táblázatból kiderül, melyikhez mi kell.

Típus	Média	Megjegyzés
Általános	kép vagy videó, opcionális	topicType: STANDARD.
Esemény	opcionális	topicType: EVENT. Az esemény címe és időpontja kell hozzá.
Ajánlat	opcionális	topicType: OFFER. Kuponkód és beváltási cím adható meg.

Szabályok

Háromféle bejegyzéstípus van: általános, esemény és ajánlat. Az esemény és az ajánlat saját kötelező mezőket hoz magával.
A gombhoz megadott URL-nek érvényes címnek kell lennie.

Beállításmezők

Ezek a mezők a bejegyzés settings objektumába kerülnek, a __type mező mellé. A felületen ugyanezeket a csatorna lenyíló beállításszakaszában töltöd ki.

Mező	Típus	Kötelező	Mit csinál
topicType	"STANDARD" \| "EVENT" \| "OFFER"	nem	A bejegyzés típusa. Alapértéke az általános.
callToActionType	"NONE" \| "BOOK" \| "ORDER" \| "SHOP" \| "LEARN_MORE" \| "SIGN_UP" \| "GET_OFFER" \| "CALL"	nem	A bejegyzés alatti gomb típusa.
callToActionUrl	string (URL)	nem	A gomb célcíme.
eventTitle	string	nem	Az esemény címe. EVENT típusnál kötelező.
eventStartDate, eventEndDate, eventStartTime, eventEndTime	string	nem	Az esemény kezdete és vége, dátum és idő külön mezőben.
offerCouponCode, offerRedeemUrl, offerTerms	string	nem	Az ajánlat kuponkódja, beváltási címe és feltételei. OFFER típusnál használatos.

Választható értékek

A felsorolt mezők csak ezeket az értékeket fogadják el. Bármilyen más értékre 400-as hibát kapsz, a válasz pedig megnevezi a mezőt.

`topicType`

Érték	Mit jelent
STANDARD	Általános bejegyzés.
EVENT	Esemény, kezdő és záró időponttal.
OFFER	Ajánlat, kuponnal és feltételekkel.

`callToActionType`

Érték	Mit jelent
NONE	Nincs gomb.
BOOK	Foglalás.
ORDER	Rendelés.
SHOP	Vásárlás.
LEARN_MORE	További információ.
SIGN_UP	Regisztráció.
GET_OFFER	Ajánlat igénybevétele.
CALL	Hívás.

Példák

Minden példa egy elem a POST /public/v1/posts kérés posts tömbjében. A körülötte lévő boríték minden esetben ez:

{
  "type": "schedule",
  "date": "2026-09-15T09:00:00.000Z",
  "shortLink": false,
  "posts": [ /* az alábbi elem */ ]
}

Általános bejegyzés gombbal

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

Esemény

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

Ajánlat

{
  "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."
  }
}

A csatorna azonosítóját a csatornalista adja, a képek és videók path értékét pedig a médiafeltöltés. A bekötött fiókra érvényes, pontos sémát a beállítássémát visszaadó végpont adja vissza. Parancssorból ugyanez a --settings kapcsolóval megy, lásd a CLI-példákat.

Hiányzik valami erről az oldalról? Írj a [email protected] címre, vagy használd a Segítség oldal űrlapját.