Udostępnij za pośrednictwem

Pobieranie linku do szablonu Umowy z Klientem Microsoft

  • Artykuł

Dotyczy: Centrum Partnerskie

nie ma zastosowania do: Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Zasób AgreementDocument jest obecnie obsługiwany przez Centrum partnerskie tylko w chmurze publicznej firmy Microsoft.

W tym artykule opisano sposób pobierania linku do pobierania szablonu Umowy z Klientem Microsoft na podstawie kraju/regionu i języka klienta.

Warunki wstępne

  • Jeśli używasz zestawu .NET SDK Centrum partnerskiego, wymagana jest wersja 1.14 lub nowsza.

    Ważny

    Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z witryny GitHubwraz z plikiem readme zawierającym przydatne informacje.

    Zachęcamy partnerów do kontynuowania korzystania z interfejsów API REST Partner Center .

  • Poświadczenia zgodnie z opisem w uwierzytelnianie w Centrum Partnerskim. Ten scenariusz obsługuje tylko uwierzytelnianie aplikacji i użytkowników.

  • Kraj/region klienta, do którego ma zastosowanie szablon Umowy z Klientem Microsoft.

  • Język, w którym powinien zostać zlokalizowany szablon Umowy z Klientem Microsoft.

Ważny

  • Umowa z Klientem Microsoft jest specyficzna dla kraju/regionu. Podczas żądania pobrania szablonu Umowy z Klientem Microsoft należy określić prawidłowy kraj/region na podstawie lokalizacji klienta. lub listę obsługiwanych krajów/regionów, zapoznaj się z Lista obsługiwanych krajów/regionów i języków.
  • W przypadku niektórych krajów/regionów Umowa z Klientem Microsoft jest dostępna w wielu językach. Aby zapewnić najlepsze doświadczenie klienta, wybierz język, który najlepiej odpowiada jego potrzebom. Aby uzyskać listę obsługiwanych języków, zobacz Lista obsługiwanych krajów/regionów i języków.
  • Ta metoda jest obsługiwana tylko w przypadku umowy klienta firmy Microsoft.

.NET

Aby pobrać link do pobrania szablonu Umowy z Klientem Microsoft:

  1. Pobierz metadane umowy dla Umowy z Klientem Microsoft. Należy uzyskać templateId Umowy Klienta firmy Microsoft. Aby uzyskać więcej informacji, zobacz Uzyskaj metadane umowy dla Microsoft Customer Agreement.

    // IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

  2. Użyj kolekcji IAggregatePartner.AgreementTemplates.

  3. Wywołaj metodę ById i określ templateId Umowy Klienta Microsoft.

  4. Pobierz właściwość Document.

  5. Wywołaj metodę ByCountry i określ kraj/region klienta, do którego ma zastosowanie szablon umowy. Zapytanie domyślnie jest ustawione na US, jeśli metoda nie jest określona. Listę obsługiwanych kodów krajów/regionów można znaleźć w Lista obsługiwanych krajów/regionów i języków. Ta metoda jest wrażliwa na wielkość liter.

  6. Wywołaj metodę ByLanguage i określ język, w jakim powinien znajdować się szablon umowy. Kwerenda jest domyślnie ustawiona na en-US, jeśli nie określono metody lub określony kod kraju/regionu nie jest obsługiwany dla określonego kraju/regionu. Aby uzyskać listę obsługiwanych kodów języków, zobacz Lista obsługiwanych krajów/regionów i języków.

  7. Wywołaj metodę Get lub GetAsync.

    // IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

Kompletny przykład można znaleźć w klasie GetAgreementDetails z projektu aplikacji testowej konsoli.

Żądanie REST

