Delen via

Ontvang een downloadlink voor de sjabloon van de Microsoft-klantovereenkomst

  • Artikel

van toepassing op: Partnercentrum

Is niet van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

De AgreementDocument-resource wordt momenteel alleen ondersteund door Partnercentrum in de Microsoft openbare cloud.

In dit artikel wordt beschreven hoe u een koppeling kunt maken om de sjabloon voor de Microsoft-klantovereenkomst te downloaden, op basis van het land/de regio en de taal van de klant.

Voorwaarden

  • Als u de .NET SDK van Partnercentrum gebruikt, is versie 1.14 of hoger vereist.

    Belangrijk

    Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een readme-bestand met nuttige informatie.

    Partners worden aangemoedigd om de Partner center REST API'ste blijven gebruiken.

  • Referenties zoals beschreven in Partnercentrum-authenticatie. Dit scenario biedt alleen ondersteuning voor App+User-verificatie.

  • Het land/de regio van de klant waarop de sjabloon voor de Microsoft-klantovereenkomst van toepassing is.

  • De taal waarin de sjabloon voor de Microsoft-klantovereenkomst moet worden gelokaliseerd.

Belangrijk

  • De Microsoft-klantovereenkomst is land-/regiospecifiek. Wanneer u een koppeling aanvraagt om de sjabloon voor de Microsoft-klantovereenkomst te downloaden, moet u het juiste land/de juiste regio opgeven op basis van de locatie van de klant. Voor Lijst met ondersteunde landen/regio's, raadpleeg Lijst met ondersteunde landen/regio's en talen.
  • Voor sommige landen/regio's is de Microsoft-klantovereenkomst beschikbaar in meerdere talen. Kies voor de beste klantervaring de taal die het beste aansluit bij de behoeften van de klant. Raadpleeg lijst met ondersteunde landen/regio's en talenvoor een lijst met ondersteunde talen.
  • Deze methode wordt alleen ondersteund met de Microsoft-klantovereenkomst.

.NET

Ga als volgende te werk om een koppeling op te halen om de sjabloon voor de Microsoft-klantovereenkomst te downloaden:

  1. Haal de metagegevens van de overeenkomst op voor de Microsoft-klantovereenkomst. U moet de templateId van de Microsoft-klantovereenkomst verkrijgen. Zie Metagegevens van overeenkomst ophalen voor Microsoft-klantovereenkomstvoor meer informatie.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Gebruik de verzameling IAggregatePartner.AgreementTemplates.

  3. Roep de methode ById aan en geef de templateId van de Microsoft-klantovereenkomst op.

  4. Haal de eigenschap Document op.

  5. Roep de methode ByCountry aan en geef het land/de regio van de klant op waarop de overeenkomstsjabloon van toepassing is. De query wordt standaard US als de methode niet is opgegeven. Raadpleeg voor een lijst met ondersteunde land-/regiocodes lijst met ondersteunde landen/regio's en talen. Deze methode is hoofdlettergevoelig.

  6. Roep de methode ByLanguage aan en geef de taal op waarin de overeenkomstsjabloon moet worden gelokaliseerd. De query wordt standaard en-US als de methode niet is opgegeven of als de opgegeven land-/regiocode niet wordt ondersteund voor het land of de opgegeven regio. Raadpleeg lijst met ondersteunde landen/regio's en talenvoor een lijst met ondersteunde taalcodes.

  7. Roep de methode Get of GetAsync aan.

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Een volledig voorbeeld vindt u in de GetAgreementDetails klasse uit de consoletest-app project.

REST-aanvraag

Ga als volgende te werk om een koppeling op te halen om de sjabloon voor de Microsoft-klantovereenkomst te downloaden:

  1. Haal de metagegevens van de overeenkomst op voor de Microsoft-klantovereenkomst. U moet de templateId van de Microsoft-klantovereenkomst verkrijgen. Zie Metagegevens van overeenkomst ophalen voor Microsoft-klantovereenkomstvoor meer informatie.

  2. Maak een REST-aanvraag om een AgreementDocument resourceop te halen. Voor een voorbeeld van de -aanvraagsyntaxis, zie. U moet de volgende gegevens opgeven:

    • De templateId van de Microsoft-klantovereenkomst
    • Het land/de regio waarop de sjabloon voor de Microsoft-klantovereenkomst van toepassing is
    • De taal waarin de sjabloon voor de Microsoft-klantovereenkomst moet worden gelokaliseerd

Aanvraagsyntaxis

Gebruik de volgende aanvraagsyntaxis voor deze resource:

