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
vecustomerType
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:- 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.
- 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:- Müşteri hesabı sipariş etme
- 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:- 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 bircustomerId
değerine sahip olur. - Yeni bir müşteri hesabı sipariş etme
- Bu yeni müşteri hesabı için abonelik oluşturun.
- 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ı
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,cruz@example.com
.
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" }