Müşterinin hesap bilgilerini alma ve güncelleme

Bayi API'sini kullanarak bir müşterinin bilgilerini almak ve güncellemek için şu iki yoldan birini kullanabilirsiniz:

  • Müşterinin benzersiz tanımlayıcısı (ör. 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 değerini, müşterinizin benzersiz değeriyle değiştirin alan adı kullanabilirsiniz.

Yanıt iadeleri

Bir müşterinin hesap bilgilerini aldığınızda şu yanıtlar:

  • Müşteri ayarlarının tamamını iade eder. Müşteriniz yardımcı olur. Bayi API'sini kullanarak bunu yönetebilirsiniz. hesap ve abonelik ayarlarına gidin.

  • Minimum düzeyde müşteri hesabı bilgisini döndürür. Yanıt yalnızca customerId, customerDomain ve customerType özelliklerini döndürür. Google veya başka bir bayi müşteriyi yönetir. Başka bir tane oluşturamazsınız E-posta doğrulaması yapılmış bir müşteri olabilir. Bu müşteriyi yönetmek için şu adımları uygulayın:

    1. Müşteri için tüm aktarılabilir abonelikleri alma aktarılıp aktarılamayacağını ve ve aktarım için minimum kullanıcı lisansı sayısı.
    2. Aboneliği aktarın.
  • Multiple teams exist on this domain değerini döndürür. Bu alan adı müşterisinin kendisiyle ilişkilendirilmiş bir veya daha fazla ekip üyesi olması Başka bir takım eklemek için alan adına 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 üzere müşteriden şunları yapmasını isteyin: Google aracılığıyla doğrudan abonelik satın alıp alanlarını doğrulama ve mevcut ekipleri devralma ve ardından aboneliği hesabınıza aktarın.
  • HTTP 404 hatası döndürüyor. Müşteri Google'ı kullanmaya yeni başladı ve hesabınız olmalıdır. Bu müşteriyi yönetmek için aşağıdaki adımları uygulayın:

    1. Müşteri kayıtlarınızın, eski müşteri verilerini potansiyel müşterinin birincil alan adı ile benzersiz Google müşteri tanımlayıcısı. Daha önce silinmiş bir Google Hesabı yeniden etkinleştirildiyse yeni bir hesap olarak kabul edilir ve yeni bir customerId değerinde, ancak hesapta aynı customerDomain değerini koruysa bile değer.
    2. Yeni bir müşteri hesabı sipariş edin.
    3. Abonelik oluşturma müşteri hesabına e-posta gönderin.

Müşterinin ayarlarını güncelleme

Bayi API'sini kullanarak customerType öğesini güncelleyemezsiniz ancak güncelleyebilirsiniz: team alanına sahip bir müşterinin alanını doğrulayıp domain müşterisi olun.

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ıdır:

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şu ad - örneğin, Example Organization.
  • POSTAL_CODE: müşterinizin posta kodu (müşterinin posta kodu) örnek, 94043.
  • COUNTRY_CODE: müşterinizin 2 karakteri ISO ülke kodu.
  • EMAIL_ADDRESS: müşterinizin e-posta adresi - e-posta adresi örnek, cruz@example.com.

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

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