Müşterinin hesap bilgilerini alma ve güncelleme

Bayi API'sini kullanarak bir müşterinin bilgilerini almak ve güncellemek için müşterinizi iki şekilde arayabilirsiniz:

  • Müşterinin benzersiz tanımlayıcısı (ör. C0123456)
  • Müşterinin alan adı (ör. example.com)

Müşterinin hesap bilgilerini alma

Bir müşterinin hesap bilgilerini almak için aşağıdaki GET isteğini kullanın ve yetkilendirme jetonunu ekleyin:

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

CUSTOMER_ID değerini müşterinizin benzersiz tanımlayıcısıyla veya alan adıyla değiştirin.

Yanıt döndürme

Bir müşterinin hesap bilgilerini aldığınızda aşağıdaki yanıtlardan birini alabilirsiniz:

  • Müşteri ayarlarının tamamını döndürür. Müşteri, mevcut müşterilerinizden biriyse Bayi API'sini kullanarak bu müşterinin hesabını ve abonelik ayarlarını yönetebilirsiniz.

  • Minimum müşteri hesabı bilgilerini döndürür. Yanıt yalnızca customerId, customerDomain ve customerType döndürüyorsa müşteriyi Google veya başka bir bayi yönetiyordur. Müşteri için e-posta ile doğrulanmış başka bir müşteri oluşturamazsınız. Bu müşteriyi yönetmek için aşağıdaki adımları uygulayın:

    1. Aboneliğin aktarılıp aktarılamayacağı ve aktarma işlemi için gereken minimum kullanıcı koltuğu sayısını anlamak üzere müşteri için aktarılabilir tüm abonelikleri alın.
    2. Aboneliği aktarın.

  • Multiple teams exist on this domain döndürür. Bu alanla ilişkili bir veya daha fazla ekip üyesi müşteri var. Bu alana başka bir ekip eklemek için aşağıdaki adımları uygulayın:

    1. Müşteri hesabı sipariş edin.
    2. Alan için alan doğrulaması yapılmış bir müşteri oluşturmak istiyorsanız müşteriden Google üzerinden doğrudan abonelik satın almasını, alanını doğrulamasını, mevcut ekipleri devralmasını ve ardından aboneliği hesabınıza aktarmasını isteyin.

  • HTTP 404 hatası döndürür. Müşteri Google'da yeniyse ve hesabı yoksa Bu müşteriyi yönetmek için aşağıdaki adımları uygulayın:

    1. Müşteri kayıtlarınızda, müşterinin birincil alan adıyla benzersiz Google müşteri tanımlayıcısının eşleşmemesi nedeniyle eski müşteri verilerinin bulunmadığını onaylayın. Daha önce silinmiş bir Google Hesabı yeniden etkinleştirildiğinde yeni bir hesap olarak değerlendirilir ve hesap aynı customerDomain değerini koruyabilir ancak yeni bir customerId değerine sahip olur.
    2. Yeni bir müşteri hesabı sipariş edin.
    3. Bu yeni müşteri hesabı için abonelik oluşturun.

Müşteri ayarlarını güncelleme

Bayi API'sini kullanarak customerType'ü güncelleyemezsiniz ancak team müşterisinin alanını doğrulayabilir ve domain müşterisi olabilirsiniz.

Bir müşterinin ayarlarını güncellemek için aşağıdaki PUT isteğini kullanın ve müşterinizin benzersiz tanımlayıcısını ekleyin:

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

JSON istek gövdesi aşağıdaki müşteri ayarlarını günceller:

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

Aşağıdakini değiştirin:

  • DOMAIN_NAME: Müşterinizin alanı (ör. example.com)
  • NAME: Müşterinizin adı (ör. Alex Cruz).
  • ORGANIZATION_NAME: Müşterinizin kuruluş adı (ör. Example Organization).
  • POSTAL_CODE: Müşterinizin posta kodu (ör. 94043).
  • COUNTRY_CODE: Müşterinizin 2 karakterli ISO ülke kodu.
  • EMAIL_ADDRESS: Müşterinizin e-posta adresi (ör. cruz@example.com).

Başarılı bir JSON yanıtı, HTTP 200 durum kodu ve güncellenmiş müşteri ayarlarını döndürür:

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