Google Business Profile API

​

Posting to Google Business Profile

There are four types of Google Business Profile, formerly known as Google My Business, posts. In the below example, the post text is posted as an update to the user’s Google business page. Find out more about Google Business Profile (GBP).

Product posts cannot be created via the Google Business Profile API at this time.

JSON for a basic post with just text to GBP, which will appear in the “What’s New” section of :

{
  "post": "The best GMB ever #best https://www.google.com",
  "platforms": ["gmb"] // Please note to use `gmb`
}

or JSON for a basic post with an image to GBP:

{
  "post": "The best GMB ever #best https://www.google.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["gmb"]
}

If your video doesn’t end in a known video extension such as mp4, please use the isVideo parameter. See the /post endpoint for details.

​

Google Business Profile Posting Requirements

Please be sure your post does not contain the following. Google will reject your post and the post will show as “This post is no longer available” or with a “Rejected” label in the Google Console:

• Phone numbers. Google will reject all posts containing phone numbers.
• Spam, false claims, or false representation.
• Off-topic post that doesn’t pertain to your business.
• Duplicate content.
• Inappropriate content.
• Offensive language.

Please see Google Business Profile’s Content Policy for more information.

​

Standard Post (What’s New)

A standard post appears in the “Posts” GBP section and is categorized as “What’s New”. It can contain post text, an image, or a Call to Action (see below).

Videos are not supported for Standard post.

These posts will appear in the “Posts -> What’s New” section in the GMB management console.

{
  "post": "A wonderful post",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional
  "gmbOptions": {
    "callToAction": {
      // optional
      "actionType": "learn_more",
      "url": "https://www.ayrshare.com"
    }
  }
}

​

Image or Video Post

You can publish Image or Video posts to Google Business Profile. Images and videos will appear in the “Photos” section in the GBP management console.

​

Requirements

• Only one image or one video can be added to your GBP location, which will appear in the “Photos” section of the GBP console.

• Only one image or video is allowed per post.
• The post text is required by the endpoint, but is not used by GBP.
• Call to Action is not supported for image or video posts.
• Be sure to include the isPhotoVideo parameter in the gmbOptions object.

{
  "post": "What an image!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // required
  "gmbOptions": {
    "isPhotoVideo": true, //required
    "category": "product" // optional
  }
}

​

Product Category

You can specify a product category for an image or video so the media is categorized in the “Photos” section of the GBP console. For example, if an image has the category “product”, it will appear under the “Product” tab in Photos.

Some categories are not allowed for certain business types. For example, Ayrshare could not use food_and_drink since we are not in the food/drink industry.

Available Categories:

• cover: Cover photo. A location has only one cover photo.
• profile: Profile photo. A location has only one profile photo.
• logo: Logo photo.
• exterior: Exterior media.
• interior: Interior media.
• product: Product media.
• at_work: At work media.
• food_and_drink: Food and drink media.
• menu: Menu media.
• common_area: Common area media.
• rooms: Rooms media.
• teams: Teams media.

​

Events Post

Promote an event at your business. Events require a title, start and end dates, and can include a video. For example, a real estate agent may advertise an open house showing.

• Events support Call to Action.
• Include an optional image with the mediaUrls parameter.
• Videos are not supported for Events.

• Event posts will appear in the “Posts -> Events” section in the GBP management console.

• The post text will be used for the Event Details.

{
  "post": "A great event!", // Event Details
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional
  "gmbOptions": {
    "event": {
      "title": "Check this event out.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z" // required
    }
  }
}

​

Offers Post

Provide promotional sales or offers from your business. Offers require a title as well as start and end dates and times. A “View offer” action button is automatically added to the post. You can also include a photo, description, coupon code, link, and terms and conditions with the post. For example, a toy store may advertise 20% off all beanie babies for a week.

Include an image with the mediaUrls parameter.

Videos are not supported for Offers.

These posts will appear in the “Posts -> Offers” section in the GBP management console.

{
  "post": "A great offer for everyone!",
  "platforms": ["gmb"],
  "gmbOptions": {
    "offer": {
      "title": "Great Sale.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z", // required
      "couponCode": "BOGO-JET-CODE", // required - max 58 characters
      "redeemOnlineUrl": "https://www.ayrshare.com", // required
      "termsConditions": "Offer only valid if you can prove you are a time traveler" // required
    }
  }
}

• couponCode has a maximum of 58 characters.

​

Call to Action

Provide general information about your business and appears as an action button. For example, a website might promote a Learn More button to redirect to their website.

A Call to Action can be added to a Standard post or Event. Offers cannot have Call to Actions.

Include an image with the mediaUrls parameter.

{
  "post": "Take this action!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], //optional
  "gmbOptions": {
    "callToAction": {
      "actionType": "order", // required
      "url": "https://www.ayrshare.com" // required for all action types but "call"
    }
  }
}

The actionType is displayed as a button on the post. Possible values are:

• book: Prompts a user to book an appointment, table, or something similar.
• order: Prompts a user to order something.
• shop: Prompts a user to browse a product catalog.
• learn_more: Prompts a user to see additional details on a website.
• sign_up: Prompts a user to register, sign up, or join something.

• call: Prompts a user to call a business. The url field is not required for call. However, you must first have set a phone number in your Google Business Profile for the call action to appear on the post.

The url parameter is the URL the user will be directed to upon clicking.

Additional Google Business Profile information.