Customers

When a Google customer's account is registered with a reseller, the customer's subscriptions for Google services are managed by this reseller. A customer is described by a primary domain name and a physical address.

For a list of methods for this resource, see the end of this page.

Resource representations

JSON template for a customer.

{
  "kind": "reseller#customer",
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    "kind": "customers#address",
    "contactName": string,
    "organizationName": string,
    "locality": string,
    "region": string,
    "postalCode": string,
    "countryCode": string,
    "addressLine1": string,
    "addressLine2": string,
    "addressLine3": string
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean
}

Property name	Value	Description
`alternateEmail`	`string`	Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as `customerDomain`.
`customerDomain`	`string`	The customer's primary domain name string. `customerDomain` is required when creating a new customer. Do not include the `www` prefix in the domain when adding a customer.
`customerDomainVerified`	`boolean`	Whether the customer's primary domain has been verified.
`customerId`	`string`	This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
`kind`	`string`	Identifies the resource as a customer. Value: `reseller#customer`
`phoneNumber`	`string`	Customer contact phone number. Must start with "+" followed by the country code. The rest of the number can be contiguous numbers or respect the phone local format conventions, but it must be a real phone number and not, for example, "123". This field is silently ignored if invalid.
`postalAddress`	`nested object`	A customer's address information. Each field has a limit of 255 charcters.
`postalAddress.addressLine1`	`string`	A customer's physical address. An address can be composed of one to three lines. The `addressline2` and `addressLine3` are optional.
`postalAddress.addressLine2`	`string`	Line 2 of the address.
`postalAddress.addressLine3`	`string`	Line 3 of the address.
`postalAddress.contactName`	`string`	The customer contact's name. This is required.
`postalAddress.countryCode`	`string`	For `countryCode` information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
`postalAddress.kind`	`string`	Identifies the resource as a customer address. Value: `customers#address`
`postalAddress.locality`	`string`	An example of a `locality` value is the city of `San Francisco`.
`postalAddress.organizationName`	`string`	The company or company division name. This is required.
`postalAddress.postalCode`	`string`	A `postalCode` example is a postal zip code such as `94043`. This property is required when creating a new customer.
`postalAddress.region`	`string`	An example of a `region` value is `CA` for the state of California.
`resourceUiUrl`	`string`	URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.

Methods

get: Get a customer account.
insert: Order a new customer's account.
patch: Update a customer account's settings. This method supports patch semantics.
update: Update a customer account's settings.