Publish a Google Business Profile update

Publishes a post on the location's Google Business Profile. Set topic to STANDARD for a piece of news, EVENT for something with a start and an end, or OFFER for a promotion - an offer also needs the event block with the dates it runs for, because that is how Google models it.

To attach an image, upload it first with POST /media and pass the URL you get back as media. If you were already handed the address of an image on our CDN - for instance a photo the person attached while talking to you - pass that one as it is and skip the upload. Use scheduled_at to publish later instead of now.

A media URL is spent once the post goes out: the image is handed over to Google, which keeps its own copy, and ours is dropped. A second post needs a new upload.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Business id path parameter (required).

string
required

Location id path parameter (required).

Body Params

A new update for the Google Business Profile.

topic decides which of the extra blocks is expected: EVENT wants event, OFFER wants
offer (and an offer is an event too, so it wants event as well, with the dates it runs
for). STANDARD is a plain piece of news and needs neither.

string
required
length between 1 and 1500

Text of the update

string
enum
Defaults to STANDARD

STANDARD for news, EVENT for an event, OFFER for a promotion

Allowed:

URL of an image to attach, as returned by POST /media. If the image is already online, send its address to POST /media as source_url; if it only exists on someone's phone or laptop, ask for a link with POST /media/upload-link and let them upload it there. Google must be able to reach whatever URL ends up here, so do not invent one.

The URL is good for one update: once Google has taken the image we drop our copy, so for a second update get a fresh one.

PublicUpdateCallToActionDTO | null

Call to action (value). Optional.

PublicUpdateEventDTO | null

Event (value). Optional.

PublicUpdateOfferDTO | null

Offer (value). Optional.

Publish later instead of now. Leave it out to publish immediately.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json