Müşterinin hesap bilgilerini alma ve güncelleme

Bayi API'sini kullanarak bir müşterinin bilgilerini almak ve güncellemek için müşterinizi aramanın iki yolu vardır:

  • Müşterinin benzersiz tanımlayıcısı (ör. C0123456)
  • Müşterinin alan adı (örneğin, 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 kısmını müşterinizin benzersiz tanımlayıcısı veya alan adıyla değiştirin.

Yanıt döndürür

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 biridir. Bayi API'sini kullanarak bu müşterinin hesap ve abonelik ayarlarını yönetebilirsiniz.

  • Minimum müşteri hesabı bilgilerini döndürür. Yanıt yalnızca customerId, customerDomain ve customerType değerlerini döndürüyorsa müşteriyi Google veya başka bir bayi yönetiyor demektir. Müşteri için başka bir e-posta doğrulamalı 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ğını ve aktarım için gereken minimum kullanıcı koltuğu sayısını öğrenmek üzere müşterinin aktarılabilir tüm aboneliklerini alın.
    2. Aboneliği aktarın.

  • İadeler Multiple teams exist on this domain. 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ı ve mevcut ekipleri devralmasını, ardından aboneliği hesabınıza aktarmasını isteyin.

  • HTTP 404 hatası döndürür. Müşteri Google'ı yeni kullanmaya başlamıştır ve hesabı yoktur. 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ı ile benzersiz Google müşteri tanımlayıcısı arasında olası bir eşleşme sorunu olan eski müşteri verileri bulunmadığını onaylayın. Daha önce silinen bir Google Hesabı yeniden etkinleştirildiğinde yeni hesap olarak kabul edilir ve hesap aynı customerDomain değerini korusa da yeni bir customerId değeri olur.
    2. Yeni bir müşteri hesabı sipariş edin.
    3. Bu yeni müşteri hesabı için abonelik oluşturun.

Müşterinin ayarlarını güncelleme

Bayi API'si kullanılarak customerType güncellenemez ancak team müşterisinin alanı doğrulanabilir ve domain müşterisi olunabilir.

Müşterinin ayarlarını güncellemek için aşağıdaki PUT isteğini kullanın ve müşteriniz için benzersiz tanımlayıcıyı 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ı (örneğin, 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üncellenen 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"
}