Pobieranie i aktualizowanie informacji o koncie klienta

Aby pobrać i zaktualizować informacje o kliencie za pomocą Reseller API, możesz wyszukać klienta na 2 sposoby:

• Unikalny identyfikator klienta, np. C0123456.
• Nazwa domeny klienta, np. example.com.

Pobieranie informacji o koncie klienta

Aby pobrać informacje o koncie klienta, użyj tego żądania GET i dołącz token autoryzacji:

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

Zastąp CUSTOMER_ID unikalnym identyfikatorem klienta lub nazwą domeny.

Odpowiedzi

Gdy pobierzesz informacje o koncie klienta, możesz otrzymać jedną z tych odpowiedzi:

• Zwraca pełne ustawienia klienta: klient jest jednym z Twoich dotychczasowych klientów. Za pomocą Reseller API możesz zarządzać ustawieniami konta i subskrypcji tego klienta.

• Zwraca minimalne informacje o koncie klienta: jeśli odpowiedź zawiera tylko customerId, customerDomain i customerType, klientem zarządza Google lub inny sprzedawca. Nie możesz utworzyć dla niego kolejnego klienta zweryfikowanego za pomocą adresu e-mail. Aby zarządzać tym klientem, wykonaj te czynności:

  1. Pobierz wszystkie subskrypcje, które można przenieść na tego klienta , aby poznać ich przenośność i minimalną liczbę miejsc dla użytkowników.
  2. Przenieś subskrypcję.

• Zwraca Multiple teams exist on this domain: ta domena jest powiązana z co najmniej 1 klientem reprezentującym zespół. Aby dodać kolejny zespół do tej domeny, wykonaj te czynności:

  1. Zamów konto klienta.
  2. Aby utworzyć klienta zweryfikowanego za pomocą domeny, poproś klienta o zakup subskrypcji bezpośredniej i zweryfikowanie domeny, a następnie przenieś subskrypcję.

• Zwraca błąd HTTP 404: klient jest nowy w Google i nie ma konta. Aby zarządzać tym klientem, wykonaj te czynności:

  1. Sprawdź, czy w Twoich rekordach nie ma starych danych klienta, w których występuje niezgodność między główną nazwą domeny a unikalnym identyfikatorem klienta Google. Gdy usunięte konto zostanie przywrócone, jest traktowane jako nowe konto z nowym customerId.
  2. Zamów nowe konto klienta.
  3. Utwórz subskrypcję na nowym koncie klienta.

Aktualizowanie ustawień klienta

Za pomocą Reseller API nie możesz zaktualizować customerType, ale możesz zweryfikować domenę klienta team, aby stał się klientem domain.

Aby zaktualizować ustawienia klienta, użyj tego żądania PUT i dołącz unikalny identyfikator klienta:

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

Treść żądania w formacie JSON aktualizuje te ustawienia klienta:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Zastąp te elementy:

• DOMAIN_NAME: domena klienta, np. example.com.
• NAME: imię i nazwisko klienta, np. Alex Cruz.
• ORGANIZATION_NAME: nazwa organizacji klienta, np. Example Organization.
• POSTAL_CODE: kod pocztowy klienta, np. 94043.
• COUNTRY_CODE: 2-znakowy kod kraju klienta zgodny z normą ISO.
• EMAIL_ADDRESS: adres e-mail klienta, np. [e-mail].

Pomyślna odpowiedź w formacie JSON zwraca kod stanu HTTP 200 i zaktualizowane ustawienia klienta:

{
  "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"
}