REST Resource: accounts.loyaltyCustomers

Resource: LoyaltyCustomer

Represents a customer’s loyalty information. Represents loyalty customer data in loyaltyCustomers.manage API, but is not a resource that can be retrieved or listed by other methods. The service is only available to selected merchants.

JSON representation 
{
  "userIdentifier": {
    object (UserIdentifier)
  },
  "loyaltyTier": enum (LoyaltyTier),
  "pointBalance": string
}
Fields
userIdentifier

object (UserIdentifier)

Required. The identifiers for the customer.
loyaltyTier

enum (LoyaltyTier)

Required. The tier label of the loyalty tier the customer belongs to.
pointBalance

string (int64 format)

Optional. The point balance of the loyalty customer.

UserIdentifier

The user identifiers associated with the customer. At least one of the fields within this message must be provided.

JSON representation 
{
  "emailAddress": string,
  "address": {
    object (AddressInfo)
  },
  "phoneNumber": string
}
Fields
emailAddress

string

Optional. The customer’s email address.
address

object (AddressInfo)

Optional. The customer’s physical address.
phoneNumber

string

Optional. The customer's phone number, in E.164 format (e.g., "+16502530000").

AddressInfo

Represents a customer’s physical address.

JSON representation 
{
  "givenName": string,
  "familyName": string,
  "city": string,
  "state": string,
  "regionCode": string,
  "postalCode": string
}
Fields
givenName

string

Optional. The given name of the customer.
familyName

string

Optional. The family name of the customer.
city

string

Optional. The city of the customer.
state

string

Optional. The state or province of the customer.
regionCode

string

Optional. The Unicode country/region code (CLDR) of the customer, such as "US" or "CH". This field is case-insensitive. For more information, see https://cldr.unicode.org/ and https://www.unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html.
postalCode

string

Optional. The postal code (zip code) of the customer.

Format Rules:

  • United States: 5-digit zip codes (e.g., "94108").

LoyaltyTier

The tier label of the loyalty tier the customer belongs to.

Enums
LOYALTY_TIER_UNSPECIFIED Loyalty tier unspecified.
TIER1 Loyalty tier 1.
TIER2 Loyalty tier 2.
TIER3 Loyalty tier 3.
TIER4 Loyalty tier 4.
TIER5 Loyalty tier 5.
TIER6 Loyalty tier 6.
TIER7 Loyalty tier 7.
NON_MEMBER Disassociates the user from any loyalty tier. Only set to “NON_MEMBER” when the intent is to remove the user association from Google organic loyalty customer match experience.

Methods

manage

 Manages (inserts, updates, or removes) a customer's loyalty tier information.