Google Business Attributes
Attributes are the extra facts of a listing: Wi-Fi, payment methods, accessibility, "women-owned", the WhatsApp and SMS contact links, and many more. Which ones a location can use depends on its category and country.
- Authentication: API Key —
Authorization: Apikey <YOUR_API_KEY> - Location:
user+ optionallocation_id, resolved as in location info.
Available attributes
- Method:
GET - Endpoint:
/api/uploadposts/google-business/attributes/available
Three ways to ask:
| Mode | Parameters |
|---|---|
| For a location | user (+ location_id). |
| For a category | category=gcid:bakery, region_code=ES, optional language_code. Cached 24 h. |
| Everything in a country | show_all=true, region_code, language_code. Cached 24 h. |
Plus page_size (1-200) and page_token. Each item of attributes has parent (the
attribute name), valueType (BOOL, ENUM, URL, REPEATED_ENUM), displayName,
groupDisplayName, repeatable, deprecated and, for enums, valueMetadata.
Current attributes
GET /api/uploadposts/google-business/attributes?user=X[&location_id=]GET /api/uploadposts/google-business/attributes/google-updated?user=X— the values as customers see them, after Google's own changes.GET /api/uploadposts/google-business/attributes/extended?user=X— experimental: per attribute, what you set, what customers see and the moderation stage. Marked"experimental": true.
Update attributes
- Method:
PATCH(alsoPOST) - Endpoint:
/api/uploadposts/google-business/attributes
Only the attributes you name are touched; all the others stay as they are.
| Name | Type | Description |
|---|---|---|
user / location_id | string | Location. |
attributes | array | [{"name": "attributes/has_wifi", "values": [true]}]. Exactly one of values (one value: true/false or an enum id), uri_values (list of URLs) or repeated_enum_value ({"set_values": [...], "unset_values": [...]}). The attributes/ prefix is optional. Max 100 per request. |
whatsapp_url | string | Shortcut for attributes/url_whatsapp, e.g. https://wa.me/34600000000 (international format). null removes it; "" leaves it as it is. |
text_messaging_url | string | Shortcut for attributes/url_text_messaging, e.g. sms:+34600000000. null removes it; "" leaves it as it is. |
remove | array of string | Attributes to remove from the listing. |
confirm | boolean | Required (true) when something is removed. |
dry_run | boolean | Validates and returns what would be sent, without calling Google (Google has no validation-only mode for attributes). |
include_edit_status | boolean | Default true: the answer includes edit_status (experimental). |
curl -X PATCH https://api.upload-post.com/api/uploadposts/google-business/attributes \
-H 'Authorization: Apikey YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"user": "panaderia-sol", "whatsapp_url": "https://wa.me/34600000000",
"attributes": [{"name": "has_wifi", "values": [true]}]}'
{
"success": true,
"location_id": "locations/111",
"attribute_mask": ["attributes/has_wifi", "attributes/url_whatsapp"],
"removed": [],
"attributes": [{ "name": "attributes/has_wifi", "values": [true] }],
"edit_status": {
"attributes": { "attributes/url_whatsapp": { "stage": "PENDING" } },
"pending_review": true, "rejected": false, "experimental": true, "channel": "v1alpha"
}
}
Each update counts toward Google's limit of 10 edits per minute per location
(429 location_edit_rate_limited).
Errors
| Status | code | Meaning |
|---|---|---|
| 400 | invalid_field | An attribute or link is not valid; see errors. |
| 400 | no_fields | Nothing to change. |
| 400 | confirmation_required | Removing attributes needs "confirm": true. |
| 400 | invalid_json | The body is not a valid JSON object. |
| 400 | invalid_category / invalid_region_code / invalid_language_code | Catalog parameters. |
| 400 | google_validation_error | Google rejected the value (e.g. the attribute does not apply to the category). |
| 429 | location_edit_rate_limited | Too many edits on this location in a minute. |