Methode Aanvraag-URI
TOEVOEGEN {baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

URI parameters

U kunt de volgende URI-parameters gebruiken met uw aanvraag:

Naam Typ Vereist Beschrijving
overeenkomst-sjabloon-id string Ja Unieke identificator van het overeenkomsttype. U kunt de templateId voor de Microsoft-klantovereenkomst verkrijgen door de metagegevens van de overeenkomst voor de Microsoft-klantovereenkomst op te halen. Zie Metagegevens van overeenkomst ophalen voor Microsoft-klantovereenkomstvoor meer informatie. Deze parameter is hoofdlettergevoelig.
land snaar Nee Geeft het land/de regio aan waarop de overeenkomstsjabloon van toepassing is. De query wordt standaard US als de parameter niet is opgegeven. Raadpleeg voor een lijst met ondersteunde land-/regiocodes lijst met ondersteunde landen/regio's en talen.
Taal string Nee Geeft de taal aan waarin de overeenkomstsjabloon moet worden gelokaliseerd. De query wordt standaard en-US als de parameter niet is opgegeven of als de land-/regiocode die is opgegeven niet wordt ondersteund voor het land of de opgegeven regio. Raadpleeg Lijst met ondersteunde landen/regio's en talenvoor een lijst met ondersteunde land-/regiocodes.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Inhoud van het verzoek

Geen.

Aanvraagvoorbeeld

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-antwoord

Als dit lukt, retourneert deze methode een AgreementDocument resource in de hoofdtekst van het antwoord.

De resource heeft een eigenschap downloadUri, die een URL-tekenreeks bevat die kan worden gebruikt om de overeenkomstsjabloon te downloaden. Telkens wanneer u een query maakt, wordt er een andere koppeling geretourneerd. Deze koppeling verloopt na vijf minuten.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of de bewerking is geslaagd of mislukt, en andere informatie ten behoeve van foutopsporing.

Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

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"
}

Lijst met ondersteunde landen/regio's en talen

Belangrijk

De eigenschap land-/regiocode is hoofdlettergevoelig. Zorg ervoor dat u de juiste behuizing gebruikt die in deze tabel is opgegeven:

