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.
Basics
gmbPost types
The same channel accepts more than one kind of post, and each kind has different requirements. The table shows what you need for each.
| Type | Media | Notes |
|---|---|---|
| General | image or video, optional | topicType: STANDARD. |
| Event | optional | topicType: EVENT. You need the event title and time. |
| Offer | optional | topicType: OFFER. You can include a coupon code and a redemption URL. |
Rules
- There are three post types: standard, event, and offer. Event and offer come with their own required fields.
- The URL set for the button must be a valid address.
Settings fields
These fields go into the post's settings object, alongside the __type field. In the UI, you fill in the same ones in the channel's settings section.
| Field | Type | Required | What it does |
|---|---|---|---|
| topicType | "STANDARD" | "EVENT" | "OFFER" | no | The post type. The default is standard. |
| callToActionType | "NONE" | "BOOK" | "ORDER" | "SHOP" | "LEARN_MORE" | "SIGN_UP" | "GET_OFFER" | "CALL" | no | The type of button under the post. |
| callToActionUrl | string (URL) | no | The button's destination URL. |
| eventTitle | string | no | The event title. Required for the EVENT type. |
| eventStartDate, eventEndDate, eventStartTime, eventEndTime | string | no | The event start and end, with date and time in separate fields. |
| offerCouponCode, offerRedeemUrl, offerTerms | string | no | The offer's coupon code, redemption URL, and terms. Used with the OFFER type. |
Allowed values
The fields below only accept these values. Any other value returns a 400, and the response names the field.
topicType
| Value | Meaning |
|---|---|
| STANDARD | General post. |
| EVENT | Event, with a start and end time. |
| OFFER | Offer, with a coupon and terms. |
callToActionType
| Value | Meaning |
|---|---|
| NONE | No button. |
| BOOK | Book. |
| ORDER | Order. |
| SHOP | Shop. |
| LEARN_MORE | Learn more. |
| SIGN_UP | Sign up. |
| GET_OFFER | Get offer. |
| CALL | Call. |
Examples
Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}General post with a 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"
}
}Event
{
"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"
}
}Offer
{
"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."
}
}The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.