​
Posting to Google Business Profile

There are four types of Google Business Profile, formerly known as Google My Business, posts that can be created using the Google Business Profile API. 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).
You must claim your Google Business Profile page before linking it with Ayrshare. Be sure to choose the Google account that is an admin of your GBP page during link authorization. The business profile must also be verified and public.You can access your GBP manage console and check the verification status at https://business.google.com/
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 :
Google Business Profile Post
{
  "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:
Google Business Profile Post with Image
{
  "post": "The best GMB ever #best https://www.google.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["gmb"]
}

​
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 local 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 to be published to the What’s New section via the Google Business Profile API. Please see Image or Video Post for details on how to publish videos to Google Business Profile. These posts will appear in the “Posts -> What’s New” section in the GMB management console.
Google Business Profile Standard Post
{
  "post": "A wonderful post",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional - images only
  "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.
Google Business Profile Image Post
{
  "post": "What an image!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // required
  "gmbOptions": {
    "isPhotoVideo": true, //required
    "category": "product" // optional
  }
}

​
Video Processing

Google at times takes extra time to process uploaded videos. You can view the status of the media in the Google Business Profile console:
  1. Go to your Google Business Profile console.
  2. Click the button “See your profile”. You will br brought to the GBP page.
  3. Click on the “Photos” tab.
  4. You will see a list of photos and videos.
  5. Click on the photo or video you want to view.
If your video has a “pending” status, it is still being processed by Google. Please wait a few minutes and refresh the page. Be sure your Google Business Profile has been verififed and the profile is public.If the video seems stuck in “pending”, this may be due to a bug at Google. Please contact Google Business support for assistance.

​
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.
Google Business Profile Event Post
{
  "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.
Google Business Profile Offers Post
{
  "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.
Google Business Profile Call to Action Post
{
  "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.

Google Business Profile Linking

​
Google Business Profile Mentions

While you can add a @handle to a Google Business Profile post, Google Business Profile does not support resolving mentions in the post text. The @handle will remain as plain text.

​
Character Limits

Please see Google Business Profile Character Limits for more information.