Skip to main content

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 + optional location_id, resolved as in location info.

Available attributes​

  • Method: GET
  • Endpoint: /api/uploadposts/google-business/attributes/available

Three ways to ask:

ModeParameters
For a locationuser (+ location_id).
For a categorycategory=gcid:bakery, region_code=ES, optional language_code. Cached 24 h.
Everything in a countryshow_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 (also POST)
  • Endpoint: /api/uploadposts/google-business/attributes

Only the attributes you name are touched; all the others stay as they are.

NameTypeDescription
user / location_idstringLocation.
attributesarray[{"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_urlstringShortcut for attributes/url_whatsapp, e.g. https://wa.me/34600000000 (international format). null removes it; "" leaves it as it is.
text_messaging_urlstringShortcut for attributes/url_text_messaging, e.g. sms:+34600000000. null removes it; "" leaves it as it is.
removearray of stringAttributes to remove from the listing.
confirmbooleanRequired (true) when something is removed.
dry_runbooleanValidates and returns what would be sent, without calling Google (Google has no validation-only mode for attributes).
include_edit_statusbooleanDefault 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​

StatuscodeMeaning
400invalid_fieldAn attribute or link is not valid; see errors.
400no_fieldsNothing to change.
400confirmation_requiredRemoving attributes needs "confirm": true.
400invalid_jsonThe body is not a valid JSON object.
400invalid_category / invalid_region_code / invalid_language_codeCatalog parameters.
400google_validation_errorGoogle rejected the value (e.g. the attribute does not apply to the category).
429location_edit_rate_limitedToo many edits on this location in a minute.