Получить и усилить; обновить информацию об учетной записи клиента

Для получения и обновления информации о клиенте с помощью API для реселлеров вы можете найти клиента одним из двух способов:

• Уникальный идентификатор клиента — например, C0123456 .
• Доменное имя клиента — например, example.com .

Получить информацию об учетной записи клиента.

Для получения информации об учетной записи клиента используйте следующий GET запрос, включив в него токен авторизации:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

Замените CUSTOMER_ID на уникальный идентификатор клиента или доменное имя.

Ответ возвращается

При получении информации об учетной записи клиента вы можете получить один из следующих ответов:

• Возвращает полные настройки клиента : клиент является одним из ваших существующих клиентов. Используя API для реселлеров, вы можете управлять учетной записью и настройками подписки этого клиента.

• Возвращается минимальная информация об учетной записи клиента : если в ответе возвращаются только customerId , customerDomain и customerType , значит, клиентом управляет Google или другой реселлер. Вы не можете создать для него другого клиента с подтвержденным адресом электронной почты. Чтобы управлять этим клиентом, выполните следующие действия:

  1. Необходимо получить все доступные для передачи подписки, чтобы клиент мог понять условия передачи и минимальное количество пользовательских мест.
  2. Перенесите подписку .

• Возвращает сообщение Multiple teams exist on this domain : К этому домену привязан один или несколько клиентов из числа команд. Чтобы добавить еще одну команду к этому домену, выполните следующие действия:

  1. Заказать создание клиентского аккаунта .
  2. Для создания клиента с подтвержденным доменом попросите клиента приобрести прямую подписку и подтвердить свой домен , а затем перенести подписку .

• Возвращается ошибка HTTP 404 : клиент является новым пользователем Google и не имеет учетной записи. Для управления этим клиентом выполните следующие действия:

  1. Убедитесь, что ваши записи не содержат устаревших данных о клиентах с несоответствием между основным доменным именем и уникальным идентификатором клиента Google. При восстановлении удаленной учетной записи она рассматривается как новая учетная запись с новым идентификатором customerId .
  2. Заказать создание нового клиентского аккаунта .
  3. Создайте подписку для нового аккаунта клиента.

Обновить настройки клиента

Используя API для реселлеров, вы не можете изменить customerType ), но можете подтвердить домен клиента team , чтобы он стал клиентом domain .

Для обновления настроек клиента используйте следующий PUT запрос, указав уникальный идентификатор клиента:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

В теле JSON-запроса обновляются следующие параметры клиента:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "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 : Адрес электронной почты клиента — например, [e-mail] .

В случае успешного ответа в формате JSON возвращается код состояния HTTP 200 и обновленные настройки клиента:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}