Merchant API (merchantapi:loyaltycustomers_v1)

2026-08-05

1 new method | New API

Additions

    Methods
  • merchantapi.accounts.loyaltyCustomers.manage

      Path : loyaltyCustomers/v1/{+parent}/loyaltyCustomers:manage

      Parameter Order : parent

      Flat Path : loyaltyCustomers/v1/accounts/{accountsId}/loyaltyCustomers:manage

      Description : Manages (inserts, updates, or removes) a customer's loyalty tier information. This method serves as a single interface for all changes to a customer's loyalty status. The specific action (insert, update, or remove) is determined by the current state of the merchant-to-customer association and the `loyalty_tier` value provided in the request. **Operation Logic:** * **Upsert (Insert/Update):** Providing any valid tier other than `NON_MEMBER` will associate the customer with that tier. If an association already exists, it will be updated; otherwise, a new one will be created. * **Removal:** Setting `loyalty_tier` to `NON_MEMBER` will remove any existing loyalty association for the customer. **Privacy Note:** To protect user privacy, this method consistently returns a `200 OK` status with a default `LoyaltyCustomer` response if the customer's identifier cannot be matched to a Google account or if the user has not opted into loyalty personalization.

      HTTP Method : POST

      Scopes : https://www.googleapis.com/auth/content

      Parameters :

        parent

          Required : Yes

          Location : path

          Type : string

          Description : Required. The parent account where this loyalty customer will be handled. Format: `accounts/{account}`

          Pattern : ^accounts/[^/]+$