Müşterinin hesap bilgilerini alma ve güncelleme

Bayi API'sini kullanarak 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ı bilgisi döndürülüyor: 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 doğrulaması yapılmış 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ülen değerler 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'si kullanılarak customerType güncellenemez ancak team müşterisinin alanı doğrulanarak domain müşterisi olunabilir.

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üşterinin alanı (ör. example.com).
  • NAME: Müşterinin adı (örneğin, 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. 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"
}