List Categories

Lists Google's business-category catalog, pass-through to Google's Business Information v1 categories.list. Callers use it to let a merchant pick a primary/additional category before creating or updating a location — the returned id is directly assignable to Category.id.

The catalog is global reference data, so the results never depend on who asks — but the credentials do. With location_id set, the call is made as the merchant who owns that location (SDL resolves it to their Connection, then to their Google token), which spends their Google quota instead of the single Wix-wide one. Without it, the call is made as the Wix app via a Wix-owned Google account, exactly like the category_region mode of ListAttributeMetadata — the right choice before any location exists.

search_term is a plain term matched against the localized display name — the service builds Google's filter=displayName=<term> expression itself, so callers must not pass a filter expression. Omitting it returns the whole catalog, page by page.

Failure semantics:

• location_id set but not found in SDL → NOT_FOUND (Google is not called).
• Token resolution failure (location mode) → propagated from gbp-token-service.
• Google call failure (or app-token mint failure) → GOOGLE_API_CALL_FAILED with Google's HTTP status in the payload.