Class LoyaltyCustomerMatchServiceGrpc.LoyaltyCustomerMatchServiceFutureStub (0.3.0)

public static final class LoyaltyCustomerMatchServiceGrpc.LoyaltyCustomerMatchServiceFutureStub extends AbstractFutureStub<LoyaltyCustomerMatchServiceGrpc.LoyaltyCustomerMatchServiceFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service LoyaltyCustomerMatchService.

Manages customer loyalty program memberships for merchants. This service allows all merchants, including non-advertisers, to share their first-party customer data of loyalty program members. Google uses this data to personalize organic free listing shopping experiences, in compliance with the Merchant Center Terms of Service. 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.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > LoyaltyCustomerMatchServiceGrpc.LoyaltyCustomerMatchServiceFutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected LoyaltyCustomerMatchServiceGrpc.LoyaltyCustomerMatchServiceFutureStub build(Channel channel, CallOptions callOptions)
Parameters
Name Description
channel io.grpc.Channel
callOptions io.grpc.CallOptions
Returns
Type Description
LoyaltyCustomerMatchServiceGrpc.LoyaltyCustomerMatchServiceFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

manageLoyaltyCustomerMatch(ManageLoyaltyCustomerMatchRequest request)

public ListenableFuture<ManageLoyaltyCustomerMatchResponse> manageLoyaltyCustomerMatch(ManageLoyaltyCustomerMatchRequest request)

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.
Parameter
Name Description
request ManageLoyaltyCustomerMatchRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ManageLoyaltyCustomerMatchResponse>