Abrufen eines Downloadlinks für die Vorlage des Microsoft-Kundenvertrags

  • Artikel

Gilt für: Partner Center

Gilt nicht für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Die AgreementDocument-Ressource wird derzeit nur von Partner Center in der öffentlichen Microsoft-Cloud unterstützt.

In diesem Artikel wird beschrieben, wie Sie einen Link abrufen, um die Microsoft-Kundenvereinbarung Vorlage basierend auf dem Land/der Region und sprache des Kunden herunterzuladen.

Voraussetzungen

  • Wenn Sie das Partner Center .NET SDK verwenden, ist Version 1.14 oder höher erforderlich.

    Wichtig

    Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

    Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur App- und Benutzerauthentifizierung.

  • Das Land/die Region des Kunden, für das die Microsoft-Kundenvereinbarung Vorlage gilt.

  • Die Sprache, in der die Microsoft-Kundenvereinbarung-Vorlage lokalisiert werden soll.

Wichtig

  • Die Microsoft-Kundenvereinbarung ist länder-/regionsspezifisch. Wenn Sie einen Link zum Herunterladen der Microsoft-Kundenvereinbarung Vorlage anfordern, müssen Sie unbedingt das richtige Land/die richtige Region basierend auf dem Standort des Kunden angeben. oder eine Liste der unterstützten Länder/Regionen finden Sie unter Liste der unterstützten Länder/Regionen und Sprachen.
  • Für einige Länder/Regionen ist die Microsoft-Kundenvereinbarung in mehreren Sprachen verfügbar. Um eine optimale Kundenerfahrung zu erzielen, wählen Sie die Sprache aus, die den Anforderungen des Kunden am besten entspricht. Eine Liste der unterstützten Sprachen finden Sie in der Liste der unterstützten Länder/Regionen und Sprachen.
  • Diese Methode wird nur mit dem Microsoft-Kundenvereinbarung unterstützt.

.NET

So rufen Sie einen Link zum Herunterladen der Microsoft-Kundenvereinbarung Vorlage ab:

  1. Rufen Sie die Metadaten der Vereinbarung für die Microsoft-Kundenvereinbarung ab. Sie müssen die templateID der Microsoft-Kundenvereinbarung abrufen. Weitere Informationen finden Sie unter Abrufen von Vertragsmetadaten für die Microsoft-Kundenvereinbarung.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Verwenden Sie die IAggregatePartner.AgreementTemplates-Auflistung.

  3. Rufen Sie die ById-Methode auf, und geben Sie die templateId des Microsoft-Kundenvereinbarung an.

  4. Ruft die Document-Eigenschaft ab.

  5. Rufen Sie die ByCountry-Methode auf, und geben Sie das Land/die Region des Kunden an, für das die Vertragsvorlage gilt. Die Abfrage wird standardmäßig auf "US" festgelegt, wenn die Methode nicht angegeben ist. Eine Liste der unterstützten Länder-/Regionscodes finden Sie in der Liste der unterstützten Länder/Regionen und Sprachen. Bei dieser Methode wird die Groß-/Kleinschreibung beachtet.

  6. Rufen Sie die ByLanguage-Methode auf, und geben Sie die Sprache an, in der die Vertragsvorlage lokalisiert werden soll. Die Abfrage wird standardmäßig auf "en-US " festgelegt, wenn die Methode nicht angegeben ist oder der angegebene Code für Land/Region für das angegebene Land/die Region nicht unterstützt wird. Eine Liste der unterstützten Sprachcodes finden Sie in der Liste der unterstützten Länder/Regionen und Sprachen.

  7. Rufen Sie die Get - oder GetAsync-Methode auf.

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Ein vollständiges Beispiel finden Sie in der GetAgreementDetails-Klasse aus dem Konsolentest-App-Projekt .

REST-Anforderung

So rufen Sie einen Link zum Herunterladen der Microsoft-Kundenvereinbarung Vorlage ab:

  1. Rufen Sie die Metadaten der Vereinbarung für die Microsoft-Kundenvereinbarung ab. Sie müssen die templateID der Microsoft-Kundenvereinbarung abrufen. Weitere Informationen finden Sie unter Abrufen von Vertragsmetadaten für die Microsoft-Kundenvereinbarung.

  2. Erstellen Sie eine REST-Anforderung zum Abrufen einer AgreementDocument-Ressource. Ein Beispiel finden Sie im Anforderungssyntaxbeispiel . Sie müssen die folgenden Informationen angeben:

    • Die templateId des Microsoft-Kundenvereinbarung
    • Das Land/die Region, auf das die vorlage Microsoft-Kundenvereinbarung angewendet wird
    • Die Sprache, in der die vorlage Microsoft-Kundenvereinbarung lokalisiert werden soll

Anforderungssyntax

Verwenden Sie die folgende Anforderungssyntax für diese Ressource:

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

