Letöltési hivatkozás beszerzése a Microsoft Ügyfélszerződés sablonhoz

Aa Partnerközpontra vonatkozik

Nem vonatkozik a: A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára

A AgreementDocument erőforrást jelenleg csak a Microsoft nyilvános felhőben támogatja a Partnerközpont.

Ez a cikk bemutatja, hogyan kérhet le egy hivatkozást a Microsoft Ügyfélszerződés sablon letöltéséhez az ügyfél országa/régiója és nyelve alapján.

Előfeltételek

• Ha a Partnerközpont .NET SDK-t használja, az 1.14-es vagy újabb verzióra van szükség.

  Fontos

  2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást a GitHubról töltheti le, valamint egy README fájlt, amely hasznos információkat tartalmaz.

  A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.

• A Partnerközpont hitelesítése által meghatározott hitelesítő adatok. Ez a forgatókönyv csak az App+User hitelesítést támogatja.

• Az ügyfél országa/régiója, amelyre a Microsoft Ügyfélszerződés sablon vonatkozik.

• A Microsoft Ügyfélszerződés sablon fordítandó nyelve.

Fontos

• A Microsoft Ügyfélszerződés ország-/régióspecifikus. Amikor a Microsoft Ügyfélszerződés sablon letöltésére mutató hivatkozást kér, ügyeljen arra, hogy az ügyfél tartózkodási helye alapján adja meg a megfelelő országot/régiót. vagy a támogatott országok/régiók listája, tekintse meg támogatott országok/régiók és nyelvek listáját.
• Egyes országokban/régiókban a Microsoft Ügyfélszerződés több nyelven is elérhető. A legjobb ügyfélélmény érdekében válassza ki az ügyfél igényeinek leginkább megfelelő nyelvet. A támogatott nyelvek listájáért tekintse meg támogatott országok/régiók és nyelvek listáját.
• Ezt a módszert csak a Microsoft Ügyfélszerződés támogatja.

.HÁLÓ

A Microsoft Ügyfélszerződés sablon letöltésére mutató hivatkozás lekérése:

1. A Microsoft Ügyfélszerződés szerződési metaadatainak lekérése. Meg kell szereznie a Microsoft Ügyfélszerződés sablonazonosítóját. További információ: Szerződés metaadatainak lekérése a Microsoft Ügyfélszerződéshez.

   // IAggregatePartner partnerOperations;
   
   string agreementType = "MicrosoftCustomerAgreement";
   
   AgreementMetaData microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.   ByAgreementType(agreementType).Get().Items.Single();
   

2. Használja az IAggregatePartner.AgreementTemplates gyűjteményt.

3. Hívja meg a ById metódust, és adja meg a Microsoft Ügyfélszerződés templateId értékét.

4. Kérd le a Document tulajdonságot.

5. Hívja meg a ByCountry metódust, és adja meg az ügyfél országát/régióját, amelyre a szerződéssablon vonatkozik. A lekérdezés alapértelmezés szerint USA, ha a metódus nincs megadva. A támogatott ország-/régiókódok listájáért tekintse meg támogatott országok/régiók és nyelvek listáját. Ez a módszer megkülönbözteti a kis- és nagybetűk.

6. Hívja meg a ByLanguage metódust, és adja meg azt a nyelvet, amelyben a szerződéssablont honosítani kell. A lekérdezés alapértelmezés szerint en-US, ha a metódus nincs megadva, vagy ha a megadott ország/régió kód nem támogatott a megadott ország/régió esetében. A támogatott nyelvi kódok listájáért tekintse meg támogatott országok/régiók és nyelvek listáját.

7. Hívja meg a Get vagy GetAsync metódust.

   // IAggregatePartner partnerOperations;
   
   string customerCountry = "US";
   
   string languageForLocalization = "en-US";
   
   var agreementDocument = partnerOperations.   AgreementTemplates.ById   (microsoftCustomerAgreementDetails.   TemplateId).Document.ByCountry   (customerCountry).ByLanguage   (languageForLocalization).Get();
   

Teljes minta található a GetAgreementDetails osztályban a konzoltesztelő alkalmazás projektből.

REST-kérés

A Microsoft Ügyfélszerződés sablon letöltésére mutató hivatkozás lekérése:

1. A Microsoft Ügyfélszerződés szerződési metaadatainak lekérése. Meg kell szereznie a Microsoft Ügyfélszerződés sablonazonosítóját. További információ: Szerződés metaadatainak lekérése a Microsoft Ügyfélszerződéshez.

