Müşterinin hesap bilgilerini alma ve güncelleme

Bayi API'sini kullanarak bir müşterinin bilgilerini almak ve güncellemek için müşteriyi 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üşterinin benzersiz tanımlayıcısı veya alan adıyla değiştirin.

Yanıt döndürür

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

• En az düzeyde müşteri hesabı bilgilerini döndürür: Yanıtta yalnızca customerId, customerDomain ve customerType döndürülüyorsa Google veya başka bir bayi müşteriyi yönetir. Bu kullanıcılar için e-posta adresi 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. Aktarılabilirliği ve minimum kullanıcı koltuğu sayısını anlamak için müşterinin aktarılabilir tüm aboneliklerini alın.
  2. Aboneliği aktarın.

• Döndürür 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 doğrulaması yapılmış bir müşteri oluşturmak için müşteriden doğrudan abonelik satın almasını ve alanını doğrulamasını, ardından aboneliği aktarmasını isteyin.

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

  1. Kayıtlarınızda, birincil alan adı ile benzersiz Google müşteri tanımlayıcısı arasında uyuşmazlık olan eski müşteri verileri bulunmadığını onaylayın. Silinen bir hesap yeniden etkinleştirildiğinde yeni customerId ile yeni bir hesap olarak kabul edilir.
  2. Yeni bir müşteri hesabı sipariş edin.
  3. Yeni müşteri hesabı için abonelik oluşturun.

Müşterinin ayarlarını güncelleme

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

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üşterinin alanı (ör. example.com).
• NAME: Müşterinin adı (ör. Alex Cruz).
• ORGANIZATION_NAME: Müşterinin kuruluş adı (ör. Example Organization).
• POSTAL_CODE: Müşterinin posta kodu (ör. 94043).
• COUNTRY_CODE: Müşterinin 2 karakterli ISO ülke kodu.
• EMAIL_ADDRESS: Müşterinin e-posta adresi (ör. [e-mail]).

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