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

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

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

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