2. Hozzon létre egy REST-kérést egy AgreementDocument erőforráslekéréséhez. Példaként tekintse meg a kérés szintaxisát példát. A következő adatokat kell megadnia:

   • A Microsoft Ügyfélszerződés templateId azonosítója
   • Az az ország/régió, amelyre a Microsoft Ügyfélszerződés sablon vonatkozik
   • Az a nyelv, amelyen a Microsoft Ügyfélszerződés sablont honosítanák

Kérés szintaxisa

Használja az erőforrás következő kérésszintaxisát:

Módszer	URI kérése
MEGSZEREZNI	{baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

URI-paraméterek

A kéréshez a következő URI-paramétereket használhatja:

Név	Típus	Szükséges	Leírás
szerződés-sablon azonosítója	húr	Igen	A szerződéstípus egyedi azonosítója. A Microsoft Ügyfélszerződés sablonazonosítóját a Microsoft Ügyfélszerződéshez tartozó szerződés metaadatainak lekérésével szerezheti be. További információ: Szerződés metaadatainak lekérése a Microsoft Ügyfélszerződéshez. Ez a paraméter nagybetűérzékeny.
ország	húr	Nem	Azt az országot/régiót jelzi, amelyre a szerződéssablon vonatkozik. Az alapértelmezett lekérdezés amerikai, ha a paraméter nincs megadva. A támogatott ország-/régiókódok listájáért tekintse meg támogatott országok/régiók és nyelvek listáját.
Nyelv	húr	Nem	Azt a nyelvet jelzi, amelyben a szerződéssablont honosítanák. A lekérdezés alapértelmezés szerint en-US, ha a paraméter nincs megadva, vagy a megadott ország/régió kódja nem támogatott a megadott országban vagy régióban. A támogatott ország-/régiókódok listájáért tekintse meg támogatott országok/régiók és nyelvek listáját.

Kérelemfejlécek

További információért lásd a Partnerközpont REST-fejlécei oldalt.

Kérelem szövegtörzse

Egyik sem.

Példa kérése

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-válasz

Ha sikeres, ez az eljárás egy AgreementDocument erőforrást ad vissza a válasz törzsében.

Az erőforrás rendelkezik egy downloadUri tulajdonságával, amely egy URL-sztringet tartalmaz, amely a szerződéssablon letöltéséhez használható. Minden lekérdezéskor egy másik hivatkozás lesz visszaadva. Ez a hivatkozás öt perc elteltével lejár.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint egyéb hibakeresési információkat.

A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes lista megtekintéséhez lásd a Partnerközpont REST hibakódjait .

Példa válaszra

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

Támogatott országok/régiók és nyelvek listája

Fontos

Az ország/régió kód tulajdonsága érzékeny a kis- és nagybetűkre. Ügyeljen arra, hogy a táblázatban megadott megfelelő burkolatot használja:

Ország/régió	Országkód	Támogatott nyelvi kódok
Åland-szigetek	FEJSZE	en-US
Afganisztán	AF	en-US
Albánia	AL	en-US
Algéria	DZ	en-US, fr-FR, en-US
Amerikai Szamoa	KÉNT	en-US
Andorra	HIRDETÉS	en-US
Angola	AO	en-US, pt-PT
Anguilla	Mesterséges Intelligencia	en-US
Antarktisz	AQ	en-US
Antigua és Barbuda	Részvénytársaság	en-US
Argentína	kiterjesztett valóság	en-US, es-ES
Örményország	DE	en-US
Aruba	AW	en-US
Ausztrália	AU	en-US
Ausztria	NÁL	en-US, de-DE
Azerbajdzsán	AZ	en-US
Bahama-szigetek	hülyeség	en-US
Bahrein	BH	en-US, ar-SA
Banglades	BD	en-US
Barbados	BB	en-US
Fehéroroszország	ÁLTAL	en-US, ru-RU
Belgium	LÉGY	en-US, nl-NL
Belize	BZ	en-US, es-ES
Benin	BJ	en-US
Bermuda	BM	en-US
Bhután	BT	en-US
Bolívia	BO	en-US, es-ES
Bonaire	BQ	en-US
Bosznia-Hercegovina	Bölcsészdiploma	en-US
Botswana	BW	en-US
Bouvet-sziget	BV	en-US
Brazília	BR	en-US, pt-BR
Brit Indiai-óceán területe	IO	en-US
Brit Virgin-szigetek	VG	en-US
Brunei	BN	en-US
Bulgária	BG	en-US, bg-BG
Burkina Faso	BF	en-US
Burundi	Üzleti Intelligencia (BI)	en-US
Elefántcsontpart	CI (Folyamatos integráció)	en-US, fr-FR
Cabo Verde	Önéletrajz	en-US, pt-PT
Kambodzsa	KH	en-US
Kamerun	cm	en-US, fr-FR
Kanada	HITELESÍTÉSSZOLGÁLTATÓ	en-US, fr-FR
Kajmán-szigetek	KY	en-US, en-US
Közép-afrikai Köztársaság	CF	en-US
Csád	TD	en-US
Chile	CL	en-US, es-ES
Karácsony-sziget	CX	en-US
Cocos -szigetek (Keeling)	CC	en-US
Kolumbia	Szén-monoxid	en-US, es-ES
Comore-szigetek	KILOMÉTER	en-US
Kongó (KDK)	CD	en-US
Kongó	Számítógépes grafika	en-US
Cook-szigetek	CK	en-US
Costa Rica	CR	en-US, es-ES
Horvátország	Humánerőforrás	angol (Egyesült Államok), horvát (Horvátország)
Curaçao	CW	en-US
Ciprus	CY	en-US
Csehország	CZ	en-US, cs-CZ
Dánia	DK	en-US, da-DK
Dzsibuti	DJ	en-US
Dominika	DECIMÉTER	en-US
Dominikai Köztársaság	CSINÁL	en-US, es-ES
Ecuador	EK	en-US
Egyiptom	PL.	en-US, ar-SA
El Salvador	SV	en-US, es-ES
Egyenlítői-Guinea	GQ	en-US
Eritrea	Sürgősségi osztály	en-US
Észtország	EE	en-US, et-EE
eSwatini	SZ	en-US
Etiópia	ET	en-US
Falkland-szigetek	FK	en-US
Feröer-szigetek	FO	en-US
Fidzsi	FJ	en-US
Finnország	FI	en-US, fi-FI
Franciaország	FR	en-US, fr-FR
Francia Guyana	barátnő	en-US, fr-FR
Francia Polinézia	PF	en-US
Francia déli területek	TF	en-US
Gabon	Georgia	en-US
Gambia	General Motors	en-US
Grúzia	GE	en-US
Németország	DE	en-US, de-DE
Ghána	GH	en-US
Gibraltár	Gasztrointesztinális	en-US
Görögország	GR	en-US, el-GR
Grönland	GL	en-US
Grenada	General Director	en-US
Guadeloupe	háziorvos	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-sziget és McDonald-szigetek	Honvédelmi Minisztérium	en-US
Honduras	HN	en-US, es-ES
Hongkong különleges közigazgatási régiója	Hongkong	en-US, zh-HK
Magyarország	HU	en-US, hu-HU
Izland	VAN	en-US
India	BAN	en-US, hi-IN
Indonézia	AZONOSÍTÓ	en-US, id-ID
Irak	IQ	en-US, ar-SA
Írország	Internet Explorer (IE)	en-US
Man-sziget	IM	en-US
Izrael	Illinois	en-US, he-IL
Olaszország	Informatika	en-US, it-IT
Jamaica	JM	en-US
Jan Mayen	XJ	en-US
Japán	JP	en-US, ja-JP
Jersey	JE	en-US
Jordánia	JO	en-US, ar-SA
Kazahsztán	KZ	en-US, kk-KZ
Kenya	KE	en-US
Kiribati	KI	en-US
Korea	KR	en-US, ko-KR
Koszovó	XK	en-US
Kuvait	kW	en-US, ar-SA
Kirgizisztán	Kilogramm	en-US, ru-RU
Laosz	LÁ	en-US
Lettország	LV	en-US, lv-LV
Libanon	LB	en-US, ar-SA
Lesotho	LS	en-US
Libéria	LR	en-US
Líbia	LY	en-US, ar-SA
Liechtenstein	LI	en-US, de-DE
Litvánia	LT	en-US, lt-LT
Luxemburg	LU	en-US, fr-FR
Macao különleges közigazgatási régiója	MO	en-US, zh-HK
Madagaszkár	MG	en-US
Malawi	megawatt	en-US
Malajzia	AZ ÉN	en-US, ms-MY
Maldív-szigetek	MV	en-US
Mali	ML vagy gépi tanulás	en-US
Málta	MT	en-US
Marshall-szigetek	Magyar Honvédség	en-US
Martinique	MQ	en-US
Mauritánia	ÚR	en-US
Mauritius	MŰ	en-US, ar-SA
Mayotte	YouTube	en-US
Mexikó	MX	en-US, es-ES
Mikronézia	FM	en-US
Moldova	MD	en-US, ro-RO
Monaco	Ceremóniamester	en-US, fr-FR
Mongólia	MN	en-US
Montenegró	ENGEM	en-US
Montserrat	SM	en-US
Marokkó	MA	en-US, fr-FR, en-US
Mozambik	MZ	en-US
Mianmar	MM	en-US
Namíbia	N/A	en-US
Nauru	NR	en-US
Nepál	NP	en-US
Hollandia	Hollandia	en-US, nl-NL
Új-Kaledónia	NC	en-US
Új-Zéland	NZ	en-US
Nicaragua	NI	en-US, es-ES
Niger	NE	en-US
Nigéria	NG	en-US
Niue	NŰ	en-US
Norfolk-sziget	NF	en-US
Északi Mariana-szigetek	képviselő	en-US
Észak-Macedónia	MK	en-US
Norvégia	NEM	en-US, nb-NO
Omán	OM	en-US, ar-SA
Pakisztán	PK	en-US
Palau	HADIFOGOLY	en-US
Palesztin Hatóság	PS	en-US
Panama	PA	en-US, es-ES
Pápua Új-Guinea	12 éven aluliak számára nem ajánlott	en-US
Paraguay	PY	en-US, es-ES
Peru	PE	en-US, es-ES
Fülöp-szigetek	PH	en-US
Pitcairn-szigetek	PN	en-US
Lengyelország	PL	en-US, pl-PL
Portugália	PT	en-US, pt-PT
Puerto Rico	Közönségkapcsolatok	en-US, en-US
Katar	MINŐSÉGBIZTOSÍTÁSI	en-US, ar-SA
Réunion	ISMÉT	en-US
Románia	RO	en-US, ro-RO
Oroszország	Oroszország	en-US, ru-RU
Ruanda	RW	en-US, fr-FR
São Tomé és Príncipe	SZT	en-US, fr-FR
Saba	XS	en-US
Saint-Barthélemy	BL	en-US
Saint Kitts és Nevis	KN	en-US
Saint Lucia	LC	en-US, en-US
Szent Márton	MF	en-US, en-US
Saint Pierre és Miquelon	PM	en-US
Saint Vincent és Grenadine-szigetek	VC	en-US
Szamoa	WS	en-US
San Marino	SM	en-US
Szaúd-Arábia	SA	en-US
Szenegál	SN	en-US, fr-FR
Szerbia	RS	en-US, sr-Latn-RS, en-US
Seychelle-szigetek	SC	en-US
Sierra Leone	SL	en-US
Szingapúr	SG	en-US, zh-SG
Sint Eustatius	XE	en-US
Sint Maarten	SX	en-US, en-US
Szlovákia	SK	en-US, sk-SK
Szlovénia	Nemzetközi Mértékegységrendszer	en-US, sl-SI
Salamon-szigetek	SB	en-US
Szomália	Tehát	en-US
Dél-Afrika	ZA	en-US
Dél-Georgia és Dél-Sandwich-szigetek	GS	en-US
Dél-Szudán	SS	en-US
Spanyolország	ES	en-US, es-ES, en-US, en-US
Srí Lanka	LK	en-US
Szent Ilona, Ascension, Tristan da Cunha	SH	en-US
Suriname	SR	en-US
Svalbard-szigetek	SJ	en-US
Svédország	SE	en-US, sv-SE
Svájc	CH	en-US, fr-FR, en-US, en-US
Tajvan	TW	en-US, zh-HK
Tádzsikisztán	TJ	en-US
Tanzánia	TZ	en-US
Thaiföld	TH	en-US, th-TH
Timor-Leste	TL	en-US
Togo	KSZ	en-US
Tokelau	TK	en-US
Tonga	HOZ	en-US
Trinidad és Tobago	TT	en-US
Tunézia	TN	en-US, fr-FR, en-US
Törökország	TR	en-US, tr-TR
Türkmenisztán	TM	en-US
Turks és Caicos-szigetek	TC	en-US
Tuvalu	tévé	en-US
az Egyesült Államok külső szigetei	MIKROMÉTER	en-US
Amerikai Virgin-szigetek	VI	en-US
Uganda	UG	en-US
Ukrajna	UA	en-US, uk-UA
Egyesült Arab Emírségek	Æ	en-US, ar-SA
Egyesült Királyság	GB	en-US
Egyesült Államok	USA	en-US
Uruguay	UY	en-US, es-ES
Üzbegisztán	UZ	en-US, ru-RU
Vanuatu	JE	en-US
Vatikán	VA	en-US
Venezuela	VE	en-US, es-ES
Vietnam	VN	en-US, vi-VN
Wallis és Futuna	WF	en-US
Jemen	TI	en-US, ar-SA
Zambia	ZM	en-US
Zimbabwe	ZW	en-US