Müşterinin niteliklerini zaman uyumsuz olarak güncelleştirme
Müşterinin niteliklerini zaman uyumsuz olarak güncelleştirir.
İş ortağı müşterinin niteliklerini zaman uyumsuz olarak "Eğitim", "GovernmentCommunityCloud" veya "StateOwnedEntity" olacak şekilde güncelleştirebilir. "Hiçbiri" ve "Kar Amacı Gütmeyen" gibi diğer değerler ayarlanamaz.
Önkoşullar
İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Müşteri kimliği (
customer-tenant-id
). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği'ni arayın. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id
) aynıdır.Yalnızca Kamu Topluluk Bulutu (GCC) nitelikleri için: Aşağıdaki ayrıntılı yönetici ayrıcalıkları (GDAP) rollerinden en az birine ihtiyacınız vardır. GDAP hakkında daha fazla bilgi edinmek için GDAP'a Giriş bölümünden başlayarak MS Learn makalelerimizi inceleyin.
- Dizin Okuyucusu
- Dizin Yazıcı
- Lisans Yöneticisi
- Kullanıcı Yöneticisi
C#
Müşterinin "Eğitim" için nitelemini oluşturmak için önce bir CustomerQualificationRequest
tür nesnesi oluşturun ve niteleme türünü ve EducationSegment
değerini bir (isteğe bağlı) ile Website
birlikte belirtinEducation
.
Ardından, müşteri tanımlayıcısı ile IAggregatePartner.Customers.ById yöntemini çağırın.
Ardından, ICustomerQualification arabirimini almak için Qualification özelliğini kullanın.
Son olarak, CreateQualifications()
giriş parametresi olarak veya CreateQualificationsAsync()
CustomerQualificationRequest
türünü çağırın.
// Education
var eduRequestBody = new CustomerQualificationRequest
{
Qualification = "Education",
EducationSegment = "K12", // could also be "HigherEducation"
Website = "example.edu"
};
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(eduRequestBody);
// State Owned Entity
var soeRequestBody = new CustomerQualificationRequest
{
Qualification = "StateOwnedEntity"
};
var soeCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(soeRequestBody);
Örnek: Konsol Örnek Uygulaması. Proje: SdkSamples Sınıfı: CreateCustomerQualification.cs
Mevcut bir müşteride bir müşterinin niteliğini KamuYazınlıkBulut'a güncelleştirmek için iş ortağının müşterinin doğrulama kodunu da eklemesi gerekir.
İlk olarak bir CustomerQualificationRequest
tür nesnesi oluşturun ve nitelik türünü ve doğrulama kodunu belirtin GovernmentCommunityCloud
.
Ardından, müşteri tanımlayıcısı ile IAggregatePartner.Customers.ById yöntemini çağırın.
Ardından, ICustomerQualification arabirimini almak için Qualification özelliğini kullanın.
Son olarak, CreateQualifications()
giriş parametresi olarak veya CreateQualificationsAsync()
CustomerQualificationRequest
türünü çağırın.
var gccRequestBody = new CustomerQualificationRequest
{
Qualification = "GovernmentCommunityCloud",
ValidationCode = "<validation code>"
};
var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(gccRequestBody);
Örnek: Konsol Örnek Uygulaması. Proje: SdkSamples Sınıfı: CreateCustomerQualificationWithGCC.cs
REST isteği
İstek söz dizimi
Metot | İstek URI'si |
---|---|
POST | {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1 |
URI parametresi
Niteliği güncelleştirmek için aşağıdaki sorgu parametresini kullanın.
Adı | Tür | Zorunlu | Açıklama |
---|---|---|---|
customer-tenant-id | GUID | Yes | Değer, kurumsal bayinin kurumsal bayiye ait belirli bir müşterinin sonuçlarını filtrelemesine olanak tanıyan GUID biçimli müşteri kiracı kimliğidir . |
İstek üst bilgileri
Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.
Request body
Bu tabloda istek gövdesindeki niteleme nesnesi açıklanır.
Özellik | Type | Zorunlu | Açıklama |
---|---|---|---|
Nitelik | string | Yes | CustomerQualification sabit listesinden dize değeri. |
Bu tabloda, Özellikle Eğitim Niteliği için istek gövdesi açıklanmaktadır.
Özellik | Type | Zorunlu | Açıklama |
---|---|---|---|
Nitelik | string | Yes | Eğitim |
EducationSegment | string | Yes | K12, HigherEducation |
Web sitesi | Dize | Hayır | Eğitim varlığının web sitesi |
Yeterlik Eğitim içinse Eğitimsegmenti gerekli bir alandır.
- EducationSegment için izin verilen değerler K12 ve HigherEducation'dır
- Web sitesi isteğe bağlı bir alan olarak kalır ve yalnızca Yeterlik Eğitim içinse geçerlidir. Ancak, varsa/uygulanabilirse dahil olmak üzere kesinlikle önerilir
Bu tabloda GovernmentCommunityCloud Niteliği için istek gövdesi açıklanmaktadır.
Özellik | Type | Zorunlu | Açıklama |
---|---|---|---|
Nitelik | string | Yes | GovernmentCommunityCloud |
ValidationCode | string | Yes | İş ortağının GCC doğrulama kodu. Örnek - 123456 |
Nitelik GovernmentCommunityCloud içinse ValidationCode gerekli bir alandır.
İstek örneği
POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
// SOE
{
"qualification": "StateOwnedEntity"
}
// Education
{
"qualification": "Education",
"educationSegment": "HigherEducation", // could also be "K12"
"website": "contoso.edu"
}
// GCC
{
"qualification": "GovernmentCommunityCloud",
"validationCode": "123456"
}
REST yanıtı
Başarılı olursa, bu yöntem yanıt gövdesinde bir niteleme nesnesi döndürür. Aşağıda, Eğitim niteliğine sahip bir müşteri (daha önce Yok niteliğine sahip) post çağrısı örneği verilmiştir.
Yanıt başarısı ve hata kodları
Her yanıt, başarılı veya başarısız olduğunu ve diğer hata ayıklama bilgilerini gösteren bir HTTP durum koduyla 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 . Hata Kodları.
Yanıt örneği
HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
"qualification": "Education",
"vettingStatus": "InReview",
"vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}
İlgili makaleler
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