Udostępnij za pośrednictwem

Pobierz link pobierania dla szablonu Umowa z Klientem Microsoft

  • Artykuł

Dotyczy: Centrum partnerskie

Nie dotyczy: 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 Umowa z Klientem Microsoft na podstawie kraju/regionu i języka klienta.

Wymagania wstępne

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

    Ważne

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

    Zachęcamy partnerów do dalszego korzystania z interfejsów API REST Centrum partnerskiego.

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

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

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

Ważne

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

.NET

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

  1. Pobierz metadane umowy dla Umowa z Klientem Microsoft. Musisz uzyskać identyfikator templateId Umowa z Klientem Microsoft. Aby uzyskać więcej informacji, zobacz Pobieranie metadanych umowy dla Umowa z Klientem Microsoft.

    // 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 identyfikator templateId Umowa z Klientem 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. Kwerenda jest domyślnie ustawiona na stany USA , jeśli metoda nie jest określona. Listę obsługiwanych kodów krajów/regionów można znaleźć na liście obsługiwanych krajów/regionów i języków. Ta metoda uwzględnia 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, zapoznaj się z listą 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 Umowa z Klientem Microsoft:

  1. Pobierz metadane umowy dla Umowa z Klientem Microsoft. Musisz uzyskać identyfikator templateId Umowa z Klientem Microsoft. Aby uzyskać więcej informacji, zobacz Pobieranie metadanych umowy dla Umowa z Klientem Microsoft.

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

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

Składnia żądania

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

