Dapatkan konfirmasi penerimaan pelanggan Perjanjian Pelanggan Microsoft

  • Artikel

Berlaku untuk: Pusat Mitra

Tidak berlaku untuk: Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Sumber daya Perjanjian saat ini hanya didukung oleh Pusat Mitra di cloud publik Microsoft.

Artikel ini menjelaskan bagaimana Anda dapat mengambil konfirmasi penerimaan pelanggan atas Perjanjian Pelanggan Microsoft.

Prasyarat

  • Jika Anda menggunakan Pusat Mitra .NET SDK, diperlukan versi 1.14 atau yang lebih baru.

    Penting

    Pada Juni 2023, Pusat Mitra terbaru .NET SDK rilis 3.4.0 sekarang diarsipkan. Anda dapat mengunduh rilis SDK dari GitHub, bersama dengan file readme yang berisi informasi yang berguna.

    Mitra didorong untuk terus menggunakan REST API Pusat Mitra.

  • Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi Aplikasi+Pengguna.

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

.NET

Untuk mengambil konfirmasi penerimaan pelanggan yang sebelumnya disediakan:

  • Gunakan kumpulan IAggregatePartner.Customers dan panggil metode ById dengan pengidentifikasi pelanggan yang ditentukan.

  • Ambil properti Perjanjian dan filter hasilnya ke Perjanjian Pelanggan Microsoft dengan memanggil metode ByAgreementType.

  • Panggil metode Get atau GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Sampel lengkap dapat ditemukan di kelas GetCustomerAgreements dari proyek aplikasi pengujian konsol.

Permintaan REST

Untuk mengambil konfirmasi penerimaan pelanggan yang sebelumnya disediakan:

  1. Buat permintaan REST untuk mengambil koleksi Perjanjian untuk pelanggan.

  2. Gunakan parameter kueri agreementType untuk mencakup hasil hanya ke Perjanjian Pelanggan Microsoft.

Minta sintaks

Gunakan sintaks permintaan berikut:

Metode URI Permintaan
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

Parameter URI

Anda dapat menggunakan parameter URI berikut dengan permintaan Anda:

Nama Tipe Diperlukan Deskripsi
customer-tenant-id GUID Ya Nilainya adalah CustomerTenantId berformat GUID yang memungkinkan Anda menentukan pelanggan.
jenis perjanjian string No Parameter ini mengembalikan semua metadata perjanjian. Gunakan parameter ini untuk mencakup respons kueri terhadap jenis perjanjian tertentu. Nilai yang didukung adalah:

MicrosoftCloudAgreement yang hanya menyertakan metadata perjanjian dari jenis MicrosoftCloudAgreement.

MicrosoftCustomerAgreement yang hanya menyertakan metadata perjanjian dari jenis MicrosoftCustomerAgreement.

* yang mengembalikan semua metadata perjanjian. (Jangan gunakan * kecuali kode Anda memiliki logika yang diperlukan untuk menangani jenis perjanjian yang tidak terduga.)

Catatan: Jika parameter URI tidak ditentukan, kueri default ke MicrosoftCloudAgreement untuk kompatibilitas mundur. Microsoft mungkin memperkenalkan metadata perjanjian dengan jenis perjanjian baru kapan saja.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada.

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Respons REST

Jika berhasil, metode ini mengembalikan kumpulan sumber daya Perjanjian dalam isi respons.

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 lainnya. Untuk daftar lengkapnya, lihat Kode kesalahan REST Pusat Mitra.

Contoh tanggapan

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}