Dela via

Hämta en nedladdningslänk för Microsoft-kundavtalsmallen

  • Artikel

gäller för: Partnercenter

Gäller inte för: Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Resursen AgreementDocument stöds för närvarande endast av Partnercenter i Microsofts offentliga moln.

I den här artikeln beskrivs hur du hämtar en länk för att ladda ned mallen för Microsoft-kundavtal baserat på kundens land/region och språk.

Förutsättningar

  • Om du använder .NET SDK för Partnercenter krävs version 1.14 eller senare.

    Viktig

    Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub, tillsammans med en readme-fil som innehåller användbar information.

    Partner uppmanas att fortsätta att använda rest-API:erna för Partnercenter.

  • Autentiseringsuppgifter enligt beskrivningen i PartnerCenter-autentisering. Det här scenariot stöder endast App+User-autentisering.

  • Kundens land/region som Mallen för Microsoft-kundavtal gäller för.

  • Det språk där Microsoft-kundavtalsmallen ska lokaliseras.

Viktig

  • Microsoft-kundavtalet är land-/regionspecifikt. När du begär en länk för att ladda ned mallen för Microsoft-kundavtal måste du ange rätt land/region baserat på kundens plats. eller lista över länder/regioner som stöds, se Lista över länder/regioner och språk som stöds.
  • För vissa länder/regioner är Microsoft-kundavtalet tillgängligt på flera språk. För bästa kundupplevelse väljer du det språk som bäst matchar kundens behov. En lista över språk som stöds finns i Lista över länder/regioner och språk som stöds.
  • Den här metoden stöds endast med Microsoft-kundavtalet.

.NÄT

Så här hämtar du en länk för att ladda ned mallen för Microsoft-kundavtal:

  1. Hämta avtalsmetadata för Microsoft-kundavtalet. Du måste hämta templateId från Microsoft-kundavtalet. Mer information finns i Hämta avtalsmetadata för Microsoft-kundavtal.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Använd samlingen IAggregatePartner.AgreementTemplates.

  3. Anropa metoden ById och ange templateId i Microsoft-kundavtalet.

  4. Hämta egenskapen Document.

  5. Anropa metoden ByCountry och ange kundens land/region som avtalsmallen gäller för. Frågan är som standard USA om metoden inte har angetts. En lista över lands-/regionkoder som stöds finns i Lista över länder/regioner och språk som stöds. Den här metoden är skiftlägeskänslig.

  6. Anropa metoden ByLanguage och ange det språk som avtalsmallen ska lokaliseras till. Frågan är som standard en-US om metoden inte har angetts eller om den angivna lands-/regionkoden inte stöds för det angivna landet/regionen. En lista över språkkoder som stöds finns i Lista över länder/regioner och språk som stöds.

  7. Anropa metoden Get eller GetAsync.

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Ett fullständigt exempel finns i GetAgreementDetails-klassen från -konsolens testapp projektet.

REST-begäran

Så här hämtar du en länk för att ladda ned mallen för Microsoft-kundavtal:

  1. Hämta avtalsmetadata för Microsoft-kundavtalet. Du måste hämta templateId från Microsoft-kundavtalet. Mer information finns i Hämta avtalsmetadata för Microsoft-kundavtal.

  2. Skapa en REST-begäran för att hämta en AgreementDocument resurs. För ett exempel, se syntax för begäran . Du måste ange följande information:

    • templateId för Microsoft-kundavtalet
    • Det land/den region som Microsoft-kundavtalsmallen gäller för
    • Det språk där Microsoft-kundavtalsmallen ska lokaliseras

Syntax för förfrågan

Använd följande begärandesyntax för den här resursen:

Metod Begär URI
HÄMTA {baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

URI-parametrar

Du kan använda följande URI-parametrar med din begäran:

Namn Typ Krävs Beskrivning
avtal-mall-id sträng Ja Unik identifierare för avtalstypen. Du kan hämta templateId för Microsoft-kundavtal genom att hämta avtalsmetadata för Microsoft-kundavtal. Mer information finns i Hämta avtalsmetadata för Microsoft-kundavtal. Den här parametern är skiftlägeskänslig.
land sträng Nej Anger det land/den region som avtalsmallen gäller för. Förfrågan har standardvärdet amerikanska om parametern inte har angetts. En lista över lands-/regionkoder som stöds finns i Lista över länder/regioner och språk som stöds.
Språk sträng Nej Anger på vilket språk avtalsmallen ska lokaliseras. Frågan är som standard en-US om parametern inte har angetts eller om lands-/regionkoden som anges i inte stöds för det angivna landet/regionen. En lista över lands-/regionkoder som stöds finns i Lista över länder/regioner och språk som stöds.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Innehåll i begäran

Ingen.

Exempel på begäran

GET https://api.partnercenter.microsoft.com/v1/agreementtemplates/aaaabbbb-0000-cccc-1111-dddd2222eeee/document?language=en-US&country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-svar

Om det lyckas returnerar den här metoden en AgreementDocument- resurs i svarstexten.

Resursen har egenskapen downloadUri, som innehåller en URL-sträng som kan användas för att ladda ned avtalsmallen. En annan länk returneras varje gång du gör en fråga. Den här länken upphör att gälla efter fem minuter.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och annan felsökningsinformation.

Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. För den fullständiga listan, se Partnercenter-REST-felkoder.

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "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"
}

