Pobieranie i aktualizowanie informacji o koncie klienta

Aby pobrać i zaktualizować informacje o kliencie za pomocą interfejsu 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.

Zwracanie odpowiedzi

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

• Zwraca pełne ustawienia klienta: klient jest jednym z Twoich obecnych klientów. Za pomocą interfejsu 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 usługi klienta, które można przenieść, aby sprawdzić, czy można je przenieść, i poznać minimalną liczbę stanowisk użytkowników.
  2. Przenieś subskrypcję.

• ZwrotyMultiple teams exist on this domain: z tą domeną jest powiązany co najmniej 1 klient reprezentujący zespół. Aby dodać kolejny zespół do tej domeny, wykonaj te czynności:

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

• 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 klientów, w których występuje niezgodność między domeną podstawową a unikalnym identyfikatorem klienta Google. Gdy usunięte konto zostanie przywrócone, będzie traktowane jako nowe konto z nowym customerId.
  2. Zamówienie nowego konta klienta
  3. Utwórz subskrypcję na nowym koncie klienta.

Aktualizowanie ustawień klienta

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

Aby zaktualizować ustawienia klienta, użyj tego żądania PUT i uwzględnij 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 następujące 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 ISO klienta.
• EMAIL_ADDRESS: adres e-mail klienta, np. [e-mail].

Pomyślna odpowiedź 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"
}