REST Resource: partners.vendors.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.

Methods

list

Lists the customers of the vendor.