Прежде чем создать новую учетную запись клиента, учтите следующее:
- Могут применяться ограничения по коду страны. Чтобы убедиться, что страна клиента одобрена для перепродажи, проверьте консоль продаж партнеров .
- Если учетная запись создается путем обновления потребительской учетной записи Gmail до корпоративной электронной почты с доменным именем, убедитесь, что в учетной записи разблокированы дополнительные настройки Google Workspace. Дополнительные сведения см. в разделах Создание деловой электронной почты для своей команды и Создание псевдонима деловой электронной почты .
Создать учетную запись клиента
Чтобы создать учетную запись клиента, используйте следующий запрос
POST
и включите токен авторизации:POST https://reseller.googleapis.com/apps/reseller/v1/customers
В учетной записи нового клиента создайте пользователя . Если ответ возвращает код состояния
409 Conflict
, значит,customerId
уже существует. Перед регистрацией учетной записи клиента необходимо перенести подписки клиента .Если применимо, измените язык клиента по умолчанию .
Повысьте роль пользователя до роли суперадминистратора . При создании учетной записи администратора вы можете либо сгенерировать временный случайный пароль, либо предложить клиенту ввести пароль.
Сообщите клиенту, что ему необходимо войти в консоль администратора и подписать соглашение Google Workspace через реселлера, чтобы активировать свою учетную запись. Реселлерам запрещено подписывать Условия обслуживания от имени клиента.
Типы клиентов
В Google Workspace можно создать два типа клиентов:
- Клиенты с подтвержденным доменом . Этим клиентам нужен Gmail и полный доступ администратора. При создании этого типа клиента установите для
customerType
значениеdomain
. - Клиенты, подтвердившие электронную почту . Эти клиенты не владеют и не управляют своим доменом. Когда вы создаете этот тип клиента, установите для
customerType
значениеteam
. Клиенты такого типа могут приобрести версии Google Workspace Essentials и Enterprise Essentials .
Следующий текст запроса JSON является примером клиента с подтвержденным доменом:
{ "customerDomain": "DOMAIN_NAME", "customerType": "domain", "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
Замените следующее:
-
DOMAIN_NAME
: домен вашего клиента, напримерexample.com
. -
NAME
: имя вашего клиента, напримерAlex Cruz
. -
ORGANIZATION_NAME
: название организации вашего клиента, например,Example Organization
. -
POSTAL_CODE
: почтовый индекс или почтовый индекс вашего клиента, например94043
. -
COUNTRY_CODE
: двухзначный код страны ISO вашего клиента. -
EMAIL_ADDRESS
: адрес электронной почты вашего клиента, напримерcruz@example.com
.
Успешный ответ возвращает код состояния HTTP 200
и информацию о новом клиенте:
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME", "customerType": "domain", "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }
Следующий текст запроса JSON является примером клиента, подтвердившего адрес электронной почты:
{ "customerDomain": "DOMAIN_NAME", "customerType": "team", "primaryAdmin": { "primaryEmail": "EMAIL_ADDRESS" }, "postalAddress": { "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE" }, "alternateEmail": "EMAIL_ADDRESS" }
Успешный ответ возвращает код состояния HTTP 200
и информацию о новом клиенте:
{ "kind": "reseller#customer", "customerId": "CUSTOMER_ID", "customerDomain": "DOMAIN_NAME, "customerType": "team", "primaryAdmin": { "primaryEmail": "EMAIL_ADDRESS" }, "postalAddress": { "kind": "customers#address", "contactName": "NAME", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE", "countryCode": "COUNTRY_CODE", }, "alternateEmail": "EMAIL_ADDRESS" }
Изменение языка клиента по умолчанию
Язык клиента по умолчанию применяется только к новым пользователям при их создании. Существующие пользователи сохранят свой текущий язык даже после обновления языка по умолчанию. Поэтому перед созданием пользователей необходимо установить язык клиента по умолчанию.
Для вновь созданного клиента язык по умолчанию — английский. Чтобы изменить язык по умолчанию, используйте вызовы PATCH
или UPDATE
из конечной точки Directory API Customers .
Используйте API каталога, чтобы обновить значение language
по умолчанию для клиента:
PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID
Включите следующее тело запроса JSON:
{ "language":"LANGUAGE_CODE" }
Замените следующее:
-
CUSTOMER_ID
: уникальный идентификатор вашего клиента, напримерC0123456
. -
LANGUAGE_CODE
: принятый код языка , напримерes
для испанского языка.
Успешный ответ JSON возвращает код состояния HTTP 200
и обновленный ресурс клиента:
{ "alternateEmail": "EMAIL_ADDRESS", "customerCreationTime": "2022-12-12T23:04:10.620Z", "customerDomain": "DOMAIN_NAME", "id": "CUSTOMER_ID", "kind": "admin#directory#customer", "language": "LANGUAGE_CODE", "postalAddress": { "contactName": "NAME", "countryCode": "COUNTRY_CODE", "organizationName": "ORGANIZATION_NAME", "postalCode": "POSTAL_CODE" } }