> For the complete documentation index, see [llms.txt](https://publer.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://publer.com/docs/posting/create-posts/content-types/platform-specific-formats/google-business-profiles-updates-photos-events-and-offers.md).

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

```json
{
  "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).

```json
{
  "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.

```json
{
  "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.

```json
{
  "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

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

### Supported Features & Limits

<table><thead><tr><th width="222.05462646484375">Feature</th><th>Details</th></tr></thead><tbody><tr><td>Post Types</td><td>Updates, Photos, Events, Offers</td></tr><tr><td>Max Photo Size</td><td>5 MB</td></tr><tr><td>Min Photo Resolution</td><td>250 × 250 pixels</td></tr><tr><td>Call-to-Action Buttons</td><td>Supported (<code>LEARN_MORE</code>, <code>PROFILE</code>, etc.)</td></tr><tr><td>Events</td><td>Requires <code>start</code> and <code>end</code> fields</td></tr><tr><td>Offers</td><td>Supports <code>coupon</code> and <code>terms</code></td></tr><tr><td>Video Support</td><td>Not supported</td></tr></tbody></table>

### 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](/docs/posting/create-posts/media-handling.md).
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](/docs/posting/create-posts/content-types/platform-specific-formats.md)
* [Publishing Methods](/docs/posting/create-posts/publishing-methods.md)
* [Content Types](/docs/posting/create-posts/content-types.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://publer.com/docs/posting/create-posts/content-types/platform-specific-formats/google-business-profiles-updates-photos-events-and-offers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.