Microsoft Müşteri Sözleşmesi şablonu için indirme bağlantısı 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

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

Bu makalede, müşterinin ülke/bölge ve diline göre Microsoft Müşteri Sözleşmesi şablonunu indirmeye yönelik bir bağlantının nasıl alındığı açıklanı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üşterinin Microsoft Müşteri Sözleşmesi şablonunun uygulandığı ülke/bölge.

  • Microsoft Müşteri Sözleşmesi şablonunun yerelleştirilmesi gereken dil.

Önemli

  • Microsoft Müşteri Sözleşmesi ülkeye/bölgeye özgüdür. Microsoft Müşteri Sözleşmesi şablonunu indirmek için bir bağlantı isterken müşterinin konumuna göre doğru ülkeyi/bölgeyi belirttiğinizden emin olun. veya desteklenen ülkelerin/bölgelerin listesini görmek için desteklenen ülkeler/bölgeler ve diller listesine bakın.
  • Bazı ülkelerde/bölgelerde Microsoft Müşteri Sözleşmesi birden çok dilde kullanılabilir. En iyi müşteri deneyimi için müşterinin ihtiyaçlarına en uygun dili seçin. Desteklenen dillerin listesi için desteklenen ülkelerin/bölgelerin ve dillerin listesi bölümüne bakın.
  • Bu yöntem yalnızca Microsoft Müşteri Sözleşmesi ile desteklenir.

.NET

Microsoft Müşteri Sözleşmesi şablonunu indirme bağlantısını almak için:

  1. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alın. Microsoft Müşteri Sözleşmesi templateId değerini almanız gerekir. Daha fazla bilgi için bkz. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alma.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. IAggregatePartner.AgreementTemplates koleksiyonunu kullanın.

  3. ById yöntemini çağırın ve Microsoft Müşteri Sözleşmesi templateId değerini belirtin.

  4. Document özelliğini getirin.

  5. ByCountry yöntemini çağırın ve müşterinin sözleşme şablonunun geçerli olduğu ülkeyi/bölgeyi belirtin. Yöntem belirtilmezse sorgu varsayılan olarak ABD'ye ayarlı olur. Desteklenen ülke/bölge kodlarının listesi için desteklenen ülkelerin/bölgelerin ve dillerin listesi bölümüne bakın. Bu yöntem büyük/küçük harfe duyarlıdır.

  6. ByLanguage yöntemini çağırın ve sözleşme şablonunun yerelleştirilmesi gereken dili belirtin. Yöntem belirtilmezse veya belirtilen ülke/bölge kodu belirtilen ülke/bölge için desteklenmiyorsa sorgu varsayılan olarak en-US olarak belirlenir. Desteklenen dil kodlarının listesi için desteklenen ülkelerin/bölgelerin ve dillerin listesi bölümüne bakın.

  7. Get veya GetAsync yöntemini çağırın.

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

var agreementDocument = partnerOperations.   AgreementTemplates.ById   (microsoftCustomerAgreementDetails.   TemplateId).Document.ByCountry   (customerCountry).ByLanguage   (languageForLocalization).Get();

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

REST isteği

Microsoft Müşteri Sözleşmesi şablonunu indirme bağlantısını almak için:

  1. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alın. Microsoft Müşteri Sözleşmesi templateId değerini almanız gerekir. Daha fazla bilgi için bkz. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alma.

  2. AgreementDocument kaynağını getirmek için bir REST isteği oluşturun. Örnek için istek söz dizimi örneğine bakın. Aşağıdaki bilgileri belirtmelisiniz:

    • Microsoft Müşteri Sözleşmesi templateId değeri
    • Microsoft Müşteri Sözleşmesi şablonunun uygulandığı ülke/bölge
    • Microsoft Müşteri Sözleşmesi şablonunun yerelleştirilmesi gereken dil

İstek söz dizimi

Bu kaynak için aşağıdaki istek söz dizimini kullanın:

