Skip to main content
These endpoints manage media items attached to the selected Business Profile location (photos and some videos). They complement post images: profile media appears in the Photos area of the profile, not only inside a single post. Media capabilities are partially category/profile dependent. Some categories or media types may be limited by Google policy, moderation, or profile eligibility. Base path: /api/v1/misc/google-business

​
List media

Endpoint: GET /api/v1/misc/google-business/media
QueryRequiredDescription
teamIdYesTeam identifier.
pageSizeNo1 to 250.
pageTokenNoPagination.
Response includes mediaItems (each may have name, googleUrl, mediaFormat PHOTO or VIDEO, thumbnailUrl, description, locationAssociation with optional category, and so on), plus optional nextPageToken and totalMediaItemCount.

​
Delete media

Endpoint: DELETE /api/v1/misc/google-business/media 
{
  "teamId": "team_123",
  "mediaName": "accounts/123/locations/456/media/789"
}
mediaName is the full resource name returned by Google for that media item.

​
Add media (upload)

Endpoint: POST /api/v1/misc/google-business/media Use after you uploaded a file through the standard upload flow and obtained an uploadId.
FieldRequiredDescription
teamIdYesTeam identifier.
uploadIdYesFrom your completed upload.
categoryNoOne of: CATEGORY_UNSPECIFIED, COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, PRODUCT, AT_WORK, FOOD_AND_DRINK, MENU, COMMON_AREA, ROOMS, TEAMS, ADDITIONAL (default behavior may treat unspecified as ADDITIONAL).
descriptionNoMax 2000 characters.
Some category values may be less relevant or not applied consistently for specific business categories. If unsure, list current media first and mirror categories already used by Google on that location.

​
Example

{
  "teamId": "team_123",
  "uploadId": "upload_abc123",
  "category": "EXTERIOR",
  "description": "Storefront at night"
}