Müşterinin Microsoft Müşteri Sözleşmesi'ni doğrudan imzalama (doğrudan kabul) durumunu alma

Makale
01/02/2025

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

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

DirectSignedCustomerAgreementStatus kaynağı şu anda yalnızca Microsoft kamu bulutunda İş Ortağı Merkezi tarafından desteklenmektedir.

Bu makalede, müşterinin Microsoft Müşteri Sözleşmesi'ni doğrudan kabul etme durumunu nasıl alabildiğiniz açıklanmaktadır.

Önkoşullar

"Partner Merkezi kimlik doğrulamasında açıklanan kimlik bilgileri." Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Bir müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'de Müşteriler çalışma alanını seçip, müşteri listesinden müşteriyi ve ardından Hesapseçeneğini seçerek arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği bulun. Microsoft kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.
Dolaylı sağlayıcı veya doğrudan faturalandırma ortağının, sözleşmenin doğrudan imzalanma durumunu alabilmesi için müşteriyle etkin bir satış ilişkisine sahip olması gerekir.

C#

Müşterinin Microsoft Müşteri Sözleşmesi'ni doğrudan kabul etme durumunu almak için müşteri tanımlayıcısı ile IAggregatePartner.Customers.ById yöntemini çağırın. Ardından ICustomerAgreementCollection arabirimini almak için Sözleşmeleri özelliğini kullanın. Son olarak, durumu almak için GetDirectSignedCustomerAgreementStatus() veya GetDirectSignedCustomerAgreementStatusAsync() çağırın.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

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

REST isteği

Müşterinin Microsoft Müşteri Sözleşmesi'ni doğrudan kabul etme durumunu almak için müşteri için DirectSignedCustomerAgreementStatus almak üzere bir REST isteği oluşturun.

İstek söz dizimi

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

Yöntem	İstek URI'si
AL	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

URI parametreleri

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

İsim	Tür	Gerekli	Açıklama
müşteri-kiracı-id	GUID	Evet	Değer, müşterinin kiracı kimliğini belirtmenize olanak tanıyan GUID şeklinde CustomerTenantId'dır.

İstek üst bilgileri

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

İstek gövdesi

Hiç kimse.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde DirectSignedCustomerAgreementStatus kaynak döndürür.

Kaynağın, müşterinin doğrudan imzalama (doğrudan kabul) durumunu gösteren isSigned özelliği vardır.

true değeri, sözleşmenin doğrudan müşteri tarafından imzalandığını (kabul edildi) gösterir.
false değeri, sözleşmenin doğrudan müşteri tarafından imzalanmamış (kabul edildiğini) gösterir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve daha fazla hata ayıklama bilgisi ile 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: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Aracılığıyla paylaş