REST Resource: customers

Ресурс: Клиент

Если учетная запись клиента Google зарегистрирована у реселлера, подписками клиента на службы Google управляет этот реселлер. Клиент описывается основным доменным именем и физическим адресом.

JSON-представление
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
Поля
customerId

string

Это свойство всегда будет возвращаться в ответе как уникальный идентификатор, сгенерированный Google. В запросе этим свойством может быть либо основной домен, либо уникальный идентификатор, сгенерированный Google.

customerDomain

string

Строка основного доменного имени клиента. customerDomain требуется при создании нового клиента. Не включайте префикс www в домен при добавлении клиента.

postalAddress

object ( Address )

Информация об адресе клиента. Каждое поле имеет ограничение в 255 символов.

phoneNumber

string

Контактный телефон клиента. Должен начинаться с «+», за которым следует код страны. Остальная часть номера может представлять собой последовательные номера или соответствовать правилам местного формата телефона, но это должен быть реальный номер телефона, а не, например, «123». Это поле игнорируется, если оно недействительно.

alternateEmail

string

Как и «электронная почта клиента» в инструментах реселлера, этот адрес электронной почты является дополнительным контактным лицом, используемым, если что-то происходит со службой клиента, например сбой в обслуживании или проблема безопасности. Это свойство необходимо при создании нового клиента «домена» и не должно использовать тот же домен, что и customerDomain . Поле alternateEmail не является обязательным для создания «командного» клиента.

resourceUiUrl

string

URL-адрес панели управления консоли администратора клиента. URL-адрес, доступный только для чтения, создается службой API. Это используется, если ваше клиентское приложение требует от клиента выполнения задачи в консоли администратора.

customerDomainVerified

boolean

Был ли проверен основной домен клиента.

kind

string

Идентифицирует ресурс как клиента. Значение: reseller#customer

customerType

enum ( CustomerType )

Определяет тип клиента. Приемлемые значения включают в себя:

  • domain : подразумевает клиента, проверенного на домене (по умолчанию).
  • team : подразумевает клиента, подтвердившего адрес электронной почты.

Дополнительные сведения см. в разделе управляемые команды .

primaryAdmin

object ( PrimaryAdmin )

Первые административные данные клиента, присутствующие в случае клиента TEAM.

Адрес

JSON-шаблон для адреса клиента.

JSON-представление
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
Поля
countryCode

string

Информацию countryCode см. в элементах кода страны ISO 3166 . Убедитесь, что в этой стране разрешена перепродажа продуктов Google. Это свойство необходимо при создании нового клиента.

kind

string

Идентифицирует ресурс как адрес клиента. Значение: customers#address

region

string

Примером значения region является CA для штата Калифорния.

addressLine2

string

Вторая строка адреса.

locality

string

Примером значения locality является город San Francisco .

addressLine3

string

3 строка адреса.

postalCode

string

Примером postalCode является почтовый индекс, например 94043 . Это свойство необходимо при создании нового клиента.

addressLine1

string

Физический адрес клиента. Адрес может состоять из одной-трех строк. addressline2 и addressLine3 являются необязательными.

organizationName

string

Название компании или подразделения компании. Это необходимо.

contactName

string

Имя контактного лица клиента. Это необходимо.

Тип клиента

Тип клиента

Перечисления
customerTypeUnspecified Тип клиента неизвестен
domain Клиенты, зарегистрированные в домене или владеющие доменом
team Клиенты без домена или с подтвержденным адресом электронной почты

ПервичныйАдминистратор

Шаблон JSON для основного администратора в случае клиентов TEAM

JSON-представление
{
  "primaryEmail": string
}
Поля
primaryEmail

string

Деловой адрес электронной почты основного администратора клиента.

Ссылка для подтверждения электронной почты отправляется на этот адрес электронной почты во время создания клиента. Основные администраторы имеют доступ к консоли администратора клиента, включая возможность приглашать и исключать пользователей, а также управлять административными потребностями клиента.

Методы

get

Получает учетную запись клиента.

insert

Заказывает аккаунт нового клиента.

patch

Обновляет настройки учетной записи клиента.

update

Обновляет настройки учетной записи клиента.