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

  • Makale
  • Okumak için 2 dakika

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

bir iş ortağı müşterinin niteliklerini zaman uyumsuz olarak "Eğitim" veya "GovernmentCocloud" olacak şekilde güncelleştirin. "Hiçbiri" ve "Kar Amacı Gütmeyen" gibi diğer değerler ayarlanabilir.

Önkoşullar

  • kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamasını destekler.

  • Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi'den CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile customer-tenant-id aynıdır.

C#

Müşterinin "Eğitim" niteliğini oluşturmak için önce nitelik türünü temsil eden bir nesne oluşturun. Ardından, müşteri tanımlayıcısıyla IAggregatePartner.Customers.ById yöntemini çağırın. Ardından Bir ICustomerQualification arabirimi almak için Nitelik özelliğini kullanın. Son olarak, CreateQualifications() giriş CreateQualificationsAsync() parametresi olarak nite türü nesnesiyle veya çağrısında bulundurabilirsiniz.

var qualificationToCreate = "education";    // can also be "StateOwnedEntity" or "GovernmentCommunityCloud". See GCC example below.
var qualificationType = { Qualification = qualificationToCreate };
var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(qualificationType);

Örnek:Konsol Örnek Uygulaması. Project:SdkSamples Sınıfı:CreateCustomerQualification.cs

Bir müşterinin yeterliliği olmayan mevcut bir müşteride GovernmentCocloud niteliğini güncelleştirmek için iş ortağının müşterinin ValidationCode kodunu da içermesi gerekir. İlk olarak, nitelik türünü temsil eden bir nesne oluşturun. Ardından, müşteri tanımlayıcısıyla IAggregatePartner.Customers.ById yöntemini çağırın. Ardından Bir ICustomerQualification arabirimi almak için Nitelik özelliğini kullanın. Son olarak, CreateQualifications() nitelik CreateQualificationsAsync() türü nesnesiyle veya çağrısı ve giriş parametreleri olarak doğrulama kodu.

// GCC validation is type ValidationCode
var qualificationType = { Qualification = "GovernmentCommunityCloud" };
var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(qualificationType, gccValidation);

Örnek:Konsol Örnek Uygulaması. Project:SdkSamples Sınıfı:CreateCustomerQualificationWithGCC.cs

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
YAYINLA {baseURL}/v1/customers/{customer_id}/qualifications?code={validationCode} HTTP/1.1

URI parametresi

Niteliği güncelleştirmek için aşağıdaki sorgu parametresini kullanın.

Ad Tür Gerekli Açıklama
customer-tenant-id GUID Yes Değer, kurumsal bayinin kurumsal bayiye ait olan belirli bir müşteri için sonuçları filtrelemesini sağlayan GUID biçimli bir müşteri kiracı kimliğidir.
validationCode int No Yalnızca bu Government Community Cloud.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Bu tablo, istek gövdesinin nitelik nesnesini açıklar.

Özellik Tür Gerekli Açıklama
Eleme string Yes CustomerQualification enum değerinden dize değeri.

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications?code=<validation-code> HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

{
    "Qualification": "Education"
}

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde bir nitelik nesnesi döndürür. Aşağıda, Eğitim niteliğine sahip bir müşteriyle ilgili POST çağrısının bir örneği (daha önce Yokniteliğine sahip) verilmiştir.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren 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. 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
}