Microsoft 顧客契約テンプレートのダウンロードリンクを取得する

[アーティクル]
03/13/2025

に適用: パートナーセンター

はには適用されません: 21Vianet が運営するパートナーセンター |Microsoft Cloud for US Government のパートナーセンター

AgreementDocument リソースは、現在、Microsoft パブリッククラウドのパートナーセンターでのみサポートされています。

この記事では、お客様の国/地域と言語に基づいて、Microsoft 顧客契約テンプレートをダウンロードするためのリンクを取得する方法について説明します。

前提条件

パートナーセンター .NET SDK を使用している場合は、バージョン 1.14 以降が必要です。

重要

2023 年 6 月の時点で、最新のパートナーセンター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。有用な情報を含む readme ファイルと一緒に、GitHub から SDK リリースをダウンロードできます。

パートナーは、パートナーセンター REST API引き続き使用することをお勧めします。
パートナーセンター認証で説明されている資格情報。このシナリオでは、App+User 認証のみがサポートされます。
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 パラメーターを使用できます。

名前	型	必須	説明
契約テンプレートID	糸	はい	契約の種類の一意識別子。 Microsoft 顧客契約の契約メタデータを取得することで、Microsoft 顧客契約の templateId を取得できます。詳細については、「Microsoft 顧客契約の契約メタデータを取得する」を参照してください。このパラメーターでは、大文字と小文字が区別されます。
country	糸	いいえ	契約テンプレートが適用される国/地域を示します。パラメーターが指定されていない場合、クエリは既定で 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 文字列が含まれています。クエリを実行するたびに、異なるリンクが返されます。このリンクは 5 分後に期限切れになります。

応答の成功とエラーコード

各応答には、成功または失敗とその他のデバッグ情報を示す 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"
}

サポートされている国/地域と言語の一覧

重要

国/地域コードのプロパティでは、大文字と小文字が区別されます。大文字と小文字を次の表で指定されているとおりに正しく使用するようにしてください。

