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,
  "adminConsoleUrl": string,
  "cloudIdentityInfo": {
    object (CloudIdentityInfo)
  },
  "channelPartnerId": string,
  "correlationId": string,
  "customerAttestationState": enum (CustomerAttestationState)
}
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, postal code, and address lines. 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. Alternate emails are optional when you create Team customers.
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.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Output only. Time when the customer was updated.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
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.
adminConsoleUrl
(deprecated)

string

Output only. URL of Customer's Admin console dashboard. Populated only if a Cloud Identity resource exists for this customer. Deprecated: Use CloudIdentityInfo.admin_console_uri instead.
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.
correlationId

string

Optional. External CRM ID for the customer. Populated only if a CRM ID exists for this customer.
customerAttestationState

enum (CustomerAttestationState)

Optional. Indicate if a customer is attesting about the correctness of provided information. Only required if creating a GCP Entitlement.

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.

import

 Imports a Customer from the Cloud Identity associated with the provided Cloud Identity ID or domain before a TransferEntitlements call.

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.

queryEligibleBillingAccounts

 Lists the billing accounts that are eligible to purchase particular SKUs for a given customer.

transferEntitlements

 Transfers customer entitlements to new reseller.

transferEntitlementsToGoogle

 Transfers customer entitlements from their current reseller to Google.