v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
GMB Attributes

Get attribute metadata

Returns metadata about which Google Business Profile attributes are available for a location or business category. Use this endpoint to discover valid attribute names, value types, and allowed enum values before reading or writing via gmb-attributes.

Two mutually exclusive query modes:

Location mode: pass locationId (or rely on the account's stored selectedLocationId). Google returns attributes valid for that specific location.

Category mode: pass categoryName (must start with categories/) and regionCode. Google returns attributes valid for that category across the given region. languageCode is optional in category mode.

Both modes support pageSize and pageToken for pagination.

get/v1/accounts/{accountId}/gmb-attribute-metadata

Path parameters

accountIdstring required

Query parameters

locationIdstring

GBP location ID (e.g. "6257659026299438786"). If omitted, uses the account's stored selectedLocationId. Mutually exclusive with categoryName.

categoryNamestring

Category resource name, must start with "categories/" (e.g. "categories/gcid:plumber"). Required together with regionCode. Mutually exclusive with locationId.

regionCodestring

BCP-47 region code (e.g. "US", "ES"). Required when categoryName is provided.

languageCodestring

BCP-47 language code for display names (e.g. "en", "es"). Optional when categoryName is provided. Omitted from the Google call when not supplied.

pageSizeinteger

Maximum number of attribute metadata items to return. Google defaults to 200.

pageTokenstring

Pagination token from a previous response's nextPageToken field.

Response

Attribute metadata fetched successfully

successboolean
accountIdstring
locationIdstring

Only present in location mode.

nextPageTokenstring

Present when additional pages of results are available.