Freigeben über

Abrufen eines Downloadlinks für die Microsoft-Kundenvereinbarungsvorlage

gilt für: Partner Center

Gilt nicht für: Partner Center, betrieben von 21Vianet | Partner Center für Microsoft Cloud für die US-Regierung

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 zum Herunterladen der Microsoft-Kundenvereinbarungsvorlage basierend auf dem Land/der Region und sprache des Kunden abrufen.

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 die SDK-Version von GitHubzusammen mit einer Readme-Datei herunterladen, die nützliche Informationen enthält.

    Partner werden ermutigt, weiterhin die Partner Center-REST-APIszu verwenden.

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

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

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

Wichtig

  • Die Microsoft-Kundenvereinbarung ist länder-/regionsspezifisch. Wenn Sie einen Link zum Herunterladen der Microsoft-Kundenvereinbarungsvorlage 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 der Microsoft-Kundenvertrag 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 unter Liste der unterstützten Länder/Regionen und Sprachen.
  • Diese Methode wird nur mit dem Microsoft-Kundenvertrag unterstützt.

.NET

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

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

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Verwenden Sie die IAggregatePartner.AgreementTemplates-Sammlung.

  3. Rufen Sie die ById- methode auf, und geben Sie die templateId- der Microsoft-Kundenvereinbarung an.

  4. Ruft die Eigenschaft Document ab.

  5. Rufen Sie die ByCountry Methode auf, und geben Sie das Land/die Region des Kunden an, auf das die Vereinbarungsvorlage angewendet wird. Die Abfrage wird standardmäßig auf US- festgelegt, wenn die Methode nicht angegeben ist. Eine Liste der unterstützten Länder-/Regionscodes finden Sie unter 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 Vereinbarungsvorlage lokalisiert werden soll. Wenn die Methode nicht angegeben ist oder der Code für das angegebene Land oder die Region nicht unterstützt wird, erfolgt die Abfrage standardmäßig auf en-US. Eine Liste der unterstützten Sprachcodes finden Sie unter Liste der unterstützten Länder/Regionen und Sprachen.

  7. Rufen Sie die Methode Get oder GetAsync 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 Konsolen-Test-App-Projekt.

REST-Anforderung

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

  1. Rufen Sie die Vertragsmetadaten für den Microsoft-Kundenvertrag 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. Für ein Beispiel sehen Sie sich die Anfragesyntax an. Sie müssen die folgenden Informationen angeben:

    • Die templateId der Microsoft-Kundenvereinbarung
    • Das Land/die Region, für das die Microsoft-Kundenvertragsvorlage gilt
    • Die Sprache, in der die Microsoft-Kundenvereinbarungsvorlage 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 Typ Erforderlich Beschreibung
agreement-template-id Schnur 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 Schnur Nein 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 unter Liste der unterstützten Länder/Regionen und Sprachen.
Sprache Schnur Nein Gibt die Sprache an, in der die Vereinbarungsvorlage lokalisiert werden soll. Die Abfrage wird 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 Region nicht unterstützt wird. Eine Liste der unterstützten Länder-/Regionscodes finden Sie unter Liste der unterstützten Länder/Regionen und Sprachen.

Anforderungsheader

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

Anforderungstext

Nichts.

Anforderungsbeispiel

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

Antworterfolgs- und Fehlercodes

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.

Antwortbeispiel

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 Landescode 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 Künstliche Intelligenz en-US
Antarktis .AQ en-US
Antigua und Barbuda AG 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 AZ 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
Bermuda BM en-US
Bhutan BT en-US
Bolivien BO en-US, es-ES
Bonaire BQ en-US
Bosnien und Herzegowina BA en-US
Botsuana Baden-Württemberg en-US
Bouvetinsel BV en-US
Brazilien 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 Lebenslauf en-US, pt-PT
Kambodscha KH en-US
Kamerun CM en-US, fr-FR
Kanada CA en-US, fr-FR
Kaimaninseln KY en-US, en-US
Zentralafrikanische Republik CF en-US
Tschad TD en-US
Chile CL en-US, es-ES
Weihnachtsinsel CX en-US
Kokosinseln (Keeling) CC en-US
Kolumbien CO en-US, es-ES
Komoren KILOMETER en-US
Kongo (DRK) CD en-US
Kongo CG en-US
Cookinseln CK en-US
Costa Rica CR en-US, es-ES
Kroatien Personalwesen 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 EG 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 FK en-US
Färöer Inseln FO en-US
Fidschi FJ en-US
Finnland FI en-US, fi-FI
Frankreich FR en-US, fr-FR
Französisch-Guayana GF en-US, fr-FR
Französisch-Polynesien PF en-US
Französische Südgebiete TF en-US
Gabun GA 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
Guyana GY en-US
Haiti HT en-US
Heard Island und McDonald Islands 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
Isle of Man IM en-US
Israel IL 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
Jordanien 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
Kirgistan 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
Sonderverwaltungsregion Macau MO en-US, zh-HK
Madagaskar MG en-US
Malawi MW en-US
Malaysien 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
Republik Moldau MD en-US, ro-RO
Monaco MC en-US, fr-FR
Mongolei MN en-US
Montenegro ICH en-US
Montserrat MS en-US
Marokko MA en-US, fr-FR, en-US
Mosambik MZ en-US
Myanmar MM en-US
Namibia NA 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 NEIN en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau PW en-US
Palästinensische Behörde 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 Qualitätssicherung 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
Suriname SR en-US
Svalbard 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ürkei TR en-US, tr-TR
Turkmenistan TM en-US
Turks- und Caicosinseln TC en-US
Tuvalu Fernseher en-US
USA Kleinere Amerikanische Überseeinseln UM en-US
Amerikanische Jungferninseln VI en-US
Uganda UG en-US
Ukraine UA en-US, uk-UA
Vereinigte Arabische Emirate AE en-US, ar-SA
Vereinigtes Königreich GB en-US
USA USA 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
Zimbabwe ZW en-US