取得Microsoft客戶合約範本的下載連結

發行項
03/11/2025

適用於：合作夥伴中心

不適用於：由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心

合作夥伴中心目前僅支援Microsoft公用雲端中的 合約檔 資源。

本文說明如何根據客戶的國家/地區和語言，取得下載Microsoft客戶合約範本的連結。

先決條件

如果您使用合作夥伴中心 .NET SDK，則需要 1.14 版或更新版本。

重要

自 2023 年 6 月起，最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。您可以從 GitHub下載 SDK 版本，以及包含實用資訊的自述檔。

鼓勵合作夥伴繼續使用合作夥伴中心 REST API。
認證，如合作夥伴中心驗證中所述。此案例僅支援 App+用戶驗證。
適用Microsoft客戶合約範本的客戶國家/地區。
Microsoft 客戶合約範本應使用的本地化語言。

重要

Microsoft客戶合約是國家/地區特定的。要求下載Microsoft客戶合約範本的連結時，請務必根據客戶的位置指定正確的國家/地區。或支援的國家/地區清單，請參閱支援的國家/地區和語言清單。
對於某些國家/地區，Microsoft客戶合約提供多種語言。為了獲得最佳客戶體驗，請挑選最符合客戶需求的語言。如需支援的語言清單，請參閱支援的國家/地區和語言清單。
只有Microsoft客戶合約才支援此方法。

.NET

若要擷取連結以下載Microsoft客戶合約範本：

擷取Microsoft客戶合約的合約元數據。您必須取得 templateId 的 Microsoft 客戶合約。如需詳細資訊，請參閱取得 Microsoft 客戶合約的合約元資料。

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

使用 IAggregatePartner.AgreementTemplates 集合。
呼叫 ById 方法，並指定 Microsoft 客戶合約的 templateId。
擷取 Document 屬性。
呼叫 ByCountry 方法，並指定合約範本適用的客戶國家/地區。如果未指定方法，查詢預設為 US。如需支持的國家/地區代碼清單，請參閱支援的國家/地區和語言清單。此方法 區分大小寫。
呼叫 ByLanguage 方法，並指定合約範本應該本地化的語言。如果未指定方法，或指定的國家/地區不支援指定的國家/地區代碼，則查詢預設為 en-US。如需支援的語言代碼清單，請參閱支援的國家/地區和語言清單。

呼叫 的 Get 或 的 GetAsync 方法。

// IAggregatePartner partnerOperations;

string customerCountry = "US";

string languageForLocalization = "en-US";

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

您可以從控制台測試應用程式專案中，找到 GetAgreementDetails 類別的完整範例。

REST 要求

若要擷取連結以下載Microsoft客戶合約範本：

擷取Microsoft客戶合約的合約元數據。您必須取得 templateId 的 Microsoft 客戶合約。如需詳細資訊，請參閱取得 Microsoft 客戶合約的合約元資料。
建立一個 REST 請求來擷取 協議文件 資源。如需範例，請參閱要求語法範例。您必須指定以下資訊：
- Microsoft客戶合約的 templateId
- 適用Microsoft客戶合約範本的國家/地區
- 應將 Microsoft 客戶合約範本本地化的語言

請求語法

針對此資源使用下列要求語法：

方法	要求 URI
獲取	{baseURL}/v1/agreementtemplates/{agreement-template-id}/document？language={language}&country={country} HTTP/1.1

URI 參數

您可以搭配您的要求使用下列 URI 參數：

名字	類型	必填	描述
協議範本識別碼 (agreement-template-id)	字串	是的	合約類型的唯一標識碼。您可以透過取得 Microsoft 客戶合約的合約元數據來獲取 Microsoft 客戶合約的 templateId。如需詳細資訊，請參閱取得 Microsoft 客戶合約的合約元資料。這個參數區分大小寫。
國家	字串	不	指出合約範本適用的國家/地區。如果未指定參數，查詢預設為 US。如需支持的國家/地區代碼清單，請參閱支援的國家/地區和語言清單。
語言	字串	不	指出合約範本應本地化的語言。如果未指定參數，或不支援指定的國家/地區，則查詢預設為 en-US。如需支持的國家/地區代碼清單，請參閱支援的國家/地區和語言清單。

請求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

請求正文

沒有。

要求範例

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 回應

如果成功，此方法會在回應主體中傳回 AgreementDocument 資源。

資源具有 downloadUri 屬性，其中包含可用來下載合約範本的 URL 字串。每次進行查詢時，都會傳回不同的連結。此連結會在五分鐘後到期。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。

使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心 REST 錯誤碼。

回應範例

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

支援的國家/地區和語言清單

重要

國家/地區代碼屬性會區分大小寫。請務必按照此表格中所指定的正確大小寫使用：