Lista över länder/regioner och språk som stöds

Viktig

Lands-/regionkodegenskapen är skiftlägeskänslig. Se till att använda rätt hölje som anges i den här tabellen:

Land/region Landskod Språkkoder som stöds
Åland YXA en-US
Afghanistan AF en-US
Albanien AL en-US
Algeriet DZ en-US, fr-FR, en-US
Amerikanska Samoa SOM en-US
Andorra REKLAM en-US
Angola AO en-US, pt-PT
Anguilla Artificiell intelligens en-US
Antarktis AQ en-US
Antigua och Barbuda AG en-US
Argentina AR en-US, es-ES
Armenien VARA en-US
Aruba AW en-US
Australien AU en-US
Österrike VID en-US, de-DE
Azerbajdzjan AZ en-US
Bahamas Kandidatexamen i naturvetenskap en-US
Bahrain BH en-US, ar-SA
Bangladesh BD en-US
Barbados BB en-US
Vitryssland VID en-US, ru-RU
Belgien VARA en-US, nl-NL
Belize BZ en-US, es-ES
Benin BJ en-US
Bermuda BM en-US
Bhutan BT en-US
Bolivia BO en-US, es-ES
Bonaire BQ en-US
Bosnien-Hercegovina BA en-US
Botswana BW en-US
Bouvet Island BV en-US
Brasilien BR en-US, pt-BR
Brittiska Indiska oceanens territorium IO en-US
Brittiska Jungfruöarna VG en-US
Brunei BN en-US
Bulgarien BG en-US, bg-BG
Burkina Faso pojkvän en-US
Burundi Business Intelligence en-US
Elfenbenskusten CI en-US, fr-FR
Cabo Verde CV en-US, pt-PT
Kambodja KH en-US
Kamerun CENTIMETER en-US, fr-FR
Kanada CA en-US, fr-FR
Caymanöarna KY en-US, en-US
Centralafrikanska republiken CF en-US
Tchad TD en-US
Chile CL en-US, es-ES
Julön CX en-US
Cocosöarna (Keeling) cc en-US
Colombia CO en-US, es-ES
Komorerna KILOMETER en-US
Kongo (DRC) CD en-US
Kongo CG en-US
Cooköarna CK en-US
Costa Rica CR en-US, es-ES
Kroatien Personalavdelning en-US, hr-HR
Curaçao CW en-US
Cypern CY en-US
Tjeckien CZ en-US, cs-CZ
Danmark DK en-US, da-DK
Djibouti DJ en-US
Dominica DM en-US
Dominikanska republiken göra en-US, es-ES
Ecuador EG en-US
Egypten T.EX en-US, ar-SA
El Salvador SV en-US, es-ES
Ekvatorialguinea GQ en-US
Eritrea ER en-US
Estland EE en-US, et-EE
eSwatini SZ en-US
Etiopien ET en-US
Falklandsöarna FK en-US
Färöarna FO en-US
Fiji FJ en-US
Finland FI en-US, fi-FI
Frankrike FR en-US, fr-FR
Franska Guyana GF en-US, fr-FR
Franska Polynesien PF en-US
Franska södra territorier TF en-US
Gabon GA en-US
Gambia GM en-US
Georgien GE en-US
Tyskland DE en-US, de-DE
Ghana GH en-US
Gibraltar Glykemiskt Index en-US
Grekland 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
Guinea GN en-US
Guinea-Bissau GW en-US
Guyana GY en-US
Haiti HT en-US
Heard Island och McDonaldöarna HM en-US
Honduras HN en-US, es-ES
Hongkongs särskilda administrativa region HK en-US, zh-HK
Ungern HU en-US, hu-HU
Island VARA en-US
Indien I en-US, hi-IN
Indonesien ID en-US, id-ID
Irak IQ en-US, ar-SA
Irland Internet Explorer en-US
Isle of Man IM en-US
Israel Illinois en-US, he-IL
Italien IT en-US, it-IT
Jamaica JM en-US
Jan Mayen XJ en-US
Japan JP en-US, ja-JP
Jersey JE en-US
Jordanien JO engelska (USA), arabiska (Saudiarabien)
Kazakstan KZ en-US, kk-KZ
Kenya KE Hej, hur mår du?
Kiribati KI en-US
Korea KR en-US, ko-KR
Kosovo XK en-US
Kuwait KW engelska (USA), arabiska (Saudiarabien)
Kirgizistan kg en-US, ru-RU
Laos LA en-US
Lettland LV en-US, lv-LV
Libanon LB en-US, ar-SA
Lesotho LS en-US
Liberia LR en-US
Libyen LY en-US, ar-SA (engelska (USA), arabiska (Saudiarabien))
Liechtenstein LI en-US, de-DE
Litauen LT en-US, lt-LT
Luxemburg LU en-US, fr-FR
Macao, särskild administrativ region MO en-US, zh-HK
Madagaskar MG en-US
Malawi MW en-US
Malaysia MIN en-US, ms-MY
Maldiverna MV en-US
Mali ML en-US
Malta MT en-US
Marshallöarna MH en-US
Martinique MQ en-US
Mauretanien MR en-US
Mauritius MU en-US, ar-SA
Mayotte YT en-US
Mexico MX en-US, es-ES
Mikronesien FM en-US
Moldavien Medicinsk doktor en-US, ro-RO
Monaco MC en-US, fr-FR
Mongoliet MN en-US
Montenegro MIG en-US
Montserrat MS en-US
Marocko MOR en-US, fr-FR, en-US
Moçambique MZ en-US
Myanmar MM en-US
Namibia NA en-US
Nauru NR en-US
Nepal NP en-US
Nederländerna Nederländerna en-US, nl-NL
Nya Kaledonien NC en-US
Nya Zeeland NZ en-US
Nicaragua NI en-US, es-ES
Niger NE en-US
Nigeria NG en-US
Niue NU en-US
Norfolkön NF en-US
Nordmarianerna PARLAMENTSLEDAMOT en-US
Nordmakedonien MK en-US
Norge NEJ Språkkoder: en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau KF en-US
Palestinska myndigheten PS en-US
Panama PA en-US, es-ES
Papua Nya Guinea PG en-US
Paraguay PY en-US, es-ES
Peru PE en-US, es-ES
Filippinerna PH en-US
Pitcairnöarna PN en-US
Polen PL en-US, pl-PL
Portugal PT (Personlig Tränare) en-US, pt-PT
Puerto Rico PR (offentliga relationer) engelska (USA), engelska (USA)
Qatar Kvalitetssäkring en-US, ar-SA
Réunion SV en-US
Rumänien RO en-US, ro-RO
Ryssland RU en-US, ru-RU
Rwanda RW en-US, fr-FR
São Tomé och Príncipe Sankt en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
Saint Kitts och Nevis KN en-US
Saint Lucia LC en-US, en-US
Saint Martin MF sv-SE, sv-SE
Saint Pierre och Miquelon PM en-US
Saint Vincent och Grenadinerna VC en-US
Samoa WS en-US
San Marino SM en-US
Saudiarabien SA en-US
Senegal SN en-US, fr-FR
Serbien RS en-US, sr-Latn-RS, en-US
Seychellerna SC en-US
Sierra Leone SL en-US
Singapore SG en-US, zh-SG
Sint Eustatius XE en-US
Sint Maarten SX sv-SE, sv-SE
Slovakien SK en-US, sk-SK
Slovenien SI en-US, sl-SI
Salomonöarna SB en-US
Somalia SÅ en-US
Sydafrika ZA en-US
Sydgeorgien och Sydsandwichöarna GS en-US
Sydsudan SS en-US
Spanien ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
St Helena, Ascension, Tristan da Cunha SH en-US
Surinam SR en-US
Svalbard SJ en-US
Sverige SE en-US, sv-SE
Schweiz CH en-US, fr-FR, en-US, en-US
Taiwan TW en-US, zh-HK
Tadzjikistan TJ en-US
Tanzania TZ en-US
Thailand TH en-US, th-TH
Timor-Leste TL en-US
Togo TG en-US
Tokelau TK en-US
Tonga TILL en-US
Trinidad och Tobago TT en-US
Tunisien TN en-US, fr-FR, en-US
Turkiet TR en-US, tr-TR
Turkmenistan TM en-US
Turks- och Caicosöarna TC en-US
Tuvalu TV en-US
Amerikanska avlägsna öar UM en-US
Amerikanska Jungfruöarna VI en-US
Uganda UG en-US
Ukraina UA en-US, uk-UA
Förenade Arabemiraten AE en-US, ar-SA
Storbritannien GB en-US
USA USA en-US
Uruguay UY en-US, es-ES
Uzbekistan UZ en-US, ru-RU
Vanuatu VU en-US
Vatikanstaten VA en-US
Venezuela VE en-US, es-ES
Vietnam VN en-US, vi-VN
Wallis och Futuna WF en-US
Jemen YE en-US, ar-SA
Zambia ZM en-US
Zimbabwe ZW en-US