# REST Resource: accounts.customers

- [Resource: Customer](https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer)
  - [JSON representation](https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#METHODS_SUMMARY)

## Resource: Customer

Entity representing a customer of a reseller or distributor.

| JSON representation |
|---|
| ``` { "name": string, "orgDisplayName": string, "orgPostalAddress": { object (`https://docs.cloud.google.com/channel/docs/reference/rest/Shared.Types/PostalAddress`) }, "primaryContactInfo": { object (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks.customers#Customer.ContactInfo`) }, "alternateEmail": string, "domain": string, "createTime": string, "updateTime": string, "cloudIdentityId": string, "languageCode": string, "cloudIdentityInfo": { object (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/CloudIdentityInfo`) }, "channelPartnerId": string, "correlationId": string, "customerAttestationState": enum (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks.customers#Customer.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 (`https://docs.cloud.google.com/channel/docs/reference/rest/Shared.Types/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 (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks.customers#Customer.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 (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Time when the customer was created. Uses RFC 3339, where generated output will always be Z-normalized and use 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 (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Time when the customer was updated. Uses RFC 3339, where generated output will always be Z-normalized and use 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>. |
| `cloudIdentityInfo` | ``object (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/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 (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks.customers#Customer.CustomerAttestationState`)`` Optional. Indicates if a customer is attesting about the correctness of provided information. Only required if creating a Google Cloud entitlement. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create` | Creates a new `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer` resource under the reseller or distributor account. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/delete` | Deletes the given `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer` permanently. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/get` | Returns the requested `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer` resource. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/import` | Imports a `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer` from the Cloud Identity associated with the provided Cloud Identity ID or domain before a TransferEntitlements call. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/list` | List `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer`s. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/listPurchasableOffers` | Lists the following: - Offers that you can purchase for a customer. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/listPurchasableSkus` | Lists the following: - SKUs that you can purchase for a customer - SKUs that you can upgrade or downgrade for an entitlement. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/patch` | Updates an existing `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers#Customer` resource for the reseller or distributor. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/provisionCloudIdentity` | Creates a Cloud Identity for the given customer using the customer's information, or the information provided here. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/queryEligibleBillingAccounts` | Lists the billing accounts that are eligible to purchase particular SKUs for a given customer. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/transferEntitlements` | Transfers customer entitlements to new reseller. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/transferEntitlementsToGoogle` | Transfers customer entitlements from their current reseller to Google. |