Metot İstek URI'si
GET {baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

URI parametreleri

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

Adı Tür Zorunlu Açıklama
agreement-template-id string Yes Sözleşme türünün benzersiz tanımlayıcısı. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alarak Microsoft Müşteri Sözleşmesi için templateId değerini alabilirsiniz. Daha fazla bilgi için bkz. Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alma. Bu parametre büyük/küçük harfe duyarlıdır.
ülke Dize Hayır Anlaşma şablonunun uygulandığı ülkeyi/bölgeyi gösterir. Parametre belirtilmezse sorgu varsayılan olarak ABD'ye ayarlı olur. Desteklenen ülke/bölge kodlarının listesi için desteklenen ülkelerin/bölgelerin ve dillerin listesi bölümüne bakın.
dil Dize Hayır Sözleşme şablonunun yerelleştirilmesi gereken dili gösterir. Parametre belirtilmezse veya belirtilen ülke/bölge kodu belirtilen ülke/bölge için desteklenmiyorsa sorgu varsayılan olarak en-US olarak belirlenir. Desteklenen ülke/bölge kodlarının listesi için desteklenen ülkelerin/bölgelerin ve dillerin listesi bölümüne bakın.

İ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/agreementtemplates/117a77b0-9360-443b-8795-c6dedc750cf9/document?language=en-US&country=US 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 bir AgreementDocument kaynağı döndürür.

Kaynak, sözleşme şablonunu indirmek için kullanılabilecek bir URL dizesi içeren bir downloadUri özelliğine sahiptir. Her sorgu yaptığınızda farklı bir bağlantı döndürülür. Bu bağlantının süresi beş dakika sonra dolar.

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
{
    "displayUri":"https://wopihost.int.l2o.microsoft.com/v1/officehost/agreement/files/Preview...",
    "downloadUri":"https://l2oagreementintbn2.blob.core.windows.net/agreementscontainer/Preview...",
    "language":"en-US",
    "country":"US"
}

Desteklenen ülkelerin/bölgelerin ve dillerin listesi

Önemli

Ülke/bölge kodu özelliği büyük/küçük harfe duyarlıdır. Bu tabloda belirtilen doğru büyük/küçük harf kullanımını unutmayın:

Ülke/Bölge Ülke kodu Desteklenen dil kodları
Aland Adaları AX en-US
Afganistan AF en-US
Arnavutluk AL en-US
Cezayir DZ en-US, fr-FR, en-US
Amerikan Samoası AS en-US
Andorra AD en-US
Angola AO en-US, pt-PT
Anguilla AI en-US
Antarktika AQ en-US
Antigua ve Barbuda AG en-US
Arjantin AR en-US, es-ES
Ermenistan AM en-US
Aruba AW en-US
Avustralya AU en-US
Avusturya AT en-US, de-DE
Azerbaycan AZ en-US
Bahamalar BS en-US
Bahreyn BH en-US, ar-SA
Bangladeş BD en-US
Barbados BB en-US
Belarus BY en-US, ru-RU
Belçika BE en-US, nl-NL
Belize BZ en-US, es-ES
Benin BJ en-US
Bermuda BM en-US
Butan BT en-US
Bolivya BO en-US, es-ES
Bonaire BQ en-US
Bosna-Hersek BA en-US
Botsvana BW en-US
Bouvet Adası BV en-US
Brezilya BR en-US, pt-BR
Britanya Hint Okyanusu Toprakları IO en-US
Britanya Virjin Adaları VG en-US
Brunei BN en-US
Bulgaristan BG en-US, bg-BG
Burkina Faso BF en-US
Burundi BI en-US
Fildişi Sahili (Côte d'Ivoire) CI en-US, fr-FR
Cape Verde CV en-US, pt-PT
Kamboçya KH en-US
Kamerun CM en-US, fr-FR
Kanada CA en-US, fr-FR
Cayman Adaları KY en-US, en-US
Orta Afrika Cumhuriyeti CF en-US
Çad TD en-US
Şili CL en-US, es-ES
Christmas Adası CX en-US
Cocos (Keeling) Adaları CC en-US
Kolombiya CO en-US, es-ES
Komorlar KM en-US
Kongo (KDC) CD en-US
Kongo Cumhuriyeti CG en-US
Cook Adaları CK en-US
Kosta Rika CR en-US, es-ES
Hırvatistan İK en-US, hr-HR
Curaçao CW en-US
Kıbrıs CY en-US
Çekya CZ en-US, cs-CZ
Danimarka DK en-US, da-DK
Cibuti DJ en-US
Dominika DM en-US
Dominik Cumhuriyeti DO en-US, es-ES
Ekvador EC en-US
Mısır EG en-US, ar-SA
El Salvador SV en-US, es-ES
Ekvator Ginesi GQ en-US
Eritre YR en-US
Estonya EE en-US, et-EE
eSwatini SZ en-US
Etiyopya ET en-US
Falkland Adaları FK en-US
Faroe Adaları FO en-US
Fiji FJ en-US
Finlandiya FI en-US, fi-FI
Fransa FR en-US, fr-FR
Fransız Guyanası GF en-US, fr-FR
Fransız Polinezyası PF en-US
Fransız Güney Toprakları TF en-US
Gabon GA en-US
Gambiya GM en-US
Gürcistan GE en-US
Almanya DE en-US, de-DE
Gana GH en-US
Cebelitarık GI en-US
Yunanistan GR en-US, el-GR
Grönland GL en-US
Grenada GD en-US
Guadeloupe GP en-US
Guam GU en-US
Guatemala GT en-US, es-ES
Guernsey GG en-US
Gine GN en-US
Gine-Bissau GW en-US
Guyana GY en-US
Haiti HT en-US
Heard Adası ve McDonald Adaları HM en-US
Honduras HN en-US, es-ES
Hong Kong Özel Yönetici sistrative Bölgesi HK en-US, zh-HK
Macaristan HU en-US, hu-HU
İzlanda IS en-US
Hindistan IN en-US, hi-IN
Endonezya Kimlik en-US, id-ID
Irak IQ en-US, ar-SA
İrlanda IE en-US
Man Adası IM en-US
İsrail IL en-US, he-IL
İtalya BT en-US, it-IT
Jamaika JM en-US
Jan Mayen XJ en-US
Japonya JP en-US, ja-JP
Jersey JE en-US
Ürdün JO en-US, ar-SA
Kazakistan KZ en-US, kk-KZ
Kenya KE en-US
Kiribati KI en-US
Güney Kore KR en-US, ko-KR
Kosova XK en-US
Kuveyt KW en-US, ar-SA
Kırgızistan KG en-US, ru-RU
Laos LA en-US
Letonya LV en-US, lv-LV
Lübnan LB en-US, ar-SA
Lesotho LS en-US
Liberya LR en-US
Libya LY en-US, ar-SA
Liechtenstein LI en-US, de-DE
Litvanya LT en-US, lt-LT
Lüksemburg LU en-US, fr-FR
Makao Özel Yönetici Istrative Bölgesi MO en-US, zh-HK
Madagaskar MG en-US
Malavi MW en-US
Malezya MY en-US, ms-MY
Maldivler MV en-US
Mali ML en-US
Malta MT en-US
Marshall Adaları MH en-US
Martinique MQ en-US
Moritanya MR en-US
Mauritius MU en-US, ar-SA
Mayotte YT en-US
Meksika MX en-US, es-ES
Mikronezya FM en-US
Moldova MD en-US, ro-RO
Monako MC en-US, fr-FR
Moğolistan MN en-US
Karadağ ME en-US
Montserrat MS en-US
Fas MA en-US, fr-FR, en-US
Mozambik MZ en-US
Myanmar MM en-US
Namibya NA en-US
Nauru NR en-US
Nepal NP en-US
Hollanda NL en-US, nl-NL
Yeni Kaledonya NC en-US
Yeni Zelanda NZ en-US
Nikaragua NI en-US, es-ES
Nijer NE en-US
Nijerya NG en-US
Niue NU en-US
Norfolk Adası NF en-US
Kuzey Mariana Adaları MP en-US
Kuzey Makedonya MK en-US
Norveç HAYIR en-US, nb-NO
Umman OM en-US, ar-SA
Pakistan PK en-US
Palau PW en-US
Filistin Yönetimi PS en-US
Panama PA en-US, es-ES
Papua Yeni Gine PG en-US
Paraguay PY en-US, es-ES
Peru PE en-US, es-ES
Filipinler PH en-US
Pitcairn Adaları PN en-US
Polonya PL en-US, pl-PL
Portekiz PT en-US, pt-PT
Porto Riko PR en-US, en-US
Katar QA en-US, ar-SA
Reunion RE en-US
Romanya RO en-US, ro-RO
Rusya RU en-US, ru-RU
Ruanda RW en-US, fr-FR
Sao Tome ve Principe ST en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
Saint Kitts ve Nevis KN en-US
Saint Lucia LC en-US, en-US
Saint Martin MF en-US, en-US
Saint Pierre ve Miquelon PM en-US
Saint Vincent ve Grenadinler VC en-US
Samoa WS en-US
San Marino SM en-US
Suudi Arabistan SA en-US
Senegal SN en-US, fr-FR
Sırbistan RS en-US, sr-Latn-RS, en-US
Seyşeller SC en-US
Sierra Leone SL en-US
Singapur SG en-US, zh-SG
Sint Eustatius XE en-US
Sint Maarten SX en-US, en-US
Slovakya SK en-US, sk-SK
Slovenya SI en-US, sl-SI
Solomon Adaları SB en-US
Somali SO en-US
Güney Afrika ZA en-US
Güney Georgia ve Güney Sandwich Adaları GS en-US
Güney Sudan SS en-US
İspanya ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
Saint Helena, Ascension ve Tristan da Cunha SH en-US
Surinam SR en-US
Svalbard SJ en-US
İsveç SE en-US, sv-SE
İsviçre CH en-US, fr-FR, en-US, en-US
Tayvan TW en-US, zh-HK
Tacikistan TJ en-US
Tanzanya TZ en-US
Tayland TH en-US, th-TH
Timor-Leste TL en-US
Togo TG en-US
Tokelau TK en-US
Tonga TO en-US
Trinidad ve Tobago TT en-US
Tunus TN en-US, fr-FR, en-US
Türkiye TR tr-US, tr-TR
Türkmenistan TM en-US
Turks ve Caicos Adaları TC en-US
Tuvalu TV en-US
ABD Küçük Harici Adaları UM en-US
ABD Virjin Adaları VI en-US
Uganda UG en-US
Ukrayna UA tr-US, uk-UA
Birleşik Arap Emirlikleri AE en-US, ar-SA
Birleşik Krallık GB en-US
ABD ABD en-US
Uruguay UY en-US, es-ES
Özbekistan UZ en-US, ru-RU
Vanuatu VU en-US
Vatikan VA en-US
Venezuela VE en-US, es-ES
Vietnam VN en-US, vi-VN
Wallis ve Futuna WF en-US
Yemen YE en-US, ar-SA
Zambiya ZM en-US
Zimbabve ZW en-US