Method Identyfikator URI żądania
GET {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 identyfikatora URI z żądaniem:

Nazwisko Type Wymagania opis
identyfikator szablonu umowy string Tak Unikatowy identyfikator typu umowy. Identyfikator templateId dla Umowa z Klientem Microsoft można uzyskać, pobierając metadane umowy dla Umowa z Klientem Microsoft. Aby uzyskać więcej informacji, zobacz Pobieranie metadanych umowy dla Umowa z Klientem Microsoft. W tym parametrze jest uwzględniana wielkość liter.
kraj string Nie Wskazuje kraj/region, do którego ma zastosowanie szablon umowy. Jeśli parametr nie jest określony, zapytanie jest domyślnie ustawione na stany USA . Listę obsługiwanych kodów krajów/regionów można znaleźć na liście obsługiwanych krajów/regionów i języków.
język string Nie Wskazuje język, w którym powinien zostać zlokalizowany szablon umowy. Kwerenda jest domyślnie ustawiona na en-US , jeśli parametr nie jest określony lub kod kraju/regionu określony w poleceniu nie jest obsługiwany dla określonego 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ń

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

Przykład żądania

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 , która zawiera 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 powodzenia i błędów 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żne

Właściwość kodu kraju/regionu uwzględnia wielkość liter. Pamiętaj, aby użyć poprawnej wielkości liter określonej w tej tabeli:

Kraj/region Numer kierunkowy kraju Obsługiwane kody języków
Wyspy Alandzkie AX 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 AD en-US
Angola AO en-US, pt-PT
Anguilla Sztuczna inteligencja en-US
Antarktyda AQ en-US
Antigua i Barbuda AG en-US
Argentyna rozrachunki z odbiorcami en-US, es-ES
Armenia AM en-US
Aruba AWH en-US
Australia AU en-US
Austria AT en-US, de-DE
Azerbejdżan AZ en-US
Bahamy BS en-US
Bahrajn BH en-US, ar-SA
Bangladesz BD en-US
Barbados BB en-US
Białoruś BY en-US, ru-RU
Belgia BE 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 Bouveta BV en-US
Brazylia BR en-US, pt-BR
Brytyjskie Terytorium Oceanu Indyjskiego WE/WY 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 ELEMENT KONFIGURACJI en-US, fr-FR
Wyspy Zielonego Przylądka CV en-US, pt-PT
Kambodża KH en-US
Kamerun Chassis Manager (CM) en-US, fr-FR
Kanada CA en-US, fr-FR
Kajmany KY en-US, en-US
Republika Środkowoafrykańska CF en-US
Czad LFZ en-US
Chile CL en-US, es-ES
Wyspa Bożego Narodzenia CX en-US
Wyspy Kokosowe (Keelinga) Napisy en-US
Kolumbia CO en-US, es-ES
Komory KM en-US
Kongo (DRK) CD en-US
Kongo PW 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 DO en-US, es-ES
Ekwador EC 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
Falklandy FK en-US
Wyspy Owcze FO en-US
Fidżi FJ en-US
Finlandia FI en-US, fi-FI
Francja FR en-US, fr-FR
Gujana Francuska GF en-US, fr-FR
Polinezja Francuska PF en-US
Francuskie Terytoria Południowe i Antarktyczne TF en-US
Gabon Ogólna dostępność 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 GP en-US
Guam GU en-US
Gwatemala GT en-US, es-ES
Guernsey GG en-US
Gwinea GN en-US
Gwinea Bissau GW en-US
Gujana GY en-US
Haiti HT en-US
Wyspy Heard i McDonalda HM en-US
Honduras HN en-US, es-ES
Specjalny region Administracja istracyjny w Hongkongu HK en-US, zh-HK
Węgry HU en-US, hu-HU
Islandia IS en-US
Indie IN en-US, hi-IN
Indonezja ID en-US, id-ID
Irak IQ en-US, ar-SA
Irlandia IE en-US
Wyspa Man Menadżer zdarzeń (IM) en-US
Izrael IL en-US, he-IL
Włochy Dział 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 KE en-US
Kiribati KI en-US
Korea Południowa 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 LB 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 en-US, lt-LT
Luksemburg LU en-US, fr-FR
Specjalny region Administracja istracyjny Makau MO en-US, zh-HK
Madagaskar GRUPĄ ZARZĄDZANIA en-US
Malawi MW en-US
Malezja MY 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 MR en-US
Mauritius MU en-US, ar-SA
Wyspa Majotta YT en-US
Meksyk MX en-US, es-ES
Mikronezja FM en-US
Mołdawia MD en-US, ro-RO
Monako MC en-US, fr-FR
Mongolia MN en-US
Czarnogóra ME en-US
Montserrat RN en-US
Maroko MA en-US, fr-FR, en-US
Mozambik MZ en-US
Myanmar MM en-US
Namibia NA 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
Norfolk NF en-US
Mariany Północne MP en-US
Macedonia Północna MK en-US
Norwegia NIE en-US, nb-NO
Oman OM en-US, ar-SA
Pakistan PK en-US
Palau PW en-US
Autonomia Palestyńska PS en-US
Panama PA 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
Pitcairn PN en-US
Polska PL en-US, pl-PL
Portugalia PT en-US, pt-PT
Portoryko PR en-US, en-US
Katar Pytania i odpowiedzi en-US, ar-SA
Réunion RE en-US
Rumunia RO en-US, ro-RO
Rosja RU en-US, ru-RU
Rwanda PR en-US, fr-FR
Wyspy Świętego Tomasza i Książęca SKLEP en-US, fr-FR
Saba XS en-US
Saint-Bart bartlemy BL en-US
Saint Kitts i Nevis KN en-US
Saint Lucia LC (Line Card) en-US, en-US
Saint-Martin MF en-US, en-US
Saint Pierre i Miquelon PM en-US
Saint Vincent i Grenadyny VC en-US
Samoa WS en-US
San Marino SM en-US
Arabia Saudyjska SA en-US
Senegal SN en-US, fr-FR
Serbia OS en-US, sr-Latn-RS, en-US
Seszele LZ 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 SI en-US, sl-SI
Wyspy Salomona SB en-US
Somalia SO en-US
Republika Południowej Afryki ZA en-US
Georgia Południowa i Sandwich Południowy GS en-US
Sudan Południowy SS en-US
Hiszpania ES en-US, es-ES, en-US, en-US
Sri Lanka LK en-US
Wyspa Świętej Heleny, Wyspa Wniebowstąpienia i 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 5 tys. en-US
Tonga TO en-US
Trinidad 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 TV en-US
Dalekie Wyspy Mniejsze Stanów Zjednoczonych UM en-US
Wyspy Dziewicze Stanów Zjednoczonych VI en-US
Uganda UG en-US
Ukraina UA en-US, uk-UA
Zjednoczone Emiraty Arabskie (ZEA) AE en-US, ar-SA
Zjednoczone Królestwo 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 aktywacja zbiorcza 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