国/地域	国コード	サポートされている言語コード
オーランド諸島	AX	en-US
アフガニスタン	AF	en-US
アルバニア	AL	en-US
アルジェリア	DZ	en-US、fr-FR、en-US
米領サモア	AS	en-US
アンドラ	AD	en-US
アンゴラ	AO	en-US、pt-PT
アンギラ	人工知能	en-US
南極大陸	AQ	en-US
アンティグア・バーブーダ	AG	en-US
アルゼンチン	拡張現実	en-US、es-ES
アルメニア	AM	en-US
アルバ	AW	en-US
オーストラリア	AU	en-US
オーストリア	AT	en-US、de-DE
アゼルバイジャン	アリゾナ州	en-US
バハマ	BS	en-US
バーレーン	BH	en-US、ar-SA
バングラデシュ	BD	en-US
バルバドス	BB	en-US
ベラルーシ	BY	en-US、ru-RU
ベルギー	BE	en-US、nl-NL
ベリーズ	BZ	en-US、es-ES
ベナン	BJ	en-US
バーミューダ	BM	en-US
ブータン	BT	en-US
ボリビア	BO	en-US、es-ES
ボネール島	BQ	en-US
ボスニア・ヘルツェゴビナ	BA	en-US
ボツワナ	BW	en-US
ブーベ島	BV	en-US
ブラジル	BR	en-US、pt-BR
イギリス領インド洋地域	イオ	en-US
イギリス領バージン諸島	VG	en-US
ブルネイ	BN	en-US
ブルガリア	BG	en-US、bg-BG
ブルキナファソ	BF	en-US
ブルンジ	ビジネスインテリジェンス (BI)	en-US
コートジボワール	CI	en-US、fr-FR
カーボベルデ	CV	en-US、pt-PT
カンボジア	KH	en-US
カメルーン	CM	en-US、fr-FR
カナダ	CA	en-US、fr-FR
ケイマン諸島	KY	en-US、en-US
中央アフリカ共和国	CF	en-US
チャド	TD	en-US
チリ	CL	en-US、es-ES
クリスマス島	CX	en-US
ココス (キーリング) 諸島	CC	en-US
コロンビア	CO	en-US、es-ES
コモロ	キロメートル	en-US
コンゴ共和国 (DRC)	CD	en-US
コンゴ共和国	CG	en-US
クック諸島	CK	en-US
コスタリカ	CR	en-US、es-ES
クロアチア	HR	en-US、hr-HR
キュラソー	CW	en-US
キプロス	CY	en-US
チェコ	CZ	en-US、cs-CZ
デンマーク	DK	en-US、da-DK
ジブチ	DJ	en-US
ドミニカ国	DM	en-US
ドミニカ共和国	DO	en-US、es-ES
エクアドル	EC	en-US
エジプト	EG	en-US、ar-SA
エルサルバドル	SV	en-US、es-ES
赤道ギニア	GQ	en-US
エリトリア	ER	en-US
エストニア	EE	en-US、et-EE
eSwatin	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
仏領ギアナ	GF	en-US、fr-FR
フランス領ポリネシア	PF	en-US
フランス南部準州	TF	en-US
ガボン	GA	en-US
ガンビア	GM	en-US
グルジア	GE	en-US
ドイツ	DE	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
ギニアビサウ	ゴールデンウィーク	en-US
ガイアナ	GY	en-US
ハイチ	HT	en-US
ハード島とマクドナルド諸島	HM	en-US
ホンジュラス	HN	en-US、es-ES
香港特別行政区	HK	en-US、zh-HK
ハンガリー	HU	en-US、hu-HU
アイスランド	IS	en-US
インド	IN	en-US、hi-IN
インドネシア	身分証明書	en-US、id-ID
イラク	知能指数	en-US、ar-SA
アイルランド	IE	en-US
マン島	IM	en-US
イスラエル	イリノイ	en-US、he-IL
イタリア	情報技術	en-US、it-IT
ジャマイカ	JM	en-US
Jan Mayen	XJ	en-US
日本	JP	en-US、ja-JP
ジャージー	JE	en-US
ヨルダン	ジョー	en-US、ar-SA
カザフスタン	KZ	en-US、kk-KZ
ケニア	KE	en-US
キリバス	KI	en-US
韓国	韓国	en-US、ko-KR
コソボ	XK	en-US
クウェート	kW	en-US、ar-SA
キルギス	KG	en-US、ru-RU
ラオス	LA	en-US
ラトビア	LV	en-US、lv-LV
レバノン	LB	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
マカオ特別行政区	MO	en-US、zh-HK
マダガスカル	MG	en-US
マラウイ	MW	en-US
マレーシア	MY	en-US、ms-MY
モルディブ	MV	en-US
マリ	ML	en-US
マルタ	MT	en-US
マーシャル諸島	MH	en-US
マルティニーク	MQ	en-US
モーリタニア	MR	en-US
モーリシャス	ミュー	en-US、ar-SA
マヨット島	ユーチューブ	en-US
メキシコ	MX	en-US、es-ES
ミクロネシア	エフエム	en-US
モルドバ	医学博士	en-US、ro-RO
モナコ	MC	en-US、fr-FR
モンゴル国	ミネソタ	en-US
モンテネグロ	ME	en-US
モントセラト	マイクロソフト	en-US
モロッコ	MA	en-US、fr-FR、en-US
モザンビーク	MZ	en-US
ミャンマー	MM	en-US
ナミビア	NA	en-US
ナウル	NR	en-US
ネパール	NP	en-US
オランダ	NL	en-US、nl-NL
ニューカレドニア	NC	en-US
ニュージーランド	NZ	en-US
ニカラグア	NI	en-US、es-ES
ニジェール	NE	en-US
ナイジェリア	NG	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
パレスチナ自治政府	PS	en-US
パナマ	PA	en-US、es-ES
パプアニューギニア	PG	en-US
パラグアイ	PY	en-US、es-ES
ペルー	PE	en-US、es-ES
フィリピン	PH	en-US
ピトケアン諸島	PN	en-US
ポーランド	PL	en-US、pl-PL
ポルトガル	PT	en-US、pt-PT
プエルトリコ	広報	en-US、en-US
カタール	品質保証	en-US、ar-SA
レユニオン	RE	en-US
ルーマニア	RO	en-US、ro-RO
ロシア	RU	en-US、ru-RU
ルワンダ	RW	en-US、fr-FR
サントメ・プリンシペ	ST	en-US、fr-FR
サバ島	XS	en-US
サン・バルテルミー	BL	en-US
セントキッツとネイビス	KN	en-US
セントルシア	LC	en-US、en-US
セント・マルタン	MF	en-US、en-US
サンピエール島とミクロン島	PM	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
シンガポール	SG	en-US、zh-SG
シント・ユースタティウス島	XE	en-US
シント・マールテン島	SX	en-US、en-US
スロバキア	SK	en-US、sk-SK
スロベニア	国際単位系	en-US、sl-SI
ソロモン諸島	SB	en-US
ソマリア	SO	en-US
南アフリカ	ZA	en-US
サウスジョージアとサウスサンドイッチ諸島	GS	en-US
南スーダン	SS	en-US
スペイン	ES	en-US、 es-ES、 en-US、 en-US
スリランカ	LK	en-US
St Helena、Ascension、Tristan da Cunha	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
ティモール・レステ	TL	en-US
トーゴ	TG	en-US
トケラウ	TK	en-US
トンガ	TO	en-US
トリニダード・トバゴ	TT	en-US
チュニジア	テネシー	en-US、fr-FR、en-US
トルコ	TR	en-US、tr-TR
トルクメニスタン	TM	en-US
タークス・カイコス諸島	TC	en-US
ツバル	テレビ	en-US
米国領離島	えーと	en-US
米領バージン諸島	VI	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
イエメン	YE	en-US、ar-SA
ザンビア	ZM（ズーム）	en-US
ジンバブエ	ZW	en-US

次の方法で共有

Microsoft 顧客契約テンプレートのダウンロードリンクを取得する

前提条件

.NET

REST 要求

要求構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

REST 応答

応答の成功とエラーコード

応答の例

サポートされている国/地域と言語の一覧

フィードバック

その他のリソース

次の方法で共有

Microsoft 顧客契約テンプレートのダウンロード リンクを取得する

前提 条件

.NET

REST 要求

要求構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

REST 応答

応答の成功とエラー コード

応答の例

サポートされている国/地域と言語の一覧

フィードバック

その他のリソース

Microsoft 顧客契約テンプレートのダウンロードリンクを取得する

前提条件

応答の成功とエラーコード