Hämta en nedladdningslänk för mallen Microsoft-kundavtal

  • Artikel

Gäller för: Partnercenter

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

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

Den här artikeln beskriver hur du hämtar en länk för att ladda ned mallen 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.

    Viktigt!

    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:er för Partnercenter.

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

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

  • Språket där Microsoft-kundavtal mallen ska lokaliseras.

Viktigt!

  • Microsoft-kundavtal är land/regionspecifik. När du begär en länk för att ladda ned mallen 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-kundavtal 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-kundavtal.

.NET

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

  1. Hämta avtalsmetadata för Microsoft-kundavtal. Du måste hämta templateId för Microsoft-kundavtal. 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 för Microsoft-kundavtal.

  4. Hämta egenskapen Dokument.

  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 klassen GetAgreementDetails från konsoltestappprojektet .

REST-begäran

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

  1. Hämta avtalsmetadata för Microsoft-kundavtal. Du måste hämta templateId för Microsoft-kundavtal. 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. Ett exempel finns i exemplet med begärandesyntax. Du måste ange följande information:

    • TemplateId för Microsoft-kundavtal
    • Det land/den region som mallen för Microsoft-kundavtal gäller för
    • Språket där Microsoft-kundavtal mallen ska lokaliseras

Syntax för begäran

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

Metod URI för förfrågan
GET {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 Obligatoriskt Beskrivning
agreement-template-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 string Nej Anger det land/den region som avtalsmallen gäller för. Frågan är som standard USA 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 string 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.

Begärandetext

Inga.

Exempel på begäran

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: aaaa0000-bb11-2222-33cc-444444dddddd

REST-svar

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

Resursen har en downloadUri-egenskap 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. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

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

Viktigt!

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 AX en-US
Afghanistan AF en-US
Albanien AL en-US
Algeriet DZ en-US, fr-FR, en-US
Amerikanska Samoa AS en-US
Andorra AD en-US
Angola AO en-US, pt-PT
Anguilla AI en-US
Antarktis AQ en-US
Antigua och Barbuda AG en-US
Argentina AR en-US, es-ES
Armenien AM en-US
Aruba AW en-US
Australien AU en-US
Österrike AT en-US, de-DE
Azerbajdzjan AZ en-US
Bahamas BS en-US
Bahrain BH en-US, ar-SA
Bangladesh BD en-US
Barbados BB en-US
Vitryssland BY en-US, ru-RU
Belgien BE 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 och Hercegovina BA en-US
Botswana BW en-US
Bouvetön BV en-US
Brasilien BR en-US, pt-BR
Brittiska territoriet i Indiska Oceanen IO en-US
Brittiska Jungfruöarna VG en-US
Brunei BN en-US
Bulgarien BG en-US, bg-BG
Burkina Faso BF en-US
Burundi BI en-US
Côte d'Ivoire CI en-US, fr-FR
Kap Verde CV en-US, pt-PT
Kambodja KH en-US
Kamerun KB 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
Kokosöarna CC en-US
Colombia CO en-US, es-ES
Komorerna KM en-US
Kongo (DR) CD en-US
Kongo CG en-US
Cooköarna CK en-US
Costa Rica CR en-US, es-ES
Kroatien Personal en-US, hr-HR
Curaçao LV 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 DO en-US, es-ES
Ecuador EC en-US
Egypten EG 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 sydterritorierna TF en-US
Gabon Allmän tillgänglighet en-US
Gambia GM en-US
Georgia GE en-US
Tyskland DE en-US, de-DE
Ghana GH en-US
Gibraltar GI 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- 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 IS en-US
Indien IN en-US, hi-IN
Indonesien ID en-US, id-ID
Irak IQ en-US, ar-SA
Irland IE en-US
Isle of Man IM en-US
Israel IL 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 en-US, ar-SA
Kazakstan KZ en-US, kk-KZ
Kenya KE en-US
Kiribati KI en-US
Sydkorea KR en-US, ko-KR
Kosovo XK en-US
Kuwait KW en-US, ar-SA
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
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 MY 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 MD en-US, ro-RO
Monaco MC en-US, fr-FR
Mongoliet MN en-US
Montenegro ME en-US
Montserrat MS en-US
Marocko MA 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 NL 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 MP en-US
Nordmakedonien MK en-US
Norge NEJ en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau PW 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 en-US, pt-PT
Puerto Rico PR en-US, en-US
Qatar Frågor svar en-US, ar-SA
Réunion RE 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 :A 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 en-US, en-US
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 en-US, en-US
Slovakien SK en-US, sk-SK
Slovenien SI en-US, sl-SI
Solomonöarna SB en-US
Somalia SO 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
S:t Helena, Ascension, Tristan da Cunha SH en-US
Surinam SR en-US
Svalbard SJ en-US
Sverige SE 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 TO 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
Förenta staternas mindre öar i Oceanien och Västindien 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öarna WF en-US
Jemen YE en-US, ar-SA
Zambia ZM en-US
Zimbabwe ZW en-US