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

Bir 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 iadeleri

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

• Müşteri ayarlarının tümü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 döndürürse müşteriyi Google veya başka bir bayi yönetir. Müşteri 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. Aboneliğin aktarılıp aktarılamayacağını ve aktarım için minimum kullanıcı lisansı sayısını öğrenmek amacıyla müşterinin tüm aktarılabilir aboneliklerini alın.
  2. Aboneliği aktarın.

• Multiple teams exist on this domain değerini döndürür. Bu alanla ilişkilendirilmiş bir veya daha fazla ekip müşterisi var. Bu alana başka bir ekip eklemek için şu adımları uygulayın:

  1. Müşteri hesabı sipariş etme
  2. Alan için alan doğrulaması yapılmış bir müşteri oluşturmak üzere müşteriden Google üzerinden doğrudan bir abonelik satın alıp 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 yenidir ve hesabı yoktur. Bu müşteriyi yönetmek için aşağıdaki adımları izleyin:

  1. Müşteri kayıtlarınızın, müşterinin birincil alan adı ile benzersiz Google müşteri tanımlayıcısı arasındaki olası uyuşmazlıkla ilgili eski müşteri verilerini barındırmadığından emin olun. Daha önce silinmiş bir Google hesabı eski durumuna getirildiğinde yeni bir hesap olarak kabul edilir ve hesap aynı customerDomain değerini koruyor olsa bile yeni bir customerId değerine sahip olur.
  2. Yeni bir müşteri hesabı sipariş etme
  3. Bu yeni müşteri hesabı için abonelik oluşturun.

Müşterinin ayarlarını güncelleme

Bayi API'sini kullanarak customerType öğesini güncelleyemezsiniz ancak bir team müşterisinin alanını doğrulayarak 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ı; örneğin, example.com
• NAME: müşterinizin adı (örneğin, Alex Cruz).
• ORGANIZATION_NAME: müşterinizin kuruluş adı; örneğin, Example Organization.
• POSTAL_CODE: müşterinizin posta kodu; örneğin, 94043.
• COUNTRY_CODE: Müşterinizin 2 karakterli ISO ülke kodu.
• EMAIL_ADDRESS: müşterinizin e-posta adresi; örneğin, [e-mail].

Başarılı bir JSON yanıtı, bir 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"
}