Class LoyaltyCustomerMatchServiceClientImpl

LoyaltyCustomerMatchService client wrapper implementation, for convenient use.

Inheritance

object

LoyaltyCustomerMatchServiceClient

LoyaltyCustomerMatchServiceClientImpl

Inherited Members

LoyaltyCustomerMatchServiceClient.DefaultEndpoint

LoyaltyCustomerMatchServiceClient.DefaultScopes

LoyaltyCustomerMatchServiceClient.ServiceMetadata

LoyaltyCustomerMatchServiceClient.CreateAsync(CancellationToken)

LoyaltyCustomerMatchServiceClient.Create()

LoyaltyCustomerMatchServiceClient.ShutdownDefaultChannelsAsync()

LoyaltyCustomerMatchServiceClient.ManageLoyaltyCustomerMatchAsync(ManageLoyaltyCustomerMatchRequest, CancellationToken)

object.GetHashCode()

object.GetType()

object.ToString()

Namespace: Google.Shopping.Merchant.LoyaltyCustomers.V1

Assembly: Google.Shopping.Merchant.LoyaltyCustomers.V1.dll

Syntax

public sealed class LoyaltyCustomerMatchServiceClientImpl : LoyaltyCustomerMatchServiceClient

Remarks

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.

Constructors

LoyaltyCustomerMatchServiceClientImpl(LoyaltyCustomerMatchServiceClient, LoyaltyCustomerMatchServiceSettings, ILogger)

Constructs a client wrapper for the LoyaltyCustomerMatchService service, with the specified gRPC client and settings.

Declaration

public LoyaltyCustomerMatchServiceClientImpl(LoyaltyCustomerMatchService.LoyaltyCustomerMatchServiceClient grpcClient, LoyaltyCustomerMatchServiceSettings settings, ILogger logger)

Parameters

Type	Name	Description
LoyaltyCustomerMatchService.LoyaltyCustomerMatchServiceClient	grpcClient	The underlying gRPC client.
LoyaltyCustomerMatchServiceSettings	settings	The base LoyaltyCustomerMatchServiceSettings used within this client.
ILogger	logger	Optional ILogger to use within this client.

Properties

GrpcClient

The underlying gRPC LoyaltyCustomerMatchService client

Declaration

public override LoyaltyCustomerMatchService.LoyaltyCustomerMatchServiceClient GrpcClient { get; }

Property Value

Type	Description
LoyaltyCustomerMatchService.LoyaltyCustomerMatchServiceClient

Overrides

LoyaltyCustomerMatchServiceClient.GrpcClient

Methods

ManageLoyaltyCustomerMatch(ManageLoyaltyCustomerMatchRequest, CallSettings)

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.

Declaration

public override ManageLoyaltyCustomerMatchResponse ManageLoyaltyCustomerMatch(ManageLoyaltyCustomerMatchRequest request, CallSettings callSettings = null)

Parameters

Type	Name	Description
ManageLoyaltyCustomerMatchRequest	request	The request object containing all of the parameters for the API call.
CallSettings	callSettings	If not null, applies overrides to this RPC call.

Returns

Type	Description
ManageLoyaltyCustomerMatchResponse	The RPC response.

Overrides

LoyaltyCustomerMatchServiceClient.ManageLoyaltyCustomerMatch(ManageLoyaltyCustomerMatchRequest, CallSettings)

ManageLoyaltyCustomerMatchAsync(ManageLoyaltyCustomerMatchRequest, CallSettings)

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.

Declaration

public override Task<ManageLoyaltyCustomerMatchResponse> ManageLoyaltyCustomerMatchAsync(ManageLoyaltyCustomerMatchRequest request, CallSettings callSettings = null)

Parameters

Type	Name	Description
ManageLoyaltyCustomerMatchRequest	request	The request object containing all of the parameters for the API call.
CallSettings	callSettings	If not null, applies overrides to this RPC call.

Returns

Type	Description
Task<ManageLoyaltyCustomerMatchResponse>	A Task containing the RPC response.

Overrides

LoyaltyCustomerMatchServiceClient.ManageLoyaltyCustomerMatchAsync(ManageLoyaltyCustomerMatchRequest, CallSettings)