Müşteri oluşturma
Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi
Bulut Çözümü Sağlayıcısı (CSP) iş ortağı olarak, müşteri oluşturduğunuzda müşteri adına sipariş verebilirsiniz. Müşteri oluşturduğunuzda şunları da oluşturursunuz:
- Müşteri için bir Microsoft Entra kiracı nesnesi
- Kurumsal bayi ile müşteri arasındaki ilişki (yönetici temsilcisi ayrıcalıkları için kullanılır)
- Müşteri için yönetici olarak oturum açmak için bir kullanıcı adı ve parola
Müşteri oluşturulduktan sonra müşteri kimliğini ve Microsoft Entra Id ayrıntılarını kaydedin.
Önemli
Dolaylı bir sağlayıcıysanız ve dolaylı kurumsal bayi için müşteri oluşturmak istiyorsanız bkz . Dolaylı kurumsal bayi için müşteri oluşturma.
Önkoşullar
- İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.
Önemli
Müşteri kiracısı oluşturmak için oluşturma işlemi sırasında geçerli bir fiziksel adres sağlamanız gerekir. Adres doğrulama senaryosunda açıklanan adımlar izlenerek adres doğrulanabilir. Korumalı alan ortamında geçersiz bir adres kullanarak müşteri oluşturursanız, bu müşteri kiracısını silemezsiniz.
Önemli
userCredentials parolası geçirilirken kabul edilemez.
C#
Müşteri eklemek için:
Yeni bir Customer nesnesi örneği oluşturma. BillingProfile ve CompanyProfile bilgilerini doldurduğunuzdan emin olun.
Create veya CreateAsync çağrısı yaparak yeni müşteriyi IAggregatePartner.Customers koleksiyonunuza ekleyin.
C# örneği
// IAggregatePartner partnerOperations;
var partnerOperations = this.Context.UserPartnerOperations;
var customerToCreate = new Customer()
{
CompanyProfile = new CustomerCompanyProfile()
{
Domain = string.Format(CultureInfo.InvariantCulture,
"SampleApplication{0}.{1}",
new Random().Next(),
this.Context.Configuration.Scenario.CustomerDomainSuffix),
//// OrganizationRegistrationNumber = "123456" // Please add if in specific country/region that requires
},
BillingProfile = new CustomerBillingProfile()
{
Culture = "EN-US",
Email = "gena@wingtiptoys.com",
Language = "En",
CompanyName = "Wingtip Toys"
DefaultAddress = new Address()
{
FirstName = "Gena",
MiddleName = "Coralie",
LastName = "Soto",
AddressLine1 = "One Microsoft Way",
City = "Redmond",
State = "WA",
Country = "US",
PostalCode = "98052",
PhoneNumber = ""
}
}
};
var newCustomer = partnerOperations.Customers.Create(customerToCreate);
C# örnek uygulaması
- Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: CreateCustomer.cs
REST
İstek söz dizimi
Yöntem | İstek URI'si |
---|---|
POST | {baseURL}/v1/customers HTTP/1.1 |
İstek üst bilgileri
Bu API bir kez etkili olur (birden çok kez çağırırsanız farklı bir sonuç vermez).
İstek kimliği ve bağıntı kimliği gereklidir.
Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.
Request body
Bu tablo, istek gövdesindeki gerekli özellikleri açıklar.
Adı | Tür | Açıklama |
---|---|---|
BillingProfile | nesne | Müşterinin faturalama profili bilgileri. |
CompanyProfile | nesne | Müşterinin şirket profili bilgileri. |
Faturalama profili
Bu tabloda, yeni bir müşteri oluşturmak için gereken CustomerBillingProfile kaynağından gereken en düşük alanlar açıklanmaktadır.
Adı | Tür | Açıklama |
---|---|---|
e-posta | Dize | Müşterinin e-posta adresi. |
kültür | Dize | İletişim ve para birimi için tercih ettikleri kültür, örneğin en-US . Desteklenen kültürler için bkz . İş Ortağı Merkezi tarafından desteklenen diller ve yerel ayarlar. |
dil | Dize | Varsayılan dil. İki karakterli dil kodu (örneğin en veya fr ) desteklenir. |
Şirketadı | Dize | Kayıtlı şirket/kuruluş adı. |
defaultAddress | Adres | Müşterinin şirketinin/kuruluşunun kayıtlı adresi. Uzunluk sınırlamaları hakkında bilgi için Adres kaynağına bakın. |
Şirket profili
Bu tabloda, yeni bir müşteri oluşturmak için gereken CustomerCompanyProfile kaynağından gereken en düşük alanlar açıklanmaktadır.
Adı | Tür | Açıklama |
---|---|---|
etki alanı | Dize | Müşterinin etki alanı adı (örneğin, contoso.onmicrosoft.com). |
organizationRegistrationNumber | String | Müşterinin kuruluş kayıt numarası (belirli ülkelerde/bölgelerdeKI INN numarası olarak da adlandırılır). Yalnızca şu ülkelerde/bölgelerde bulunan müşterinin şirketi/kuruluşu için gereklidir: Ermenistan(AM), Azerbaycan(AZ), Belarus(BY), Macaristan(HU), Kazakistan(KZ), Kırgızistan(KG), Moldova(MD), Rusya(RU), Tacikistan(TJ), Özbekistan(UZ), Ukrayna(UA), Brezilya(BR), Hindistan, Güney Afrika, Polonya, Birleşik Arap Emirlikleri, Suudi Arabistan, Türkiye, Tayland, Vietnam, Myanmar, Irak, Güney Sudan, Venezuela ve Çin. Müşterinin başka ülkelerde/bölgelerde bulunan şirketi/kuruluşu için bu, isteğe bağlı bir alandır. |
Varsayılan Olarak GDAP
Adı | Tür | Açıklama |
---|---|---|
enableGDAPByDefault | ikili | GDAP'yi varsayılan olarak etkinleştirmek isteyip istemediğinizi belirten Boole değeri. True ise varsayılan olarak GDAP oluştururuz. False ise GDAP oluşturmayacağız. Bu yalnızca GDAP'ı destekleyen bulutlarda kabul edilir. Desteklenmediyse, DAP varsayılan olarak oluşturulur. |
İstek örneği
POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive
{
"enableGDAPByDefault": false,
"CompanyProfile": {
"Domain": "xyz.onmicrosoft.com"
},
"BillingProfile": {
"Culture": "EN-US",
"Email": "gena@wingtiptoys.com",
"Language": "en",
"CompanyName": "Wingtip Toys",
"DefaultAddress": {
"FirstName": "Gena",
"LastName": "Soto",
"AddressLine1": "One Microsoft Way",
"City": "Redmond",
"State": "WA",
"PostalCode": "98052",
"Country": "US"
}
}
}
REST yanıtı
Başarılı olursa, bu API yeni müşteri için bir Müşteri kaynağı döndürür. İş Ortağı Merkezi SDK'sı ile daha sonra kullanmak üzere müşteri kimliğini ve Microsoft Entra Id ayrıntılarını kaydedin. Örneğin, hesap yönetimiyle kullanmak için bunlara ihtiyacınız olacaktır.
Yanıt başarısı ve hata kodları
Yanıtlar, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.
Yanıt örneği
HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CV: ObwhuhD2tUKJoM+Z.0
MS-ServerId: 202010223
Date: Tue, 14 Feb 2017 20:06:02 GMT
{
"id": "dfd8cc0a-c592-468c-8461-869a38d24738",
"commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
"companyProfile": {
"tenantId": "dfd8cc0a-c592-468c-8461-869a38d24738",
"domain": "xyz.onmicrosoft.com",
"attributes": {
"objectType": "CustomerCompanyProfile"
}
},
"billingProfile": {
"id": "d17c0275-da92-5c33-9032-782ef1d0b69b",
"email": "gena@wingtiptoys.com",
"culture": "en-US",
"language": "en",
"companyName": "Wingtip Toys",
"defaultAddress": {
"country": "US",
"city": "Redmond",
"state": "WA",
"addressLine1": "One Microsoft Way",
"postalCode": "98052",
"firstName": "Gena",
"lastName": "Soto",
"phoneNumber": ""
},
"attributes": {
"etag": "5920358838484612121",
"objectType": "CustomerBillingProfile"
}
},
"enableGDAPByDefault": false,
"relationshipToPartner": "none",
"userCredentials": {
"userName": "admin",
"password": "=;;n.=s9Z"
},
"attributes": {
"objectType": "Customer"
}
}
Java
Not
Java için İş Ortağı Merkezi SDK'sı, iş ortağı topluluğu tarafından sürdürülen açık kaynak bir projedir.
Yeni müşteri oluşturmak için aşağıdaki adımları kullanın.
- CustomerBillingProfile ve CustomerCompanyProfile nesnelerinin yeni bir örneğini oluşturun. Gerekli alanları doldurmayı unutmayın.
- IAggregatePartner.getCustomers().create işlevini çağırarak müşteriyi oluşturun.
Java örneği
// IAggregatePartner partnerOperations;
Address address = new Address();
address.setFirstName( "Gena" );
address.setLastName( "Soto" );
address.setAddressLine1( "One Microsoft Way" );
address.setCity( "Redmond" );
address.setState( "WA" );
address.setCountry( "US" );
address.setPostalCode( "98052" );
address.setPhoneNumber( "4255550101" );
CustomerBillingProfile billingProfile = new CustomerBillingProfile();
billingProfile.setCulture( "en-US" );
billingProfile.setEmail( "gena@wingtiptoys.com" );
billingProfile.setLanguage( "en" );
billingProfile.setCompanyName( "Wingtip Toys" );
billingProfile.setDefaultAddress( address );
CustomerCompanyProfile companyProfile = new CustomerCompanyProfile();
companyProfile.setDomain( "WingtipToys" + Math.abs( new Random().nextInt() ) + ".onmicrosoft.com" );
Customer customerToCreate = new Customer();
customerToCreate.setBillingProfile( billingProfile );
customerToCreate.setCompanyProfile( companyProfile );
Customer newCustomer = partnerOperations.getCustomers().create( customerToCreate );
PowerShell
Not
PowerShell için İş Ortağı Merkezi SDK'sı, iş ortağı topluluğu tarafından sürdürülen açık kaynak bir projedir.
Müşteri oluşturmak için, aşağıdaki örnekte olduğu gibi New-PartnerCustomer komutunu yürütür.
New-PartnerCustomer -BillingAddressLine1 '1 Microsoft Way' -BillingAddressCity 'Redmond' -BillingAddressCountry 'US' -BillingAddressPostalCode '98052' -BillingAddressState 'WA' -ContactEmail 'gena@wingtiptoys.com' -ContactFirstName 'Gena' -ContactLastName 'Soto' -Culture 'en-US' -Domain 'newcustomer.onmicrosoft.com' -Language 'en' -Name 'New Customer'
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin