Sdílet prostřednictvím

Získání odkazu ke stažení pro šablonu smlouvy se zákazníkem Microsoftu

  • Článek

platí pro: Partnerské centrum

Nevztahuje se na: Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Partner Center v současné době podporuje prostředek AgreementDocument pouze ve veřejném cloudu Microsoftu.

Tento článek popisuje, jak získat odkaz ke stažení šablony Smlouvy se zákazníkem Microsoftu na základě země nebo oblasti a jazyka zákazníka.

Požadavky

  • Pokud používáte sadu .NET SDK partnerského centra, vyžaduje se verze 1.14 nebo novější.

    Důležitý

    Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Verzi sady SDK můžete stáhnout z GitHubuspolečně s souborem readme, který obsahuje užitečné informace.

    Doporučujeme, aby partneři nadále používali rozhraní REST API Partnerského centra.

  • Přihlašovací údaje, jak je popsáno v ověřování v Partnerském centru. Tento scénář podporuje pouze ověřování aplikací a uživatelů.

  • Země nebo oblast zákazníka, na kterou se vztahuje šablona Smlouvy se zákazníkem Microsoftu.

  • Jazyk, ve kterém by se měla lokalizovat šablona smlouvy se zákazníkem Microsoftu.

Důležitý

  • Smlouva se zákazníkem Microsoftu je specifická pro zemi nebo oblast. Při žádosti o odkaz ke stažení šablony Smlouvy se zákazníkem Microsoftu nezapomeňte zadat správnou zemi nebo oblast na základě umístění zákazníka. nebo seznam podporovaných zemí/oblastí, přečtěte si Seznam podporovaných zemí/oblastí a jazyků.
  • V některých zemích nebo oblastech je smlouva se zákazníkem Microsoftu dostupná v několika jazycích. Nejlepší prostředí pro zákazníky dosáhnete, když vyberete jazyk, který nejlépe odpovídá potřebám zákazníka. Seznam podporovaných jazyků najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.
  • Tato metoda se podporuje pouze se smlouvou se zákazníkem Microsoftu.

.NET

Chcete-li získat odkaz ke stažení šablony smlouvy se zákazníkem Microsoftu:

  1. Získejte metadata smlouvy pro Smlouvu se zákazníkem společnosti Microsoft. Musíte získat templateId Smlouvy Microsoftu se zákazníkem. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Použijte kolekci IAggregatePartner.AgreementTemplates.

  3. Zavolejte metodu ById a zadejte templateId smlouvy se zákazníkem Microsoftu.

  4. Získejte vlastnost dokumentu.

  5. Zavolejte metodu ByCountry a zadejte zemi nebo oblast zákazníka, na kterou se šablona smlouvy vztahuje. Pokud není metoda zadána, dotaz se ve výchozím nastavení nastaví na USA. Seznam podporovaných kódů zemí/oblastí najdete v tématu Seznam podporovaných zemí/oblastí a jazyků. Tato metoda rozlišuje velká a malá písmena.

  6. Zavolejte metodu ByLanguage a zadejte jazyk, ve kterém má být šablona smlouvy lokalizována. Dotaz se nastaví na en-US, pokud není specifikována metoda nebo pokud zadaný kód země nebo oblasti není podporován pro zadanou zemi či oblast ve výchozím nastavení. Seznam podporovaných kódů jazyků najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.

  7. Volejte metodu Get nebo GetAsync.

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Úplnou ukázku najdete ve třídě GetAgreementDetails v rámci projektu testovací konzolové aplikace.

Požadavek REST

