Memperbarui kualifikasi pelanggan secara asinkron

Memperbarui kualifikasi pelanggan secara asinkron.

Mitra dapat memperbarui kualifikasi pelanggan secara asinkron menjadi "Pendidikan", "GovernmentCommunityCloud" atau "StateOwnedEntity". Nilai lain seperti "Tidak Ada" dan "Nirlaba" tidak dapat diatur.

Prasyarat

• Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial App+User.

• ID pelanggan (customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan, memilih pelanggan dari daftar, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).

• Hanya untuk kualifikasi Government Community Cloud (GCC): Anda memerlukan setidaknya salah satu peran hak istimewa admin terdelegasi terperinci (GDAP) berikut. Untuk mempelajari lebih lanjut tentang GDAP, jelajahi artikel MS Learn kami, dimulai dengan Pengenalan GDAP.

  • Pembaca Direktori
  • Penulis Direktori
  • Administrator Lisensi
  • Administrator Pengguna

C#

Untuk membuat kualifikasi pelanggan untuk "Education," terlebih dahulu, buat objek jenis CustomerQualificationRequest dan tentukan jenis kualifikasi Education dan EducationSegment, bersama dengan Website (opsional).

Kemudian, panggil metode IAggregatePartner.Customers.ById dengan pengidentifikasi pelanggan.

Kemudian gunakan properti Kualifikasi untuk mengambil antarmuka ICustomerQualification.

Terakhir, panggil CreateQualifications() atau CreateQualificationsAsync() dengan objek jenis CustomerQualificationRequest sebagai parameter input.

// 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);

Contoh: Aplikasi Sampel Konsol. Project: SdkSamples Class: CreateCustomerQualification.cs

Untuk memperbarui kualifikasi pelanggan ke GovernmentCommunityCloud pada pelanggan yang ada tanpa kualifikasi, mitra juga diharuskan untuk menyertakan kode validasi pelanggan.

Pertama, buat objek jenis CustomerQualificationRequest dan tentukan jenis kualifikasi GovernmentCommunityCloud dan kode validasi.

Kemudian, panggil metode IAggregatePartner.Customers.ById dengan pengidentifikasi pelanggan.

Kemudian gunakan properti Kualifikasi untuk mengambil antarmuka ICustomerQualification.

Terakhir, panggil CreateQualifications() atau CreateQualificationsAsync() dengan objek jenis CustomerQualificationRequest sebagai parameter input.

var gccRequestBody = new CustomerQualificationRequest 
{
    Qualification = "GovernmentCommunityCloud",
    ValidationCode = "<validation code>"
};

var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(gccRequestBody);

Contoh: Aplikasi Sampel Konsol. Project: SdkSamples Class: CreateCustomerQualificationWithGCC.cs

Pengajuan Permintaan REST

Sintaksis permintaan

Parameter URI

Gunakan parameter kueri berikut untuk memperbarui kualifikasi.

Header permintaan

Untuk informasi selengkapnya, lihat header Pusat Mitra REST.

Isi permintaan

Tabel ini menjelaskan objek kualifikasi dalam isi permintaan.

Tabel ini menjelaskan isi permintaan untuk Kualifikasi Pendidikan secara khusus.

Jika kualifikasi adalah untuk Pendidikan , maka segmen Pendidikan adalah bidang yang diperlukan.

• Nilai yang diizinkan untuk EducationSegment adalah K12 dan HigherEducation.
• Situs web tetap menjadi bidang opsional, dan hanya relevan jika Kualifikasi terkait dengan Pendidikan. Namun, sangat disarankan untuk menyertakannya jika tersedia/berlaku.

Tabel ini menjelaskan badan permintaan khususnya untuk kualifikasi Cloud Komunitas Pemerintah .

Jika kualifikasi adalah untuk GovernmentCommunityCloud maka ValidationCode adalah bidang yang diperlukan.

Contoh permintaan

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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"
}

Tanggapan REST

Jika berhasil, metode ini mengembalikan objek kualifikasi dalam isi respons. Berikut ini adalah contoh pemanggilan POST pada pelanggan (dengan kualifikasi sebelumnya Tidak Ada) dengan kualifikasi pendidikan .

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan lainnya. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat kode kesalahan .

Contoh respons

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}

Artikel terkait

• Dapatkan kualifikasi pelanggan
• Dapatkan kode validasi rekan