國家/地區	國家代碼	支援的語言代碼
奧蘭群島	斧頭	en-US
阿富汗	AF	en-US
阿爾巴尼亞	鋁	en-US
阿爾及利亞	DZ	en-US、fr-FR、en-US
美屬薩摩亞	N/A	en-US
安道爾	廣告	en-US
安哥拉	AO	en-US、pt-PT
安圭拉	人工智慧	en-US
南極洲	AQ	en-US
安地瓜和巴布達	銀	en-US
阿根廷	AR	en-US、es-ES
亞美尼亞	上午	en-US
阿路巴島	AW	en-US
澳大利亞	AU	en-US
奧地利	在	en-US、de-DE
亞塞拜然	AZ	en-US
巴哈馬	理學士	en-US
巴林	BH	en-US、ar-SA
孟加拉國	屋宇署	en-US
巴巴多斯	BB	en-US
白俄羅斯	由	en-US、ru-RU
比利時	是	en-US、nl-NL
伯利茲	BZ	en-US、es-ES
貝南	BJ	en-US
百慕達	BM	en-US
不丹	BT	en-US
玻利維亞	博	en-US、es-ES
博奈爾	BQ	en-US
波士尼亞和黑塞哥維那	文学士	en-US
博茨瓦納	BW	en-US
布維特島	BV	en-US
巴西	BR	en-US、pt-BR
英屬印度洋領地	IO	en-US
英屬維爾京群島	VG	en-US
汶萊	億	en-US
保加利亞	BG	en-US、bg-BG
布吉納法索	男友 / 好朋友	en-US
蒲隆地	商業智慧 (BI)	en-US
科特迪瓦	CI	en-US、fr-FR
卡波維德	簡歷	en-US、pt-PT
柬埔寨	KH	en-US
喀麥隆	釐米	en-US、fr-FR
加拿大	CA	en-US、fr-FR
開曼群島	肯塔基州	en-US、en-US
中非共和國	CF	en-US
乍得	TD	en-US
智利	CL	en-US、es-ES
聖誕島	CX	en-US
可哥斯（基蘭）群島	CC	en-US
哥倫比亞	一氧化碳	en-US、es-ES
科摩羅	公里	en-US
剛果（金）	CD	en-US
剛果	CG	en-US
庫克群島	CK	en-US
哥斯大黎加	CR	en-US、es-ES
克羅埃西亞	人力資源	en-US、hr-HR
庫拉索	連續波	en-US
塞普勒斯	CY	en-US
捷克	CZ	en-US、cs-CZ
丹麥	DK	en-US、da-DK
吉布地	DJ（音樂主持人）	en-US
多明尼加	分米	en-US
多明尼加共和國	做	en-US、es-ES
厄瓜多	電子商務 (EC)	en-US
埃及	EG	en-US、ar-SA
薩爾瓦多	SV	en-US、es-ES
赤道幾內亞	GQ	en-US
厄利垂亞	急診室	en-US
愛沙尼亞	EE	en-US、et-EE
eSwatini	SZ	en-US
衣索比亞	ET	en-US
福克蘭群島	FK	en-US
法羅群島	FO	en-US
斐濟	FJ	en-US
芬蘭	FI	en-US、fi-FI
法國	FR	en-US、fr-FR
法屬蓋亞那	女朋友	en-US、fr-FR
法屬波利尼西亞	PF (功率因數)	en-US
法國南部領土	TF	en-US
加彭	GA	en-US
岡比亞	通用汽車	en-US
喬治亞	通用電氣	en-US
德國	德	en-US、de-DE
迦納	GH	en-US
直布羅陀	GI	en-US
希臘	GR	en-US、el-GR
格陵蘭	GL	en-US
格林納達	GD	en-US
瓜德羅普	GP	en-US
關島	GU	en-US
瓜地馬拉	GT	en-US、es-ES
格恩西島	GG	en-US
幾內亞	GN	en-US
Guinea-Bissau	GW	en-US
蓋亞那	GY	en-US
海地	HT	en-US
赫德島和麥克唐納群島	HM	en-US
宏都拉斯	HN	en-US、es-ES
香港特別行政區	香港	en-US、zh-HK
匈牙利	胡	en-US、hu-HU
冰島	是	en-US
印度	在內	en-US、hi-IN
印尼	標識碼	en-US、id-ID
伊拉克	智商	en-US、ar-SA
愛爾蘭	IE	en-US
曼島	即時通信	en-US
以色列	IL	en-US、he-IL
義大利	資訊技術	en-US、it-IT
牙買加	JM	en-US
Jan Mayen	XJ	en-US
日本	JP	en-US、ja-JP
澤西	日本腦炎	en-US
約旦	喬	en-US、ar-SA
哈薩克	KZ	en-US、kk-KZ
肯亞	KE	en-US
基裡巴斯	KI	en-US
韓國	KR	en-US、ko-KR
科索沃	XK	en-US
科威特	千瓦	en-US、ar-SA
吉爾吉斯斯坦	公斤	en-US、ru-RU
老撾	洛杉磯	en-US
拉托維亞	LV	en-US、lv-LV
黎巴嫩	磅	en-US、ar-SA
萊索托	LS	en-US
利比瑞亞	LR	en-US
利比亞	LY	en-US、ar-SA
列支敦斯登	李	en-US、de-DE
立陶宛	LT	en-US、lt-LT
盧森堡	LU	en-US、fr-FR
澳門特別行政區	莫	en-US、zh-HK
馬達加斯加	MG	en-US
馬拉威	兆瓦	en-US
馬來西亞	我	en-US、ms-MY
瑪律地夫	音樂錄影帶	en-US
馬里	機器學習	en-US
馬爾他	MT	en-US
馬紹爾群島	MH	en-US
馬丁尼克	MQ	en-US
茅利塔尼亞	先生	en-US
模里西斯	MU	en-US、ar-SA
馬約特	YT	en-US
墨西哥	MX	en-US、es-ES
密克羅尼西亞	調頻	en-US
摩爾多瓦	醫學博士	en-US、ro-RO
摩納哥	司儀	en-US、fr-FR
蒙古	明尼蘇達州	en-US
黑山	我	en-US
蒙特塞拉特	女士	en-US
摩洛哥	MA	en-US、fr-FR、en-US
莫三比克	MZ	en-US
緬甸	毫米	en-US
納米比亞	不適用	en-US
瑙魯	NR	en-US
尼泊爾	NP	en-US
荷蘭	新行	en-US、nl-NL
新喀里多尼亞	數控	en-US
紐西蘭	紐西蘭	en-US
尼加拉瓜	鎳	en-US、es-ES
尼日爾	NE	en-US
奈及利亞	不行	en-US
紐埃	NU	en-US
諾福克島	NF	en-US
北馬里亞納群島	MP	en-US
北馬其頓	MK	en-US
挪威	不	en-US、nb-NO
阿曼	OM	en-US、ar-SA
巴基斯坦	PK	en-US
帕勞	密碼	en-US
巴勒斯坦權力機構	附註	en-US
巴拿馬	PA	en-US、es-ES
巴布亞紐幾內亞	PG (輔導級)	en-US
巴拉圭	PY	en-US、es-ES
秘魯	體育課	en-US、es-ES
菲律賓	酸鹼度	en-US
皮特凱恩群島	PN	en-US
波蘭	PL	en-US、pl-PL
葡萄牙	PT	en-US、pt-PT
波多黎各	公關	en-US、en-US
卡達	品質保證	en-US、ar-SA
留尼汪	回覆	en-US
羅馬尼亞	RO	en-US、ro-RO
俄羅斯	RU	en-US、ru-RU
盧安達	RW	en-US、fr-FR
聖托梅和普林西比	聖	en-US、fr-FR
薩巴	XS	en-US
Saint-Barthélemy	BL	en-US
聖基茨和尼維斯	KN	en-US
聖盧西亞	立法會	en-US、en-US
聖馬丁	MF	en-US、en-US
聖皮埃爾和米奎隆	下午	en-US
聖文森特和格林納丁人	風險投資 (VC)	en-US
薩摩亞	WS	en-US
聖馬利諾	SM	en-US
沙烏地阿拉伯	SA	en-US
塞內加爾	SN	en-US、fr-FR
塞爾維亞	RS	en-US、sr-Latn-RS、en-US
塞席爾	SC	en-US
塞拉利昂	SL	en-US
新加坡	新加坡	en-US、zh-SG
聖尤斯塔修斯	氙	en-US
聖馬丁	SX	en-US、en-US
斯洛伐克	SK	en-US、sk-SK
斯洛維尼亞	SI	en-US、sl-SI
所羅門群島	某人	en-US
索馬里	所以	en-US
南非	南非	en-US
南佐治亞州和南三明治群島	GS	en-US
南蘇丹	SS	en-US
西班牙	ES	en-US、es-ES、en-US、en-US
斯里蘭卡	LK	en-US
聖海倫娜，阿森森，特裡斯坦達庫尼亞	SH	en-US
蘇里南	SR	en-US
斯瓦爾巴群島	SJ	en-US
瑞典	SE	en-US、sv-SE
瑞士	CH	en-US、fr-FR、en-US、en-US
臺灣	TW	en-US、zh-HK
塔吉克	TJ	en-US
坦尚尼亞	TZ	en-US
泰國	TH	en-US、th-TH
Timor-Leste	TL	en-US
多哥	TG	en-US
托克勞	TK	en-US
湯加	到	en-US
特立尼達和多巴哥	TT	en-US
突尼西亞	TN	en-US、fr-FR、en-US
土耳其	TR	en-US、tr-TR
土庫曼	TM	en-US
土耳其群島和凱科斯群島	TC	en-US
圖瓦盧	電視	en-US
美國郊外群島	嗯	en-US
美屬維爾京群島	六	en-US
烏干達	UG	en-US
烏克蘭	UA	en-US、uk-UA
阿拉伯聯合大陸	AE	en-US、ar-SA
英國	GB	en-US
美國	美國	en-US
烏拉圭	UY	en-US、es-ES
烏茲別克	UZ	en-US、ru-RU
瓦努阿圖	VU	en-US
梵蒂岡城	VA	en-US
委內瑞拉	VE	en-US、es-ES
越南	VN	en-US、vi-VN
瓦利斯和富圖納	WF	en-US
葉門	汝	en-US、ar-SA
尚比亞	ZM	en-US
辛巴威	ZW	en-US

共用方式為