Aracılığıyla paylaş

Müşterinin niteliklerini zaman uyumsuz olarak güncelleştirme

  • Makale

Müşterinin niteliklerini zaman uyumsuz olarak Güncelleştirmeler.

İş 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önetici istrator
    • 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 EducationSegmentdeğ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
}