REST Resource: accounts.customers

Resource: Customer

Entity representing a customer of a reseller or distributor.

JSON representation
{
  "name": string,
  "orgDisplayName": string,
  "orgPostalAddress": {
    object (PostalAddress)
  },
  "primaryContactInfo": {
    object (ContactInfo)
  },
  "alternateEmail": string,
  "domain": string,
  "createTime": string,
  "updateTime": string,
  "cloudIdentityId": string,
  "languageCode": string,
  "cloudIdentityInfo": {
    object (CloudIdentityInfo)
  },
  "channelPartnerId": string
}
Fields
name

string

Output only. Resource name of the customer. Format: accounts/{account_id}/customers/{customer_id}

orgDisplayName

string

Required. Name of the organization that the customer entity represents.

orgPostalAddress

object (PostalAddress)

Required. The organization address for the customer. To enforce US laws and embargoes, we require a region and zip code. You must provide valid addresses for every customer. To set the customer's language, use the Customer-level language code.

primaryContactInfo

object (ContactInfo)

Primary contact info.

alternateEmail

string

Secondary contact email. You need to provide an alternate email to create different domains if a primary contact email already exists. Users will receive a notification with credentials when you create an admin.google.com account. Secondary emails are also recovery email addresses.

domain

string

Required. The customer's primary domain. Must match the primary contact email's domain.

createTime

string (Timestamp format)

Output only. Time when the customer was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. Time when the customer was updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

cloudIdentityId

string

Output only. The customer's Cloud Identity ID if the customer has a Cloud Identity resource.

languageCode

string

Optional. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

cloudIdentityInfo

object (CloudIdentityInfo)

Output only. Cloud Identity information for the customer. Populated only if a Cloud Identity account exists for this customer.

channelPartnerId

string

Cloud Identity ID of the customer's channel partner. Populated only if a channel partner exists for this customer.

Methods

create

Creates a new Customer resource under the reseller or distributor account.

delete

Deletes the given Customer permanently.

get

Returns the requested Customer resource.

list

List Customers.

listPurchasableOffers

Lists the following:

  • Offers that you can purchase for a customer.

listPurchasableSkus

Lists the following:

  • SKUs that you can purchase for a customer
  • SKUs that you can upgrade or downgrade for an entitlement.

patch

Updates an existing Customer resource for the reseller or distributor.

provisionCloudIdentity

Creates a Cloud Identity for the given customer using the customer's information, or the information provided here.

transferEntitlements

Transfers customer entitlements to new reseller.

transferEntitlementsToGoogle

Transfers customer entitlements from their current reseller to Google.