URI-Parameter

Sie können die folgenden URI-Parameter mit Ihrer Anforderung verwenden:

Name Type Erforderlich Beschreibung
agreement-template-id Zeichenfolge Ja Eindeutiger Bezeichner des Vertragstyps. Sie können die templateId für die Microsoft-Kundenvereinbarung abrufen, indem Sie die Vertragsmetadaten für die Microsoft-Kundenvereinbarung abrufen. Weitere Informationen finden Sie unter Abrufen von Vertragsmetadaten für die Microsoft-Kundenvereinbarung. Bei diesem Parameter wird die Groß-/Kleinschreibung beachtet.
country Zeichenfolge No Gibt das Land/die Region an, für das die Vereinbarungsvorlage gilt. Die Abfrage wird standardmäßig auf "US" festgelegt, wenn der Parameter nicht angegeben ist. Eine Liste der unterstützten Länder-/Regionscodes finden Sie in der Liste der unterstützten Länder/Regionen und Sprachen.
language Zeichenfolge No Gibt die Sprache an, in der die Vereinbarungsvorlage lokalisiert werden soll. Die Abfrage ist standardmäßig auf "en-US " festgelegt, wenn der Parameter nicht angegeben ist oder der code für Land/Region angegeben ist, der für das angegebene Land/die angegebene Region nicht unterstützt wird. Eine Liste der unterstützten Länder-/Regionscodes finden Sie in der Liste der unterstützten Länder/Regionen und Sprachen.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Beispiel für eine Anfrage

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

Bei erfolgreicher Ausführung gibt die Methode eine AgreementDocument-Ressource im Antworttext zurück.

Die Ressource verfügt über eine downloadUri-Eigenschaft , die eine URL-Zeichenfolge enthält, die zum Herunterladen der Vertragsvorlage verwendet werden kann. Jedes Mal, wenn Sie eine Abfrage erstellen, wird ein anderer Link zurückgegeben. Dieser Link läuft nach fünf Minuten ab.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und andere Debuginformationen angibt.

Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

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

Liste der unterstützten Länder/Regionen und Sprachen

Wichtig

Bei der Codeeigenschaft "Land/Region" wird die Groß-/Kleinschreibung beachtet. Achten Sie darauf, die in dieser Tabelle angegebene Groß-/Kleinschreibung zu verwenden:

Land/Region Landesvorwahl Unterstützte Sprachcodes
Ålandinseln AX en-US
Afghanistan AF en-US
Albanien AL en-US
Algerien DZ en-US, fr-FR, en-US
Amerikanisch-Samoa AS en-US
Andorra AD en-US
Angola AO en-US, pt-PT
Anguilla KI en-US
Antarktis AQ en-US
Antigua und Barbuda Verfügbarkeitsgruppe en-US
Argentinien AR en-US, es-ES
Armenien AM en-US
Aruba AW en-US
Australien AU en-US
Österreich AT en-US, de-DE
Aserbaidschan RP en-US
Bahamas BS en-US
Bahrain BH en-US, ar-SA
Bangladesch BD en-US
Barbados BB en-US
Belarus BY en-US, ru-RU
Belgien BE en-US, nl-NL
Belize BZ en-US, es-ES
Benin BJ en-US
Bermudas BM en-US
Bhutan BT en-US
Bolivien BO en-US, es-ES
Bonaire BQ en-US
Bosnien und Herzegowina BA en-US
Botsuana BW en-US
Bouvetinsel BV en-US
Brasilien BR en-US, pt-BR
Britisches Territorium im Indischen Ozean IO en-US
Britische Jungferninseln 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
Cabo Verde CV en-US, pt-PT
Kambodscha KH en-US
Kamerun CM en-US, fr-FR
Canada CA en-US, fr-FR
Kaimaninseln HE en-US, en-US
Zentralafrikanische Republik CF en-US
Tschad TD en-US
Chile CL en-US, es-ES
Weihnachtsinsel CX en-US
Kokosinseln CC en-US
Kolumbien CO en-US, es-ES
Komoren KM en-US
Kongo (DRC) CD en-US
Kongo (Demokratische Republik) CG en-US
Cookinseln CK en-US
Costa Rica CR en-US, es-ES
Kroatien HR en-US, hr-HR
Curaçao CW en-US
Zypern CY en-US
Tschechien CZ en-US, cs-CZ
Dänemark DK en-US, da-DK
Dschibuti DJ en-US
Dominica DM en-US
Dominikanische Republik DO en-US, es-ES
Ecuador EC en-US
Ägypten EG en-US, ar-SA
El Salvador SV en-US, es-ES
Äquatorialguinea GQ en-US
Eritrea ER en-US
Estland EE en-US, et-EE
eSwatini SZ en-US
Äthiopien ET en-US
Falklandinseln FS en-US
Färöer FO en-US
Fidschi FJ en-US
Finnland FI en-US, fi-FI
Frankreich BV en-US, fr-FR
Französisch-Guayana GF en-US, fr-FR
Französisch-Polynesien PF en-US
Französische Gebiete im südlichen Indischen Ozean TF en-US
Gabun Allgemein verfügbar en-US
Gambia GM en-US
Georgien GE en-US
Deutschland DE en-US, de-DE
Ghana GH en-US
Gibraltar GI en-US
Griechenland 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
Guayana GY en-US
Haiti HT en-US
Heard und McDonaldinseln HM en-US
Honduras HN en-US, es-ES
Sonderverwaltungsregion Hongkong HK en-US, zh-HK
Ungarn 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
Insel Man IM en-US
Israel BY en-US, he-IL
Italien IT en-US, it-IT
Jamaika JM en-US
Jan Mayen XJ en-US
Japan JP en-US, ja-JP
Jersey JE en-US
Jordan JO en-US, ar-SA
Kasachstan KZ en-US, kk-KZ
Kenia KE en-US
Kiribati KI en-US
Korea KR en-US, ko-KR
Kosovo XK en-US
Kuwait KW en-US, ar-SA
Kirgisistan 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 Sonderverwaltungsregion MO en-US, zh-HK
Madagaskar MG en-US
Malawi MW en-US
Malaysia MY en-US, ms-MY
Malediven MV en-US
Mali ML en-US
Malta MT en-US
Marshallinseln MH en-US
Martinique MQ en-US
Mauretanien MR en-US
Mauritius MU en-US, ar-SA
Mayotte YT en-US
Mexiko MX en-US, es-ES
Mikronesien FM en-US
Moldau MD en-US, ro-RO
Monaco MC en-US, fr-FR
Mongolei BB en-US
Montenegro ME en-US
Montserrat MS en-US
Marokko NI en-US, fr-FR, en-US
Mosambik MZ en-US
Myanmar MM en-US
Namibia Nicht verfügbar en-US
Nauru NR en-US
Nepal NP en-US
Niederlande NL en-US, nl-NL
Neukaledonien NC en-US
Neuseeland NZ en-US
Nicaragua NI en-US, es-ES
Niger NE en-US
Nigeria NG en-US
Niue NU en-US
Norfolkinsel NF en-US
Nördliche Marianen MP en-US
Nordmazedonien MK en-US
Norwegen NO en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau PW en-US
Palästinensische Autonomiegebiete PS en-US
Panama PA en-US, es-ES
Papua-Neuguinea PG en-US
Paraguay PY en-US, es-ES
Peru PE en-US, es-ES
Philippinen PH en-US
Pitcairninseln PN en-US
Polen PL en-US, pl-PL
Portugal PT en-US, pt-PT
Puerto Rico PR en-US, en-US
Katar QA en-US, ar-SA
Réunion RE en-US
Rumänien RO en-US, ro-RO
Russland RU en-US, ru-RU
Ruanda RW en-US, fr-FR
São Tomé und Príncipe ST en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
St. Kitts und Nevis KN en-US
St. Lucia LC en-US, en-US
St. Martin MF en-US, en-US
St. Pierre und Miquelon PM en-US
St. Vincent und die Grenadinen VC en-US
Samoa WS en-US
San Marino SM en-US
Saudi-Arabien SA en-US
Senegal SN en-US, fr-FR
Serbien RS en-US, sr-Latn-RS, en-US
Seychellen 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
Slowakei SK en-US, sk-SK
Slowenien SI en-US, sl-SI
Salomonen SB en-US
Somalia SO en-US
Südafrika ZA en-US
Südgeorgien und Südliche Sandwichinseln GS en-US
Südsudan 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
Spitzbergen SJ en-US
Schweden SE en-US, sv-SE
Schweiz CH en-US, fr-FR, en-US, en-US
Taiwan TW en-US, zh-HK
Tadschikistan TJ en-US
Tansania 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 und Tobago TT en-US
Tunesien TN en-US, fr-FR, en-US
Türkiye TR en-US, tr-TR
Turkmenistan TM en-US
Turks- und Caicosinseln TC en-US
Tuwalu TV en-US
USA Amerikanische Überseeinseln UM en-US
USA Jungferninseln VI en-US
Uganda UG en-US
Ukraine UA en-US, uk-UA
Vereinigte Arabische Emirate AE en-US, ar-SA
United Kingdom GB de-DE
USA US en-US
Uruguay UY en-US, es-ES
Usbekistan UZ en-US, ru-RU
Vanuatu VU en-US
Vatikanstadt VA en-US
Venezuela VE en-US, es-ES
Vietnam VN en-US, vi-VN
Wallis und Futuna WF en-US
Jemen YE en-US, ar-SA
Sambia ZM en-US
Simbabwe ZW en-US