Microsoft Müşteri Sözleşmesi için anlaşma meta verilerini alma

  • Makale

Ş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

Microsoft Müşteri Sözleşmesi için sözleşme meta verileri şu anda yalnızca Microsoft genel bulutunda İş Ortağı Merkezi tarafından desteklenmektedir.

Aşağıdakileri yapabilirsiniz önce Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini almanız gerekir:

Ö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 App+User kimlik doğrulamalarını destekler.

.NET (sürüm 1.14 veya üzeri)

Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini almak için:

  1. İlk olarak, IAggregatePartner.AgreementDetails koleksiyonunu alın.

  2. Koleksiyonu Microsoft Müşteri Sözleşmesi olarak filtrelemek için ByAgreementType yöntemini çağırın.

  3. Son olarak Get veya GetAsync yöntemini çağır.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();

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

REST isteği

Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini almak için:

  1. AgreementMetaData koleksiyonunu almak için bir REST isteği oluşturun.

  2. Sonucu yalnızca Microsoft Müşteri Sözleşmesi kapsamına almak için agreementType sorgu parametresini kullanın.

İstek söz dizimi

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

URI parametreleri

İsteğinizle birlikte aşağıdaki URI parametrelerini kullanın:

Adı Tür Zorunlu Açıklama
sözleşme türü Dize Hayı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ünde sözleşme meta verilerini içeren MicrosoftCloudAgreement

Yalnızca MicrosoftCustomerAgreement türünde sözleşme meta verilerini içeren MicrosoftCustomerAgreement.

* tüm sözleşme meta verilerini döndürür. (Microsoft herhangi bir zamanda yeni sözleşme türleriyle sözleşme meta verilerini kullanıma sunabileceğinden, kodunuz bilinmeyen sözleşme türlerini işlemek için gerekli çalışma zamanı mantığına sahip değilse kullanmayın * .)

Not: URI parametresi belirtilmezse, geriye dönük uyumluluk için sorgu varsayılan olarak MicrosoftCloudAgreement olur.

İ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/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övdesindeki AgreementMetaData 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": 1,
    "items": [
        {
            "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
            "agreementType": "MicrosoftCustomerAgreement",
            "agreementLink": "https://aka.ms/customeragreement",
            "versionRank": 0
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}