Land/regio Landcode Ondersteunde taalcodes
Ålandeilanden BIJL en-US
Afghanistan AF en-US
Albanië AL en-US
Algerije DZ en-US, fr-FR, en-US
Amerikaans-Samoa ALS en-US
Andorra ADVERTENTIE en-US
Angola AO en-US, pt-PT
Anguilla Kunstmatige Intelligentie en-US
Antarctica AQ en-US
Antigua en Barbuda Procureur-Generaal en-US
Argentinië AR en-US, es-ES
Armenië AM en-US
Aruba AW en-US
Australië AU en-US
Oostenrijk OP en-US, de-DE
Azerbeidzjan AZ en-US
Bahamas BS en-US
Bahrein BH en-US, ar-SA
Bangladesh BD en-US
Barbados BB en-US
Wit-Rusland BIJ en-US, ru-RU
België 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
Bosnië-Herzegovina BA en-US
Botswana BW en-US
Bouveteiland BV en-US
Brazilië BR en-US, pt-BR
Brits Territorium voor de Indische Oceaan IO en-US
Britse Maagdeneilanden Voldoende Goed en-US
Brunei BN en-US
Bulgarije BG en-US, bg-BG
Burkina Faso BF en-US
Burundi Business Intelligence en-US
Ivoorkust CI en-US, fr-FR
Cabo Verde CV en-US, pt-PT
Cambodja KH en-US
Kameroen CENTIMETER en-US, fr-FR
Canada CA en-US, fr-FR
Caymaneilanden KY en-US, en-US
Centraal-Afrikaanse Republiek CF en-US
Tsjaad TD en-US
Chili CL en-US, es-ES
Christmaseiland CX en-US
Cocoseilanden (Keeling) CC en-US
Colombia CO en-US, es-ES
Comoren KILOMETER en-US
Congo (DRC) CD en-US
Congo CG en-US
Cookeilanden CK en-US
Costa Rica CR en-US, es-ES
Kroatië HR en-US, hr-HR
Curaçao CW en-US
Cyprus CY en-US
Tsjechië CZ en-US, cs-CZ
Denemarken DK en-US, da-DK
Djibouti DJ en-US
Dominica DM en-US
Dominicaanse Republiek DOEN en-US, es-ES
Ecuador EG en-US
Egypte EG en-US, ar-SA
El Salvador SV en-US, es-ES
Equatoriaal-Guinea GQ en-US
Eritrea ER en-US
Estland EE en-US, et-EE
eSwatini SZ en-US
Ethiopië ET en-US
Falklandeilanden FK en-US
Faeröereilanden FO en-US
Fiji FJ en-US
Finland FI en-US, fi-FI
Frankrijk FR en-US, fr-FR
Frans-Guyana GF en-US, fr-FR
Frans-Polynesië PF en-US
Franse Zuidelijke Gebieden TF en-US
Gabon GA en-US
Gambia GM en-US
Georgië GE en-US
Duitsland DE en-US, de-DE
Ghana GH en-US
Gibraltar GI en-US
Griekenland GR en-US, el-GR
Groenland GL en-US
Grenada GD en-US
Guadeloupe huisarts en-US
Guam GU en-US
Guatemala GT en-US, es-ES
Guernsey GG en-US
Guinee GN en-US
Guinea-Bissau GW en-US
Guyana GY en-US
Haïti HT en-US
Heard Island en McDonaldeilanden HM en-US
Honduras HN en-US, es-ES
Speciale administratieve regio van Hongkong HK en-US, zh-HK
Hongarije HU en-US, hu-HU
IJsland IS en-US
India IN en-US, hi-IN
Indonesië ID-kaart en-US, id-ID
Irak IQ en-US, ar-SA
Ierland IE en-US
Isle of Man IM en-US
Israël IL en-US, he-IL
Italië IT en-US, it-IT
Jamaica JM en-US
Jan Mayen XJ en-US
Japan JP en-US, ja-JP
Jersey JE en-US
Jordanië JO en-US, ar-SA
Kazachstan KZ en-US, kk-KZ
Kenia KE en-US
Kiribati Kunstmatige Intelligentie en-US
Korea KR en-US, ko-KR
Kosovo XK en-US
Koeweit kW en-US, ar-SA
Kirgizië kg en-US, ru-RU
Laos LA en-US
Letland Letland en-US, lv-LV
Libanon LB en-US, ar-SA
Lesotho LS en-US
Liberia LR en-US
Libië LY en-US, ar-SA
Liechtenstein LI en-US, de-DE
Litouwen LT en-US, lt-LT
Luxemburg LU en-US, fr-FR
Speciale administratieve regio Van Macao MO en-US, zh-HK
Madagaskar MG en-US
Malawi MW en-US
Maleisië MIJN en-US, ms-MY
Maldiven MV en-US
Mali ML en-US
Malta MT en-US
Marshalleilanden MH en-US
Martinique MQ en-US
Mauritanië MENEER en-US
Mauritius MU en-US, ar-SA
Mayotte YT en-US
Mexico MX en-US, es-ES
Micronesië FM en-US
Moldavië MD en-US, ro-RO
Monaco MC en-US, fr-FR
Mongolië MN en-US
Montenegro MIJ en-US
Montserrat MEVROUW en-US
Marokko MA en-US, fr-FR, en-US
Mozambique MZ en-US
Myanmar MM en-US
Namibië NA en-US
Nauru NR en-US
Nepal NP en-US
Nederland NL en-US, nl-NL
Nieuw-Caledonië NC en-US
Nieuw-Zeeland NZ en-US
Nicaragua NI en-US, es-ES
Niger NE en-US
Nigeria NG en-US
Niue NU en-US
Norfolk-eiland NF en-US
Noordelijke Marianaeilanden Lid van het Parlement en-US
Noord-Macedonië MK en-US
Noorwegen NEE en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau KRIJGSGEVANGENE en-US
Palestijnse Autoriteit PS en-US
Panama PA en-US, es-ES
Papoea-Nieuw-Guinea PG en-US
Paraguay PY en-US, es-ES
Peru PE en-US, es-ES
Filipijnen PH en-US
Pitcairneilanden PN en-US
Polen PL en-US, pl-PL
Portugal PT en-US, pt-PT
Puerto Rico Public relations (PR) en-US, en-US
Qatar Kwaliteitsborging en-US, ar-SA
Réunion RE en-US
Roemenië RO en-US, ro-RO
Rusland RU en-US, ru-RU
Rwanda RW en-US, fr-FR
São Tomé en Príncipe ST en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
Saint Kitts en Nevis KN en-US
Saint Lucia LC en-US, en-US
Sint-Martin MF en-US, en-US
Saint Pierre en Miquelon PM en-US
Saint Vincent en de Grenadines VC en-US
Samoa WS en-US
San Marino SM en-US
Saudi-Arabië SA en-US
Senegal SN en-US, fr-FR
Servië RS en-US, sr-Latn-RS, en-US
Seychellen 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
Slowakije SK en-US, sk-SK
Slovenië SI en-US, sl-SI
Salomonseilanden SB en-US
Somalië DUS en-US
Zuid-Afrika ZA en-US
Zuid-Georgië en Zuidelijke Sandwicheilanden GS en-US
Zuid-Soedan SS en-US
Spanje ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
Sint-Helena, Ascension, Tristan da Cunha SH en-US
Suriname SR en-US
Spitsbergen SJ en-US
Zweden SE en-US, sv-SE
Zwitserland 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 GS en-US
Tokelau TK en-US
Tonga AAN en-US
Trinidad en Tobago TT en-US
Tunesië TN en-US, fr-FR, en-US
Turkije TR en-US, tr-TR
Turkmenistan TM en-US
Turks- en Caicoseilanden TC en-US
Tuvalu televisie en-US
Amerikaanse uitvaleilanden UM en-US
Amerikaanse Maagdeneilanden VI en-US
Oeganda UG en-US
Oekraïne UA en-US, uk-UA
Verenigde Arabische Emiraten AE en-US, ar-SA
Verenigd Koninkrijk GB en-US
Verenigde Staten VS en-US
Uruguay UY en-US, es-ES
Oezbekistan UZ en-US, ru-RU
Vanuatu VU en-US
Vaticaanstad VA en-US
Venezuela VE en-US, es-ES
Vietnam VN en-US, vi-VN
Wallis en Futuna WF en-US
Jemen YE en-US, ar-SA
Zambia ZM en-US
Zimbabwe ZW en-US