Retrieve & update a customer's account information

To retrieve and update a customer's information using the Reseller API, you can look up a customer in one of two ways:

• Customer's unique identifier—for example, C0123456 .
• Customer's domain name—for example, example.com .

Retrieve a customer's account information

To retrieve a customer's account information, use the following GET request and include the authorization token:

  GET https://reseller.googleapis.com/apps/reseller/v1/customers/ CUSTOMER_ID 
 
 

Replace CUSTOMER_ID with the customer's unique identifier or domain name.

Response returns

When you retrieve a customer's account information, you might receive one of the following responses:

• Returns the full customer settings: The customer is one of your existing customers. Using the Reseller API, you can manage this customer's account and subscription settings.

• Returns minimal customer account information: If the response only returns customerId , customerDomain , and customerType , Google or another reseller manages the customer. You can't create another email-verified customer for them. To manage this customer, follow these steps:

  1. Retrieve all transferable subscriptions for the customer to understand transferability and the minimum number of user seats.
  2. Transfer the subscription .

• Returns Multiple teams exist on this domain : This domain has one or more team customers associated with it. To add another team to this domain, follow these steps:

  1. Order a customer account .
  2. To create a domain-verified customer, ask the customer to purchase a direct subscription and verify their domain , then transfer the subscription .

• Returns an HTTP 404 error: The customer is new to Google and doesn't have an account. To manage this customer, follow these steps:

  1. Confirm your records don't have old customer data with a mismatch between the primary domain name and the unique Google customer identifier. When a deleted account is reinstated, it's treated as a new account with a new customerId .
  2. Order a new customer account .
  3. Create a subscription for the new customer account.

Update a customer's settings

Using the Reseller API, you can't update the customerType , but you can verify a team customer's domain to become a domain customer.

To update a customer's settings, use the following PUT request and include the unique identifier for your customer:

  PUT https://reseller.googleapis.com/apps/reseller/v1/customers/ CUSTOMER_ID 
 
 

The JSON request body updates the following customer settings:

  { 
  
 "customerId" 
 : 
  
 "C0 CUSTOMER_ID 
123456" 
 , 
  
 "customerDomain" 
 : 
  
 " DOMAIN_NAME 
" 
 , 
  
 "postalAddress" 
 : 
  
 { 
  
 "contactName" 
 : 
  
 " NAME 
" 
 , 
  
 "organizationName" 
 : 
  
 " ORGANIZATION_NAME 
" 
 , 
  
 "postalCode" 
 : 
  
 " POSTAL_CODE 
" 
 , 
  
 "countryCode" 
 : 
  
 " COUNTRY_CODE 
" 
  
 }, 
  
 "alternateEmail" 
 : 
  
 " EMAIL_ADDRESS 
" 
 } 
 

Replace the following:

• DOMAIN_NAME : The customer's domain—for example, example.com .
• NAME : The customer's name—for example, Alex Cruz .
• ORGANIZATION_NAME : The customer's organization name—for example, Example Organization .
• POSTAL_CODE : The customer's ZIP or postal code—for example, 94043 .
• COUNTRY_CODE : The customer's 2-character ISO country code .
• EMAIL_ADDRESS : The customer's email address—for example, cruz@example.com .

A successful JSON response returns an HTTP 200 status code and the updated customer settings:

  { 
  
 "kind" 
 : 
  
 "reseller#customer" 
 , 
  
 "customerId" 
 : 
  
 " CUSTOMER_ID 
" 
 , 
  
 "customerDomain" 
 : 
  
 " DOMAIN_NAME 
" 
 , 
  
 "postalAddress" 
 : 
  
 { 
  
 "kind" 
 : 
  
 "customers#address" 
 , 
  
 "contactName" 
 : 
  
 " NAME 
" 
 , 
  
 "organizationName" 
 : 
  
 " ORGANIZATION_NAME 
" 
 , 
  
 "postalCode" 
 : 
  
 " POSTAL_CODE 
" 
 , 
  
 "countryCode" 
 : 
  
 " COUNTRY_CODE 
" 
 , 
  
 }, 
  
 "alternateEmail" 
 : 
  
 " EMAIL_ADDRESS 
" 
 }