REST Resource: partners.customers

Resource: Company

A reseller, vendor, or customer in the zero-touch reseller and customer APIs.

JSON representation
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
Fields
name

string

Output only. The API resource name of the company. The resource name is one of the following formats:

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

Assigned by the server.

companyId

string (int64 format)

Output only. The ID of the company. Assigned by the server.

companyName

string

Required. The name of the company. For example XYZ Corp. Displayed to the company's employees in the zero-touch enrollment portal.

ownerEmails[]

string

Required. Input only. Email address of customer's users in the owner role. At least one owner_email is required. Owners share the same access as admins but can also add, delete, and edit your organization's portal users.

adminEmails[]

string

Optional. Email address of customer's users in the admin role. Each email address must be associated with a Google Account.

termsStatus

enum (TermsStatus)

Output only. Whether any user from the company has accepted the latest Terms of Service (ToS). See TermsStatus.

skipWelcomeEmail

boolean

Input only. If set to true, welcome email will not be sent to the customer. It is recommended to skip the welcome email if devices will be claimed with additional DEVICE_PROTECTION service, as the customer will receive separate emails at device claim time. This field is ignored if this is not a Zero-touch customer.

languageCode

string

Input only. The preferred locale of the customer represented as a BCP47 language code. This field is validated on input and requests containing unsupported language codes will be rejected. Supported language codes: Arabic (ar) Chinese (Hong Kong) (zh-HK) Chinese (Simplified) (zh-CN) Chinese (Traditional) (zh-TW) Czech (cs) Danish (da) Dutch (nl) English (UK) (en-GB) English (US) (en-US) Filipino (fil) Finnish (fi) French (fr) German (de) Hebrew (iw) Hindi (hi) Hungarian (hu) Indonesian (id) Italian (it) Japanese (ja) Korean (ko) Norwegian (Bokmal) (no) Polish (pl) Portuguese (Brazil) (pt-BR) Portuguese (Portugal) (pt-PT) Russian (ru) Spanish (es) Spanish (Latin America) (es-419) Swedish (sv) Thai (th) Turkish (tr) Ukrainian (uk) Vietnamese (vi)

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Output only. The Google Workspace account associated with this customer. Only used for customer Companies.

TermsStatus

A company's acceptance of the zero-touch enrollment Terms of Service (ToS). A single user can accept the ToS for their company using the web portal.

The ToS are versioned. This means that when the ToS change, at least one user must accept the new ToS. Until the first user accepts the new ToS, the company's terms status is TERMS_STATUS_STALE.

Enums
TERMS_STATUS_NOT_ACCEPTED None of the company's users have accepted the ToS.
TERMS_STATUS_ACCEPTED One (or more) of the company's users has accepted the ToS.
TERMS_STATUS_STALE None of the company's users has accepted the current ToS but at least one user accepted a previous ToS.

GoogleWorkspaceAccount

A Google Workspace customer.

JSON representation
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Fields
customerId

string

Required. The customer ID.

preProvisioningTokens[]

string

Output only. The pre-provisioning tokens previously used to claim devices.

Methods

create

Creates a customer for zero-touch enrollment.

list

Lists the customers that are enrolled to the reseller identified by the partnerId argument.