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

Чтобы получить и обновить информацию о клиенте с помощью 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. Чтобы создать клиента с подтвержденным доменом для домена, попросите клиента приобрести прямую подписку через Google и подтвердить свой домен, взять на себя управление существующими командами , а затем перенести подписку в свою учетную запись .

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

    1. Убедитесь, что в ваших записях о клиентах нет старых данных о клиентах, которые могут не соответствовать основному доменному имени клиента и уникальному идентификатору клиента Google. Когда ранее удаленная учетная запись Google восстанавливается, она рассматривается как новая учетная запись и имеет новое значение customerId , даже если учетная запись может сохранить то же значение customerDomain .
    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 : адрес электронной почты вашего клиента, например cruz@example.com .

Успешный ответ 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"
}