LoyaltyCustomerMatchService

Manages customer loyalty program memberships for merchants.

This service allows merchants to manage the association between their customers and loyalty program tiers. This data is used to personalize the shopping experience on Google free listing surfaces.

The service is only available to selected merchants. Contact the support team to express interest for participation by submitting an allowlist request in the Shopping API Support Form (https://support.google.com/merchants/contact/shopping_api_support_form) under "What is the issue/question? > Allowlist request > Other". The service follows a non-standard, imperative pattern, exposing a single ManageLoyaltyCustomerMatch method rather than conventional resource identifiers and CRUD operations. This design protects user privacy by preventing the discovery of a customer's presence or membership status through standard GET or LIST methods.

ManageLoyaltyCustomerMatch

rpc ManageLoyaltyCustomerMatch(ManageLoyaltyCustomerMatchRequest) returns (ManageLoyaltyCustomerMatchResponse)

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.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.