Google Business Profiles: Updates, Photos, Events & Offers

Share updates, photos, events, and special offers on your Google Business Profile via the Publer API. Each post type has its own fields—use the right payload to drive engagement and conversions.

Request Examples

1. Update Post

General news or announcement with an image and a CTA button.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "text": "Our new feature is live!\npubler.com",
            "title": "LEARN_MORE",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-05-24T08:46:00-04:00"
          }
        ]
      }
    ]
  }
}

2. Photo Post

Standalone photo update (no special details).

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "details": { "type": "photo" },
            "text": "Our office view today!",
            "title": "PROFILE",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-05-24T08:50:00-04:00"
          }
        ]
      }
    ]
  }
}

3. Event Post

Promote an upcoming event with start/end times and an optional link.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "details": {
              "type": "event",
              "title": "Summer Workshop",
              "start": "2025-06-07T12:50:00Z",
              "end":   "2025-08-03T12:50:00Z"
            },
            "text": "Join our Summer Workshop series!",
            "title": "LEARN_MORE",
            "url": "https://publer.com/events",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-06-07T08:50:00-04:00"
          }
        ]
      }
    ]
  }
}

4. Offer Post

Advertise discounts or promotions with coupon codes and terms.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "details": {
              "type": "offer",
              "title": "Spring Sale",
              "start":   "2025-05-28T12:50:00Z",
              "end":     "2025-10-02T12:50:00Z",
              "coupon":  "30%OFF",
              "terms":   "https://publer.com/terms"
            },
            "text": "Enjoy 30% off sitewide!",
            "url": "https://publer.com/sale",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-06-14T08:50:00-04:00"
          }
        ]
      }
    ]
  }
}

Parameters

Field	Type	Description
networks.google.type	string	"photo"
networks.google.text	string	Main caption or description.
networks.google.title	string	CTA button label (LEARN_MORE, PROFILE, etc.).
networks.google.url	string	External URL (for events/offers).
networks.google.media[]	array	Array of 1 media object with keys: id, path, thumbnail, and type: "photo".
networks.google.details.type	string	One of: "photo", "event", "offer".
networks.google.details.title	string	Event or offer title (required for event/offer).
networks.google.details.start	string	ISO 8601 start date/time (for events/offers).
networks.google.details.end	string	ISO 8601 end date/time (for events/offers).
networks.google.details.coupon	string	Coupon code (offers only).
networks.google.details.terms	string	URL to terms & conditions (offers only).
accounts[].id	string	Google Business Profile account ID.
accounts[].scheduled_at	string	ISO 8601 timestamp for scheduling (omit for immediate publish).

Supported Features & Limits

Feature	Details
Post Types	Updates, Photos, Events, Offers
Max Photo Size	5 MB
Min Photo Resolution	250 × 250 pixels
Call-to-Action Buttons	Supported (LEARN_MORE, PROFILE, etc.)
Events	Requires start and end fields
Offers	Supports coupon and terms
Video Support	Not supported

Workflow

1. Select Profile Choose the Google Business Profile in accounts[].id.

2. Choose Post Type

   • Update: general news with image & CTA.

   • Photo: standalone image.

   • Event: include details.type = "event", dates, and optional link.

   • Offer: include details.type = "offer", dates, coupon, and terms URL.

3. Add Media Upload or reference one photo via the Media Upload API.

4. Compose & Schedule Build your JSON, set state and scheduled_at, then POST to /posts/schedule.

Best Practices

• Use high-resolution images (≥250×250 pixels).

• Craft clear CTAs to direct user action.

• Include complete offer details (coupon & terms).

• Set accurate event dates for reliable reminders.

Related Topics

• Platform-Specific Formats

• Publishing Methods

• Content Types