Google Business

Add profile media

Adds a photo or video to the Business Profile. Google downloads the file from media_url itself, so it must be publicly reachable — a signed URL that expires quickly, or a localhost address, will fail. category: CATEGORY_UNSPECIFIED, COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, TEAMS, ADDITIONAL (default).

post/api/profiles/{profile_id}/google_business/create_media

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/profiles/{profile_id}/google_business/create_media
  • Auth
    HTTP bearer

Path parameters

profile_idstring required

Profile id (must be a google_business profile)

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

Headers

Idempotency-Keystring

Optional idempotency key (up to 255 characters; a UUID is ideal). Retrying a successful write with the same key replays the original response (with an Idempotent-Replay: true header) instead of executing again. Stored responses are kept for 24 hours; only 2xx responses are stored.

Request body

location_idstring required

Placement ID — the location's full Google resource path

media_urlstring required

Public https URL — Google fetches the file itself

categorystring

Default ADDITIONAL

media_format'PHOTO' | 'VIDEO'

Default PHOTO

descriptionstring

Max 2000 characters

Response

The created media item

object required

Google's own resource shape, camelCased keys, passed through unchanged

Changes

No recorded changes to this operation across all 1 revision of this API.