Aby pobrać link do pobrania szablonu Umowy z Klientem Microsoft:

  1. Pobierz metadane umowy dla Umowy z Klientem Microsoft. Należy uzyskać templateId Umowy Klienta firmy Microsoft. Aby uzyskać więcej informacji, zobacz Uzyskaj metadane umowy dla Microsoft Customer Agreement.

  2. Utwórz żądanie REST, aby pobrać zasób AgreementDocument . Przykład można znaleźć w przykładzie składni żądania . Należy określić następujące informacje:

    • templateId szablonu Umowy z Klientem Microsoft
    • Kraj/region, do którego ma zastosowanie szablon Umowy z Klientem Microsoft
    • Język, w którym szablon Umowy z Klientem Microsoft powinien być zlokalizowany

Składnia żądania

Użyj następującej składni żądania dla tego zasobu:

Metoda URI żądania
POBIERZ {baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

Parametry identyfikatora URI

Możesz użyć następujących parametrów URI w swoim żądaniu.

Nazwa Typ Wymagane Opis
identyfikator szablonu umowy struna Tak Unikatowy identyfikator typu umowy. Identyfikator templateId dla Umowy z Klientem Microsoft można uzyskać, pobierając metadane umowy dla Umowy z Klientem Microsoft. Aby uzyskać więcej informacji, zobacz Uzyskaj metadane umowy dla Microsoft Customer Agreement. Ten parametr jest rozróżniający wielkość liter.
kraj struna Nie Wskazuje kraj/region, do którego ma zastosowanie szablon umowy. Zapytanie domyślnie ustawia się na US, jeśli parametr nie jest określony. Listę obsługiwanych kodów krajów/regionów można znaleźć w Lista obsługiwanych krajów/regionów i języków.
Język struna Nie Wskazuje język, w którym powinien zostać zlokalizowany szablon umowy. Zapytanie domyślnie ustawia się na en-US, jeśli parametr nie jest określony lub jeśli kod kraju/regionu nie jest obsługiwany dla wybranego kraju/regionu. Aby uzyskać listę obsługiwanych kodów krajów/regionów, zapoznaj się z listą obsługiwanych krajów/regionów i języków.

Nagłówki żądań

Zobacz Nagłówki REST Centrum partnerskiego, aby uzyskać więcej informacji.

Treść żądania

Żaden.

Przykład zapytania

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

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca zasób AgreementDocument w treści odpowiedzi.

Zasób ma właściwość downloadUri zawierającą ciąg adresu URL, którego można użyć do pobrania szablonu umowy. Za każdym razem, gdy wykonujesz zapytanie, jest zwracany inny link. Ten link wygasa po pięciu minutach.

Kody sukcesu odpowiedzi i kody błędu odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i inne informacje o debugowaniu.

Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

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 obsługiwanych krajów/regionów i języków

Ważny

Właściwość kodu kraju/regionu rozróżnia małe i wielkie litery. Pamiętaj, aby użyć poprawnego formatu liter określonego w tej tabeli.

Kraj/region Kod kraju Obsługiwane kody języków
Wyspy Alandzkie SIEKIERA en-US
Afganistan AF en-US
Albania AL en-US
Algieria DZ en-US, fr-FR, en-US
Samoa Amerykańskie As en-US
Andora REKLAMA en-US
Angola AO en-US, pt-PT
Anguilla AI en-US
Antarktyda AQ en-US
Antigua i Barbuda AG en-US
Argentyna AR en-US, es-ES
Armenia rano en-US
Aruba AW en-US
Australia AU en-US
Austria PRZY en-US, de-DE
Azerbejdżan AZ en-US
Bahamy Licencjat nauk ścisłych en-US
Bahrajn BH en-US, ar-SA
Bangladesz BD en-US
Barbados BB en-US
Białoruś PRZEZ en-US, ru-RU
Belgia BYĆ en-US, nl-NL
Belize BZ en-US, es-ES
Benin BJ en-US
Bermudy BM en-US
Bhutan BT en-US
Boliwia Bo en-US, es-ES
Bonaire BQ en-US
Bośnia i Hercegowina BA en-US
Botswana BW en-US
Wyspa Bouvet BV en-US
Brazylia BR en-US, pt-BR
Terytorium Brytyjskiego Oceanu Indyjskiego IO en-US
Brytyjskie Wyspy Dziewicze VG en-US
Brunei BN en-US
Bułgaria 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 Życiorys zawodowy en-US, pt-PT
Kambodża KH en-US
Kamerun CENTYMETR en-US, fr-FR
Kanada CA en-US, fr-FR
Wyspy Kajmańskie KY en-US, en-US
Republika Środkowoafrykańska CF en-US
Czad TD en-US
Chile CL en-US, es-ES
Wyspa Bożego Narodzenia CX en-US
Wyspy Kokosowe (Keeling) CC en-US
Kolumbia Kobalt en-US, es-ES
Komory km en-US
Kongo (DRC) Płyta CD en-US
Kongo CG en-US
Wyspy Cooka CK en-US
Kostaryka CR en-US, es-ES
Chorwacja Zasoby Ludzkie en-US, hr-HR
Curaçao CW en-US
Cypr CY en-US
Czechy CZ en-US, cs-CZ
Dania DK en-US, da-DK
Dżibuti DJ en-US
Dominika dm en-US
Dominikana ROBIĆ en-US, es-ES
Ekwador Komisja Europejska en-US
Egipt EG en-US, ar-SA
Salwador SV en-US, es-ES
Gwinea Równikowa GQ en-US
Erytrea ER en-US
Estonia EE en-US, et-EE
eSwatini SZ en-US
Etiopia ET en-US
Wyspy Falklandzkie FK en-US
Wyspy Owcze FO en-US
Fidżi FJ en-US
Finlandia Fi en-US, fi-FI
Francja Francja en-US, fr-FR
Gujana Francuska GF en-US, fr-FR
Polinezja Francuska PF en-US
Francuskie Terytoria Południowe TF en-US
Gabon GA en-US
Gambia GM en-US
Gruzja GE en-US
Niemcy DE en-US, de-DE
Ghana GH en-US
Gibraltar GI en-US
Grecja GR en-US, el-GR
Grenlandia GL en-US
Grenada GD en-US
Gwadelupa lekarz ogólny en-US
Guam GU en-US
Gwatemala GT en-US, es-ES
Guernsey GG en-US
Gwinea GN en-US
Guinea-Bissau GW en-US
Gujana GY en-US
Haiti HT en-US
Wyspy Heard i McDonald HM en-US
Honduras HN en-US, es-ES
Specjalny region administracyjny Hongkongu HK en-US, zh-HK
Węgry HU en-US, hu-HU
Islandia JEST en-US
Indie W en-US, hi-IN
Indonezja ID en-US, id-ID
Irak IQ en-US, ar-SA
Irlandia IE en-US
Wyspa Mana Wiadomości błyskawiczne en-US
Izrael IL en-US, he-IL
Włochy IT en-US, it-IT
Jamajka JM en-US
Jan Mayen XJ en-US
Japonia JP en-US, ja-JP
Jersey JE en-US
Jordania JO en-US, ar-SA
Kazachstan KZ en-US, kk-KZ
Kenia Komisja Europejska en-US
Kiribati KI en-US
Korea KR en-US, ko-KR
Kosowo XK en-US
Kuwejt KW en-US, ar-SA
Kirgistan kg en-US, ru-RU
Laos LA en-US
Łotwa LV en-US, lv-LV
Liban FUNT en-US, ar-SA
Lesotho LS en-US
Liberia LR en-US
Libia LY en-US, ar-SA
Liechtenstein LI en-US, de-DE
Litwa LT amerykański angielski, litewski (Litwa)
Luksemburg LU en-US, fr-FR
Specjalny region administracyjny Makau MO en-US, zh-HK
Madagaskar MG en-US
Malawi MW en-US
Malezja MÓJ en-US, ms-MY
Malediwy MV en-US
Mali ML en-US
Malta MT en-US
Wyspy Marshalla MH en-US
Martynika MQ en-US
Mauretania PAN en-US
Mauritius MU en-US, ar-SA
Majotta YT en-US
Meksyk MX en-US, es-ES
Mikronezja FM en-US
Mołdawia Lekarz medycyny en-US, ro-RO
Monako MC en-US, fr-FR
Mongolia MN en-US
Czarnogóra MNIE en-US
Montserrat MS en-US
Maroko MA en-US, fr-FR, en-US
Mozambik MZ en-US
Myanmar MM en-US
Namibia NIE en-US
Nauru NR en-US
Nepal NP en-US
Holandia NL en-US, nl-NL
Nowa Kaledonia NC en-US
Nowa Zelandia NZ en-US
Nikaragua NI en-US, es-ES
Niger NE en-US
Nigeria NG en-US
Niue NU en-US
Wyspa norfolk NF en-US
Mariany Północne poseł en-US
Macedonia Północna MK en-US
Norwegia NIE en-US, nb-NO
Oman OM angielski (Stany Zjednoczone), arabski (Arabia Saudyjska)
Pakistan PK en-US
Palau PW en-US
Autonomia Palestyńska PS en-US
Panama Tata en-US, es-ES
Papua-Nowa Gwinea PG en-US
Paragwaj PY en-US, es-ES
Peru PE en-US, es-ES
Filipiny PH en-US
Wyspy Pitcairn PN en-US
Polska Polska en-US, pl-PL
Portugalia PT en-US, pt-PT
Portoryko Relacje publiczne en-US, en-US
Katar QA (Zapewnienie Jakości) en-US, ar-SA
Réunion ODP. en-US
Rumunia RO en-US, ro-RO
Rosja RU en-US, ru-RU
Rwanda RW en-US, fr-FR
São Tomé i Príncipe ST en-US, fr-FR
Saba XS en-US
Saint-Barthélemy BL en-US
Saint Kitts i Nevis KN en-US
Saint Lucia LC en-US, en-US
Saint-Martin MF en-US, en-US
Saint Pierre i Miquelon po południu en-US
Saint Vincent i Grenadyny VC en-US
Samoa WS en-US
San Marino SM en-US
Arabia Saudyjska S.A. en-US
Senegal SN en-US, fr-FR
Serbia RS en-US, sr-Latn-RS, en-US
Seszele 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
Słowacja SK en-US, sk-SK
Słowenia Międzynarodowy Układ Jednostek SI en-US, sl-SI
Wyspy Salomona SB en-US
Somalia WIĘC en-US
Republika Południowej Afryki ZA en-US
Georgia Południowa i Wyspy Południowe Sandwich GS en-US
Sudan Południowy SS en-US
Hiszpania ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
St Helena, Wniebowstąpienie, Tristan da Cunha SH en-US
Surinam SR en-US
Svalbard SJ en-US
Szwecja SE en-US, sv-SE
Szwajcaria CH en-US, fr-FR, en-US, en-US
Tajwan TW en-US, zh-HK
Tadżykistan TJ en-US
Tanzania TZ en-US
Tajlandia TH en-US, th-TH
Timor-Leste TL en-US
Togo TG en-US
Tokelau TK en-US
Tonga DO en-US
Trynidad i Tobago TT en-US
Tunezja TN en-US, fr-FR, en-US
Turcja TR en-US, tr-TR
Turkmenistan TM en-US
Wyspy Turks i Caicos TC en-US
Tuvalu TELEWIZJA en-US
Wyspy Mniejsze Stanów Zjednoczonych Uniwersytet Michigan en-US
Wyspy Dziewicze Stanów Zjednoczonych VI en-US
Uganda UG en-US
Ukraina UA en-US, uk-UA
Zjednoczone Emiraty Arabskie AE en-US, ar-SA
Wielka Brytania GB en-US
Stany Zjednoczone USA en-US
Urugwaj UY en-US, es-ES
Uzbekistan UZ en-US, ru-RU
Vanuatu VU en-US
Watykan VA en-US
Wenezuela VE en-US, es-ES
Wietnam VN en-US, vi-VN
Wallis i Futuna WF en-US
Jemen YE en-US, ar-SA
Zambia ZM en-US
Zimbabwe ZW en-US