All pages
Powered by GitBook
1 of 1

Loading...

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.

2. Photo Post

Standalone photo update (no special details).

3. Event Post

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

4. Offer Post

Advertise discounts or promotions with coupon codes and terms.

Parameters

Field
Type
Description

Supported Features & Limits

Feature
Details

Workflow

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

  2. Choose Post Type

    • Update: general news with image & CTA.

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

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).

Not supported

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

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

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

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

  • 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).

    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

    Platform-Specific Formats
    Publishing Methods
    Content Types

    Video Support

    {
      "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"
              }
            ]
          }
        ]
      }
    }
    {
      "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"
              }
            ]
          }
        ]
      }
    }
    {
      "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"
              }
            ]
          }
        ]
      }
    }
    {
      "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"
              }
            ]
          }
        ]
      }
    }