Chcete-li získat odkaz ke stažení šablony smlouvy se zákazníkem Microsoftu:

  1. Získejte metadata smlouvy pro Smlouvu se zákazníkem společnosti Microsoft. Musíte získat templateId Smlouvy Microsoftu se zákazníkem. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu.

  2. Vytvořte požadavek REST na načtení prostředku AgreementDocument. Příklad najdete v příkladu syntaxe požadavku . Musíte zadat následující informace:

    • identifikátor šablony Smlouvy se zákazníkem společnosti Microsoft
    • Země/oblast, na kterou se vztahuje šablona Smlouvy se zákazníkem Microsoftu
    • Jazyk, ve kterém by se měla lokalizovat šablona smlouvy se zákazníkem Microsoftu

Syntaxe požadavku

Pro tento prostředek použijte následující syntaxi požadavku:

Metoda Požadavek URI
ZÍSKAT {baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

Parametry identifikátoru URI

U požadavku můžete použít následující parametry identifikátoru URI:

Jméno Typ Vyžadováno Popis
šablona-dohody-id řetězec Ano Jedinečný identifikátor typu smlouvy. ID šablony pro smlouvu se zákazníkem Microsoftu můžete získat načtením jejích metadat. Další informace najdete v tématu Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu. Tento parametr rozlišuje malá a velká písmena.
země řetězec Ne Určuje zemi nebo oblast, na kterou se šablona smlouvy vztahuje. Dotaz se nastaví na výchozí hodnotu US, pokud není parametr zadaný. Seznam podporovaných kódů zemí/oblastí najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.
Jazyk řetězec Ne Označuje jazyk, ve kterém má být šablona smlouvy lokalizována. Výchozí hodnoty dotazu jsou en-US, pokud není určen parametr nebo pokud není kód země/oblasti podporován pro zadanou zemi nebo oblast. Seznam podporovaných kódů zemí/oblastí najdete v tématu Seznam podporovaných zemí/oblastí a jazyků.

Hlavičky požadavku

Pro více informací viz REST hlavičky Partnerského centra.

Text požadavku

Žádný.

Příklad požadavku

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

Odpověď REST

V případě úspěchu tato metoda vrátí prostředek AgreementDocument v textu odpovědi.

Prostředek má vlastnost downloadUri, která obsahuje řetězec adresy URL, který lze použít ke stažení šablony smlouvy. Pokaždé, když vytvoříte dotaz, se vrátí jiný odkaz. Platnost tohoto odkazu vyprší po pěti minutách.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění.

Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu kódy chyb REST rozhraní Partnerského centra.

Příklad odpovědi

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

Seznam podporovaných zemí/oblastí a jazyků

Důležitý

U vlastnosti kódu země/oblasti se rozlišují malá a velká písmena. Ujistěte se, že používáte správné pouzdro zadané v této tabulce:

Země/oblast Kód země Podporované kódy jazyka
Ålandské ostrovy SEKYRA en-US
Afghánistán AF en-US
Albánie HLINÍK en-US
Alžírsko DZ en-US, fr-FR, en-US
Americká Samoa PROTOŽE en-US
Andorra REKLAMA en-US
Angola AO en-US, pt-PT
Anguilla Umělá inteligence en-US
Antarktida AQ en-US
Antigua a Barbuda AG en-US
Argentina AR en-US, es-ES
Arménie AM en-US
Aruba AW Spojené státy americké
Austrálie AU en-US
Rakousko NA en-US, de-DE
Ázerbájdžán AZ en-US
Bahamy bakalář přírodních věd en-US
Bahrajn Bosna a Hercegovina en-US, ar-SA
Bangladéš BD en-US
Barbados BB en-US
Bělorusko VEDLE en-US, ru-RU
Belgie BE en-US, nl-NL
Belize BZ en-US, es-ES
Benin BJ en-US
Bermudy BM en-US
Bhútán BT en-US
Bolívie BO en-US, es-ES
Bonaire BQ en-US
Bosna a Hercegovina bakalář umění en-US
Botswana BW en-US
Bouvetův ostrov BV en-US
Brazílie BR en-US, pt-BR
Britské území Indického oceánu IO en-US
Britské Panenské ostrovy Velmi dobré en-US
Brunej BN en-US
Bulharsko BG en-US, bg-BG
Burkina Faso BF en-US
Burundi Business Intelligence en-US
Pobřeží slonoviny CI en-US, fr-FR
Cabo Verde Životopis en-US, pt-PT
Kambodža KH en-US
Kamerun CM en-US, fr-FR
Kanada CA en-US, fr-FR
Kajmanské ostrovy KY en-US, en-US
Středoafrická republika CF en-US
Čad TD en-US
Chile CL en-US, es-ES
Vánoční ostrov CX en-US
Kokosové ostrovy (Keeling) CC en-US
Kolumbie Oxid uhelnatý en-US, es-ES
Komory km en-US
Kongo (DRC) CD en-US
Kongo CG en-US
Cookovy ostrovy CK en-US
Kostarika ČR en-US, es-ES
Chorvatsko Lidské zdroje en-US, hr-HR
Curaçao CW en-US
Kypr CY en-US
Česko CZ en-US, cs-CZ
Dánsko DK en-US, da-DK
Džibutsko DJ en-US
Dominika DM en-US
Dominikánská republika DĚLAT en-US, es-ES
Ekvádor ES en-US
Egypt např. en-US, ar-SA
Salvador SV en-US, es-ES
Rovníková Guinea GQ en-US
Eritrea ER en-US
Estonsko EE en-US, et-EE
eSwatini SZ en-US
Etiopie ET en-US
Falklandské ostrovy FK en-US
Faerské ostrovy FO en-US
Fidži FJ en-US
Finsko FI en-US, fi-FI
Francie FR en-US, fr-FR
Francouzská Guyana přítelkyně en-US, fr-FR
Francouzská Polynésie PF en-US
Francouzská jižní území TF en-US
Gabon GA en-US
Gambie GM en-US
Gruzie GE en-US
Německo Německo en-US, de-DE
Ghana GH en-US
Gibraltar Gastrointestinální en-US
Řecko GR en-US, el-GR
Grónsko GL en-US
Grenada GD en-US
Guadeloupe Praktický lékař 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ův ostrov a McDonaldovy ostrovy Hm en-US
Honduras HN en-US, es-ES
Zvláštní správní oblast Hongkongu Hongkong en-US, zh-HK
Maďarsko HU en-US, hu-HU
Island JE en-US
Indie V americká angličtina (en-US), indická hindština (hi-IN)
Indonésie Identifikátor en-US, id-ID
Irák IQ en-US, ar-SA
Irsko Internet Explorer en-US
Ostrov Man IM en-US
Izrael IL en-US, he-IL
Itálie Informační technologie en-US, it-IT
Jamajka JM en-US
Jan Mayen XJ en-US
Japonsko JP en-US, ja-JP
Jersey JE en-US
Jordánsko JO en-US, ar-SA
Kazachstán KZ en-US, kk-KZ
Keňa KE en-US
Kiribati KI en-US
Korea KR en-US, ko-KR
Kosovo XK en-US
Kuvajt kW en-US, ar-SA
Kyrgyzstán kg en-US, ru-RU
Laos Los Angeles en-US
Lotyšsko LV en-US, lv-LV
Libanon LB en-US, ar-SA
Lesotho LS en-US
Libérie LR en-US
Libye LY en-US, ar-SA
Lichtenštejnsko LI en-US, de-DE
Litva LT en-US, lt-LT
Lucembursko LU en-US, fr-FR
Macao – zvláštní oblast pro správu MO en-US, zh-HK
Madagaskar MG en-US
Malawi MW en-US
Malajsie MŮJ en-US, ms-MY
Maledivy MV en-US
Mali ML en-US
Malta MT en-US
Marshallovy ostrovy MH en-US
Martinik MQ en-US
Mauritánie PAN en-US
Mauricius MU en-US, ar-SA
Mayotte YouTube en-US
Mexiko MX en-US, es-ES
Mikronésie FM en-US
Moldavsko MD en-US, ro-RO
Monako MC en-US, fr-FR
Mongolsko MN en-US
Černá Hora MĚ en-US
Montserrat MS en-US
Maroko MA en-US, fr-FR, en-US
Mosambik MZ en-US
Myanmar MM en-US
Namibie SODÍK en-US
Nauru NR en-US
Nepál NP en-US
Nizozemsko Nizozemsko en-US, nl-NL
Nová Kaledonie NC en-US
Nový Zéland NZ en-US
Nikaragua Ni en-US, es-ES
Niger SV en-US
Nigérie NG en-US
Niue NU en-US
Norfolský ostrov NF en-US
Severní Mariany poslanec en-US
Severní Makedonie MK en-US
Norsko NE en-US, nb-NO
Omán OM angličtina (USA), arabština (Saúdská Arábie)
Pákistán PK en-US
Palau VÁLEČNÝ ZAJATEC en-US
Palestinská autorita P.S. en-US
Panama PA en-US, es-ES
Papua Nová Guinea PG en-US
Paraguay PY en-US, es-ES
Peru PE en-US, es-ES
Filipíny PH en-US
Pitcairnovy ostrovy PN en-US
Polsko PL en-US, pl-PL
Portugalsko PT en-US, pt-PT
Portoriko vztahy s veřejností en-US, en-US
Katar Zajištění kvality en-US, ar-SA
Réunion Re en-US
Rumunsko RO en-US, ro-RO
Rusko Rusko en-US, ru-RU
Rwanda RW en-US, fr-FR
São Tomé a Príncipe ST en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
Saint Kitts a Nevis KN en-US
Svatá Lucie LC en-US, en-US
Saint-Martin MF en-US, en-US
Saint Pierre a Miquelon Ministerský předseda en-US
Svatý Vincenc a Grenadiny VC en-US
Samoa WS en-US
San Marino SM en-US
Saúdská Arábie Bezpečnostní asociace en-US
Senegal SN en-US, fr-FR
Srbsko RS en-US, sr-Latn-RS, en-US
Seychely 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
Slovensko SK en-US, sk-SK
Slovinsko SI en-US, sl-SI
Šalamounovy ostrovy SB en-US
Somálsko TAKŽE en-US
Jihoafrická republika ZA en-US
Jižní Gruzie a Jižní Sandwichovy ostrovy GS en-US
Jižní Súdán SS en-US
Španělsko ES en-US, es-ES, en-US, en-US
Srí Lanka LK en-US
St Helena, Nanebevzetí, Tristan da Cunha SH en-US
Surinam SR en-US
Špicberky SJ en-US
Švédsko SE en-US, sv-SE
Švýcarsko CH en-US, fr-FR, en-US, en-US
Tchaj-wan TW en-US, zh-HK
Tádžikistán TJ en-US
Tanzanie TZ en-US
Thajsko TH angličtina (USA), thajština (Thajsko)
Timor-Leste TL en-US
Togo TG en-US
Tokelau TK en-US
Tonga Do en-US
Trinidad a Tobago TT en-US
Tunisko TN en-US, fr-FR, en-US
Turecko TR en-US, tr-TR
Turkmenistán TM en-US
Turks a Caicosovy ostrovy TC en-US
Tuvalu TELEVIZE en-US
Odsadové ostrovy USA µm en-US
Americké Panenské ostrovy VI en-US
Uganda UG en-US
Ukrajina UA en-US, uk-UA
Spojené arabské emiráty AE en-US, ar-SA
Spojené království GB en-US
Spojené státy americké NÁS en-US
Uruguay UY en-US, es-ES
Uzbekistán UZ en-US, ru-RU
Vanuatu VU en-US
Vatikán VA en-US
Venezuela VE en-US, es-ES
Vietnam VN en-US, vi-VN
Wallis a Futuna WF en-US
Jemen VY en-US, ar-SA
Zambie ZM en-US
Zimbabwe ZW en-US