Microsoft Müşteri Sözleşmesinin müşteri kabulünün onayını alma

Makale
03/05/2024

Şunlar için geçerlidir: İş Ortağı Merkezi

Geçerli değildir: 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Sözleşme kaynağı şu anda yalnızca Microsoft genel bulutunda İş Ortağı Merkezi tarafından desteklenmektedir.

Bu makalede, müşterinin Microsoft Müşteri Sözleşmesi kabulüne ilişkin onayları nasıl alabildiğiniz açıklanmaktadır.

Önkoşullar

İş Ortağı Merkezi .NET SDK'sını kullanıyorsanız, sürüm 1.14 veya üzeri gereklidir.

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.
İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca Uygulama+Kullanıcı 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.

.NET

Daha önce sağlanan müşteri kabulü onaylarını almak için:

IAggregatePartner.Customers koleksiyonunu kullanın ve belirtilen müşteri tanımlayıcısıyla ById yöntemini çağırın.
Agreements özelliğini getirin ve ByAgreementType yöntemini çağırarak sonuçları Microsoft Müşteri Sözleşmesi olarak filtreleyin.
Get veya GetAsync yöntemini çağır.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

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

Konsol test uygulaması projesinden GetCustomerAgreements sınıfında eksiksiz bir örnek bulunabilir.

REST isteği

Daha önce sağlanan müşteri kabulünün onayını almak için:

Müşterinin Sözleşmeler koleksiyonunu almak için bir REST isteği oluşturun.
Sonuçları yalnızca Microsoft Müşteri Sözleşmesi kapsamına almak için agreementType sorgu parametresini kullanın.

İstek söz dizimi

Aşağıdaki istek söz dizimini kullanın:

Metot	İstek URI'si
GET	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

URI parametreleri

İsteğinizle aşağıdaki URI parametrelerini kullanabilirsiniz:

Adı	Tür	Zorunlu	Açıklama
customer-tenant-id	GUID	Yes	Değer, müşteri belirtmenize olanak tanıyan GUID biçimli customerTenantId değeridir.
sözleşme türü	Dize	Hayır	Bu parametre tüm sözleşme meta verilerini döndürür. Sorgu yanıtını belirli bir sözleşme türüne göre kapsamak için bu parametreyi kullanın. Desteklenen değerler şunlardır: Yalnızca MicrosoftCloudAgreement türündeki sözleşme meta verilerini içeren MicrosoftCloudAgreement. Yalnızca MicrosoftCustomerAgreement türündeki sözleşme meta verilerini içeren MicrosoftCustomerAgreement. * tüm sözleşme meta verilerini döndürür. (Kodunuzun beklenmeyen sözleşme türlerini işlemek için gerekli mantığı yoksa kullanmayın * .) Not: URI parametresi belirtilmezse, geriye dönük uyumluluk için sorgu varsayılan olarak MicrosoftCloudAgreement olur. Microsoft, istediği zaman yeni sözleşme türleriyle sözleşme meta verilerini tanıtabilir.

İstek üst bilgileri

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

Request body

Yok.

İstek örneği

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

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde Sözleşme kaynaklarının bir koleksiyonunu döndürür.

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 diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

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"
        }
    ]
}

Aracılığıyla paylaş