取得 Microsoft 客戶合約範本的下載連結
適用於：合作夥伴中心
不適用：由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心
合約文件資源目前僅由 Microsoft 公用雲端中的合作夥伴中心支援。
本文說明如何根據客戶的國家/地區和語言，取得下載 Microsoft 客戶合約 範本的連結。
必要條件
如果您使用合作夥伴中心 .NET SDK，則需要 1.14 版或更新版本。
重要
自 2023 年 6 月起，最新的合作夥伴中心 .NET SDK 3.4.0 版現已封存。 您可以從 GitHub 下載 SDK 版本，以及 包含實用資訊的自述檔 。
鼓勵合作夥伴繼續使用 合作夥伴中心 REST API。
認證，如合作夥伴中心驗證所述。 此案例僅支援「應用程式 + 使用者」驗證。
套用 Microsoft 客戶合約 範本的客戶國家/地區。
應該當地語系化 Microsoft 客戶合約 範本的語言。
重要
- Microsoft 客戶合約 是國家/地區特定的。 要求下載 Microsoft 客戶合約 範本的連結時，請務必根據客戶的位置指定正確的國家/地區。 或支援的國家/地區清單，請參閱 支援的國家/地區和語言清單。
- 對於某些國家/地區，Microsoft 客戶合約 提供多種語言。 為了獲得最佳客戶體驗，請挑選最符合客戶需求的語言。 如需支援的語言清單，請參閱 支援的國家/地區和語言清單。
- 只有 Microsoft 客戶合約 才支援這個方法。
.NET
若要擷取連結以下載 Microsoft 客戶合約 範本：
擷取 Microsoft 客戶合約的合約中繼資料。 您必須取得 Microsoft 客戶合約的 templateId。 如需詳細資訊，請參閱取得 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 客戶合約的合約中繼資料。 您必須取得 Microsoft 客戶合約的 templateId。 如需詳細資訊，請參閱取得 Microsoft 客戶合約 的合約元數據。
建立 REST 要求以擷取 AgreementDocument 資源。 如需範例，請參閱 要求語法 範例。 您必須指定以下資訊：
- Microsoft 客戶合約 的templateId
- 套用 Microsoft 客戶合約 範本的國家/地區
- 應該當地語系化 Microsoft 客戶合約 範本的語言
要求語法
針對此資源使用下列要求語法：
| 方法 | 要求 URI |
|---|---|
| GET | {baseURL}/v1/agreementtemplates/{agreement-template-id}/document？language={language}&country={country} HTTP/1.1 |
URI 參數
您可以搭配您的要求使用下列 URI 參數：
| 名稱 | 類型 | 必要 | 描述 |
|---|---|---|---|
| agreement-template-id | string | Yes | 合約類型的唯一標識碼。 您可以藉由擷取 Microsoft 客戶合約的合約中繼資料，取得 Microsoft 客戶合約的 templateId。 如需詳細資訊，請參閱取得 Microsoft 客戶合約 的合約元數據。 此參數區分 大小寫。 |
| 國家/地區 | string | No | 指出合約範本適用的國家/地區。 如果未指定 參數，查詢會預設為 US 。 如需支持的國家/地區代碼清單，請參閱 支援的國家/地區和語言清單。 |
| language | string | No | 指出合約範本應本地化的語言。 如果未指定 參數，則查詢預設為 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"
}
支援的國家/地區和語言清單
重要
國家/地區代碼屬性會區分大小寫。 請務必使用此表格中指定的正確大小寫：
| 國家/地區 | 國碼 (地區碼) | 支援的語言代碼（s） |
|---|---|---|
| 奧蘭群島 | AX | zh-TW |
| 阿富汗 | AF | zh-TW |
| 阿爾巴尼亞 | AL | zh-TW |
| 阿爾及利亞 | 阿爾及利亞 | en-US、fr-FR、en-US |
| 美屬薩摩亞 | AS | zh-TW |
| 安道爾 | AD | zh-TW |
| 安哥拉 | AO | en-US、pt-PT |
| 安奎拉 | AI | zh-TW |
| 南極洲 | Aq | zh-TW |
| 安地卡及巴布達 | AG | zh-TW |
| 阿根廷 | AR | en-US、es-ES |
| 亞美尼亞 | 上午 | zh-TW |
| 荷屬阿魯巴 | AW | zh-TW |
| 澳洲 | AU | zh-TW |
| 奧地利 | AT | en-US， de-DE |
| 亞塞拜然 | AZ | zh-TW |
| 巴哈馬 | BS | zh-TW |
| 巴林 | BH | en-US、ar-SA |
| 孟加拉 | 孟加拉 | zh-TW |
| 巴貝多 | BB | zh-TW |
| 白俄羅斯 | BY | en-US、ru-RU |
| 比利時 | BE | en-US、nl-NL |
| 貝里斯 | BZ | en-US、es-ES |
| 貝南 | 北京 | zh-TW |
| 百慕達 | Bm | zh-TW |
| 不丹 | BT | zh-TW |
| 玻利維亞 | BO | en-US、es-ES |
| 波奈 | BQ | zh-TW |
| 波士尼亞與赫塞哥維納 | 波士尼亞與赫塞哥維納 | zh-TW |
| 波札那 | BW | zh-TW |
| 布威島 | Bv | zh-TW |
| 巴西 | 巴西 | en-US、pt-BR |
| 英屬印度洋領土 | IO | zh-TW |
| 英屬維京群島 | Vg | zh-TW |
| 汶萊 | 億 | zh-TW |
| 保加利亞 | BG | en-US、bg-BG |
| 布吉納法索 | 高爐 | zh-TW |
| 蒲隆地 | BI | zh-TW |
| 象牙海岸 (科特迪瓦) | CI | en-US、fr-FR |
| 維德角 | CV | en-US、pt-PT |
| 柬埔寨 | 柬埔寨 | zh-TW |
| 喀麥隆 | 喀麥隆 | en-US、fr-FR |
| 加拿大 | CA | en-US、fr-FR |
| 開曼群島 | KY | en-US、en-US |
| 中非共和國 | Cf | zh-TW |
| 查德 | TD | zh-TW |
| 智利 | CL | en-US、es-ES |
| 聖誕島 | 殘雪 | zh-TW |
| 科克斯 (基靈) 群島 | CC | zh-TW |
| 哥倫比亞 | CO | en-US、es-ES |
| 葛摩 | 公里 | zh-TW |
| 剛果民主共和國 | CD | zh-TW |
| 剛果 | CG | zh-TW |
| 庫克群島 | CK | zh-TW |
| 哥斯大黎加 | 哥斯大黎加 | en-US、es-ES |
| 克羅埃西亞 | HR | en-US、hr-HR |
| 庫拉索 | 連續 | zh-TW |
| 賽普勒斯 | CY | zh-TW |
| 捷克 | 捷克 | en-US、cs-CZ |
| 丹麥 | DK | en-US、da-DK |
| 吉布地 | DJ | zh-TW |
| 多米尼克 | DM | zh-TW |
| 多明尼加共和國 | D 0 | en-US、es-ES |
| 厄瓜多 | EC | zh-TW |
| 埃及 | 埃及 | en-US、ar-SA |
| 薩爾瓦多 | 薩爾瓦多 | en-US、es-ES |
| 赤道幾內亞 | GQ | zh-TW |
| 厄利垂亞 | ER | zh-TW |
| 愛沙尼亞 | EE | en-US、et-EE |
| 史瓦帝尼 | 深圳 | zh-TW |
| 衣索比亞 | ET | zh-TW |
| 福克蘭群島 | FK | zh-TW |
| 法羅群島 | F0 | zh-TW |
| 斐濟 | 斐濟 | zh-TW |
| 芬蘭 | FI | en-US、fi-FI |
| 法國 | 法國 | en-US、fr-FR |
| 法屬圭亞那 | 女朋友 | en-US、fr-FR |
| 法屬玻里尼西亞 | PF | zh-TW |
| 法屬南部屬地 | TF | zh-TW |
| 加彭 | GA | zh-TW |
| 甘比亞 | 通用汽車 | zh-TW |
| 喬治亞 | GE | zh-TW |
| 德國 | DE | en-US， de-DE |
| 迦納 | 迦納 | zh-TW |
| 直布羅陀 | Gi | zh-TW |
| 希臘 | GR | en-US、el-GR |
| 格陵蘭 | Gl | zh-TW |
| 格瑞那達 | Gd | zh-TW |
| 瓜地洛普 | GP | zh-TW |
| 關島 | 古 | zh-TW |
| 瓜地馬拉 | GT | en-US、es-ES |
| 根息 | Gg | zh-TW |
| 幾內亞 | Gn | zh-TW |
| 幾內亞比索 | GW | zh-TW |
| 蓋亞那 | Gy | zh-TW |
| 海地 | HT | zh-TW |
| 赫德島及麥當勞群島 | HM | zh-TW |
| 宏都拉斯 | 宏都拉斯 | en-US、es-ES |
| 香港特別 管理員 區 | 香港 | en-US， zh-HK |
| 匈牙利 | 匈牙利 | en-US， hu-HU |
| 冰島 | IS | zh-TW |
| 印度 | IN | en-US、hi-IN |
| 印尼 | 識別碼 | en-US， id-ID |
| 伊拉克 | 伊拉克 | en-US、ar-SA |
| 愛爾蘭 | IE | zh-TW |
| 曼島 | IM | zh-TW |
| 以色列 | 伊利諾州 | en-US、he-IL |
| 義大利 | IT | en-US，it-IT |
| 牙買加 | 牙買加 | zh-TW |
| 尖棉 | XJ | zh-TW |
| 日本 | 日本 | en-US、ja-JP |
| 澤西島 | 流行性乙型腦炎 | zh-TW |
| 約旦 | 約旦 | en-US、ar-SA |
| 哈薩克 | 哈薩克 | en-US、kk-KZ |
| 肯亞 | KB | zh-TW |
| 吉里巴斯 | KI | zh-TW |
| 南韓 | 韓國 | en-US、ko-KR |
| 科索沃 | Xk | zh-TW |
| 科威特 | KW | en-US、ar-SA |
| 吉爾吉斯 | 吉爾吉斯 | en-US、ru-RU |
| 寮國 | 洛杉磯 | zh-TW |
| 拉脫維亞 | LV | en-US、lv-LV |
| 黎巴嫩 | LB | en-US、ar-SA |
| 賴索托 | LS | zh-TW |
| 賴比瑞亞 | LR | zh-TW |
| 利比亞 | LY | en-US、ar-SA |
| 列支敦斯登 | LI | en-US， de-DE |
| 立陶宛 | LT | en-US、lt-LT |
| 盧森堡 | LU | en-US、fr-FR |
| 澳門特別 管理員 區 | MO | en-US， zh-HK |
| 馬達加斯加 | 鎂 | zh-TW |
| 馬拉威 | MW | zh-TW |
| 馬來西亞 | MY | en-US、ms-MY |
| 馬爾地夫 | MV | zh-TW |
| 馬利 | ML | zh-TW |
| 馬爾他 | MT | zh-TW |
| 馬紹爾群島 | MH | zh-TW |
| 馬丁尼克 | MQ | zh-TW |
| 茅利塔尼亞 | MR | zh-TW |
| 模里西斯 | 模里西斯 | en-US、ar-SA |
| 馬約特島 | YT | zh-TW |
| 墨西哥 | MX | en-US、es-ES |
| 密克羅尼西亞 | 調頻 | zh-TW |
| 摩爾多瓦 | MD | en-US、ro-RO |
| 摩納哥 | MC | en-US、fr-FR |
| 蒙古 | MN | zh-TW |
| 蒙特內哥羅 | ME | zh-TW |
| 蒙哲臘 | 毫秒 | zh-TW |
| 摩洛哥 | MA | en-US、fr-FR、en-US |
| 莫三比克 | MZ | zh-TW |
| 緬甸 | MM | zh-TW |
| 納米比亞 | NA | zh-TW |
| 諾魯 | 星期日 | zh-TW |
| 尼泊爾 | NP | zh-TW |
| 荷蘭 | 荷蘭 | en-US、nl-NL |
| 新喀里多尼亞 | NC | zh-TW |
| 紐西蘭 | 紐西蘭 | zh-TW |
| 尼加拉瓜 | NI | en-US、es-ES |
| 尼日 | NE | zh-TW |
| 奈及利亞 | 奈及利亞 | zh-TW |
| 紐埃島 | 女 | zh-TW |
| 諾福克島 | Nf | zh-TW |
| 北馬利安納群島 | MP | zh-TW |
| 北馬其頓 | 北馬其頓 | zh-TW |
| 挪威 | 否 | en-US、nb-NO |
| 阿曼 | OM | en-US、ar-SA |
| 巴基斯坦 | PK | zh-TW |
| 帛琉 | PW | zh-TW |
| 巴勒斯坦民族權力機構 | PS | zh-TW |
| 巴拿馬 | PA | en-US、es-ES |
| 巴布亞紐幾內亞 | PG | zh-TW |
| 巴拉圭 | 巴拉圭 | en-US、es-ES |
| 秘魯 | PE | en-US、es-ES |
| 菲律賓 | PH | zh-TW |
| 皮特肯群島 | Pn | zh-TW |
| 波蘭 | 波蘭 | en-US、pl-PL |
| 葡萄牙 | PT | en-US、pt-PT |
| 波多黎各 | PR | en-US、en-US |
| 卡達 | 問與答 | en-US、ar-SA |
| 留尼旺 | RE | zh-TW |
| 羅馬尼亞 | RO | en-US、ro-RO |
| 俄羅斯 | 俄羅斯 | en-US、ru-RU |
| 盧安達 | RW | en-US、fr-FR |
| 聖多美普林西比 | ST | en-US、fr-FR |
| 沙巴 | XS | zh-TW |
| 聖巴塞萊米 | BL | zh-TW |
| 聖克里斯多福及尼維斯 | KN | zh-TW |
| 聖露西亞 | 立法會 | en-US、en-US |
| 法屬聖馬丁 | MF | en-US、en-US |
| 聖匹島 | PM | zh-TW |
| 聖文森及格瑞那丁 | Vc | zh-TW |
| 薩摩亞 | WS | zh-TW |
| 聖馬利諾 | SM | zh-TW |
| 沙烏地阿拉伯 | SA | zh-TW |
| 塞內加爾 | SN | en-US、fr-FR |
| 塞爾維亞 | RS | en-US、sr-Latn-RS、en-US |
| 塞席爾 | SC | zh-TW |
| 獅子山 | SL | zh-TW |
| 新加坡 | SG | en-US、zh-SG |
| 聖佑達修斯 | XE | zh-TW |
| 荷屬聖馬丁 | Sx | en-US、en-US |
| 斯洛伐克 | SK | en-US， sk-SK |
| 斯洛維尼亞 | SI | en-US、sl-SI |
| 索羅門群島 | 某人 | zh-TW |
| 索馬利亞 | SO | zh-TW |
| 南非 | 南非 | zh-TW |
| 南喬治亞與南三明治群島 | Gs | zh-TW |
| 南蘇丹 | SS | zh-TW |
| 西班牙 | ES | en-US、es-ES、en-US、en-US |
| 斯里蘭卡 | 斯里蘭卡 | zh-TW |
| 聖赫勒拿、阿森松、特里斯坦達庫尼亞群島 | SH | zh-TW |
| 蘇利南 | SR | zh-TW |
| 冷岸 | Sj | zh-TW |
| 瑞典 | SE | en-US，sv-SE |
| 瑞士 | CH | en-US、fr-FR、en-US、en-US |
| 台灣 | 台灣 | en-US， zh-HK |
| 塔吉克 | TJ | zh-TW |
| 坦尚尼亞 | 坦尚尼亞 | zh-TW |
| 泰國 | TH | en-US， th-TH |
| 東帝汶 | TL | zh-TW |
| 多哥 | Tg | zh-TW |
| 托克勞群島 | TK | zh-TW |
| 東加 | 收件人 | zh-TW |
| 千里達及托巴哥 | TT | zh-TW |
| 突尼西亞 | TN | en-US、fr-FR、en-US |
| 土耳其 | 土耳其 | en-US、tr-TR |
| 土庫曼 | TM | zh-TW |
| 土克斯及開科斯群島 | Tc | zh-TW |
| 吐瓦魯 | TV | zh-TW |
| 美國外島 | UM | zh-TW |
| 美屬維爾京群島 | VI | zh-TW |
| 烏干達 | 烏干達 | zh-TW |
| 烏克蘭 | 烏克蘭 | en-US、uk-UA |
| 阿拉伯聯合大公國 | 阿拉伯聯合大公國 | en-US、ar-SA |
| 英國 | GB | zh-TW |
| 美國 | 美國 | zh-TW |
| 烏拉圭 | 烏拉圭 | en-US、es-ES |
| 烏茲別克 | 烏茲別克 | en-US、ru-RU |
| 萬那杜 | VU | zh-TW |
| 梵蒂岡 | VA | zh-TW |
| 委內瑞拉 | 佛蒙特州 | en-US、es-ES |
| 越南 | VN | en-US， vi-VN |
| 瓦利斯群島和富圖那群島 | WF | zh-TW |
| 葉門 | YE | en-US、ar-SA |
| 尚比亞 | 尚比亞 | zh-TW |
| 辛巴威 | 辛巴威 | zh-TW |