Microsoft 고객 계약 템플릿에 대한 다운로드 링크 가져오기

적용 대상: 파트너 센터

적용 안 됨: 21Vianet에서 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터

AgreementDocument 리소스는 현재 파트너 센터에서 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 고객 계약 템플릿을 다운로드하는 링크를 검색하려면 다음을 수행합니다.

1. Microsoft 고객 계약에 대한 계약 메타데이터를 검색합니다. Microsoft 고객 계약의 templateId 가져와야 합니다. 자세한 내용은 Microsoft 고객 계약대한 계약 메타데이터 가져오기를 참조하세요.

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

2. IAggregatePartner.AgreementTemplates 컬렉션을 사용합니다.

3. ById 메서드를 호출하고 Microsoft 고객 계약의 templateId 지정합니다.

4. Document 속성을 가져옵니다.

5. ByCountry 메서드를 호출하고 계약 템플릿이 적용되는 고객의 국가/지역을 지정합니다. 메서드가 지정되지 않은 경우 쿼리는 기본적으로 미국로 설정됩니다. 지원되는 국가/지역 코드 목록은 지원되는 국가/지역 및 언어목록을 참조하세요. 이 메서드는 대/소문자를 구분하는입니다.

6. ByLanguage 메서드를 호출하고 규약 템플릿을 지역화해야 하는 언어를 지정합니다. 메서드가 지정되지 않았거나 지정한 국가/지역 코드가 지정된 국가/지역에 대해 지원되지 않는 경우 쿼리는 기본적으로 en-US. 지원되는 언어 코드 목록은 지원되는 국가/지역 및 언어 목록을 참조하세요.

7. 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 고객 계약 템플릿을 다운로드하는 링크를 검색하려면 다음을 수행합니다.

1. Microsoft 고객 계약에 대한 계약 메타데이터를 검색합니다. Microsoft 고객 계약의 templateId 가져와야 합니다. 자세한 내용은 Microsoft 고객 계약대한 계약 메타데이터 가져오기를 참조하세요.

2. AgreementDocument 리소스가져오는 REST 요청을 만듭니다. 예제는 요청 구문 예제를 참조하세요. 다음 정보를 지정해야 합니다.

   • Microsoft 고객 계약의 템플릿 ID
   • Microsoft 고객 계약 템플릿이 적용되는 국가/지역
   • Microsoft 고객 계약 템플릿을 지역화해야 하는 언어

요청 구문

이 리소스에 대해 다음 요청 구문을 사용합니다.

메서드	요청 URI
가져오기	{baseURL}/v1/agreementtemplates/{agreement-template-id}/document?language={language}&country={country} HTTP/1.1

URI 매개 변수

요청에 다음 URI 매개 변수를 사용할 수 있습니다.

이름	유형	필수	묘사
계약서 양식 ID	문자열	예	규약 유형의 고유 식별자입니다. Microsoft 고객 계약에 대한 계약 메타데이터를 검색하여 Microsoft 고객 계약에 대한 templateId를 얻을 수 있습니다. 자세한 내용은 Microsoft 고객 계약대한 계약 메타데이터 가져오기를 참조하세요. 이 매개 변수는 대/소문자를 구분하는.
나라	문자열	아니요	계약 템플릿이 적용되는 국가/지역을 나타냅니다. 매개 변수가 지정되지 않은 경우 쿼리는 기본적으로 미국로 설정됩니다. 지원되는 국가/지역 코드 목록은 지원되는 국가/지역 및 언어목록을 참조하세요.
언어	문자열	아니요	규약 템플릿을 지역화해야 하는 언어를 나타냅니다. 매개 변수가 지정되지 않았거나 지정된 국가/지역에 대해 지정된 국가/지역 코드가 지원되지 않는 경우 쿼리는 기본적으로 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 리소스 반환합니다.

리소스에는 계약 템플릿을 다운로드하는 데 사용할 수 있는 URL 문자열이 포함된 downloadUri 속성이 있습니다. 쿼리를 만들 때마다 다른 링크가 반환됩니다. 이 링크는 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
아프가니스탄	공군	en-US
알바니아	알	en-US
알제리	DZ	en-US, fr-FR, en-US
아메리칸사모아	로서	en-US
안도라	광고	en-US
앙골라	아오	en-US, pt-PT
앵귈라	AI (인공지능)	en-US
남극 대륙	AQ	en-US
앤티가 바부다	AG	en-US
아르헨티나	아칸소	en-US, es-ES
아르메니아	오전	en-US
아루바	아우	en-US
오스트레일리아	AU	en-US
오스트리아	AT	en-US, de-DE
아제르바이잔	AZ	en-US
바하마	이학 학사 (Note: This is just an example assuming 'Bachelor of Science'. Without context, it's not certain what "BS" stands for.)	en-US
바레인	BH	en-US, ar-SA
방글라데시	BD	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
브루나이	BN	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
케이맨 제도	켄터키	영어(미국), 영어(미국)
중앙 아프리카 공화국	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)	시디	en-US
콩고	컴퓨터 그래픽	en-US
쿡 제도	CK	en-US
코스타리카	CR	en-US, es-ES
크로아티아	인사관리	en-US, hr-HR
Curaçao	CW	en-US
키프로스	CY	en-US
체코어	CZ	en-US, cs-CZ
덴마크	DK	en-US, da-DK
지부티	디제이	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
에티오피아	동부 시간	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
가봉	조지아주	en-US
감비아	GM	en-US
그루지야	GE	en-US
독일	독일	en-US, de-DE
가나	GH	en-US
지브롤터	GI	en-US
그리스	GR	en-US, el-GR
그린란드	GL	en-US
그레나다	GD	en-US
과들루프	일반의사	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
홍콩 특별 행정구	홍콩	영어(미국), 중국어(홍콩)
헝가리	HU	en-US, hu-HU
아이슬란드	아이에스	en-US
인도	안에	영어(미국), 힌디어(인도)
인도네시아	아이디	en-US, id-ID
이라크	아이큐 (IQ)	en-US, ar-SA
아일랜드	인터넷 익스플로러	en-US
맨 섬	인스턴트 메시징	en-US
이스라엘	IL	en-US, he-IL
이탈리아	정보 기술	en-US, it-IT
자메이카	JM	en-US
얀 메이엔	XJ	en-US
일본	JP	en-US, ja-JP
저지	JE	en-US
요르단	조	en-US, ar-SA
카자흐스탄	KZ	en-US, kk-KZ
케냐	KE	en-US
키리바시	키	en-US
대한민국	KR	en-US, ko-KR
코소보	XK	en-US
쿠웨이트	kW	en-US, ar-SA
키르기스스탄	킬로그램	en-US, ru-RU
라오스	로스앤젤레스	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	영어(미국), 리투아니아어(리투아니아)
룩셈부르크	LU	en-US, fr-FR
마카오 특별 관리 지역	미주리	영어(미국), 중국어(홍콩)
마다가스카르	MG	en-US
말라위	MW	en-US
말레이시아	제	en-US, ms-MY
몰디브	뮤직 비디오	en-US
말리	머신러닝	en-US
몰타	MT	en-US
마셜 제도	MH	en-US
마르티니크	MQ	en-US
모리타니	씨	en-US
모리셔스	뮤	en-US, ar-SA
마요트	유튜브	en-US
멕시코	MX	en-US, es-ES
미크로네시아	FM	en-US
몰도바	메릴랜드	en-US, ro-RO
모나코	엠씨	en-US, fr-FR
몽골	미네소타	en-US
몬테네그로	저	en-US
몬트세랫	MS	en-US
모로코	엄마	en-US, fr-FR, en-US
모잠비크	MZ	en-US
미얀마	밀리미터	en-US
나미비아	NA	en-US
나우루	NR	en-US
네팔어	NP (추가 설명 필요 시 한국어 번역)	en-US
네덜란드	네덜란드	en-US, nl-NL
누벨칼레도니	노스캐롤라이나	en-US
뉴질랜드	뉴질랜드	en-US
니카라과	NI	en-US, es-ES
니제르	NE	en-US
나이지리아	NG	en-US
니우에	뉴	en-US
노퍽 섬	NF	en-US
북마리아나 제도	MP	en-US
북 마케도니아	MK	en-US
노르웨이	아니요	en-US, nb-NO
오만	옴	en-US, ar-SA
파키스탄	PK	en-US
팔라우	PW	en-US
팔레스타인 자치 당국	PS	en-US
파나마	PA	en-US, es-ES
파푸아뉴기니	PG	en-US
파라과이	PY	en-US, es-ES
페루	체육	en-US, es-ES
필리핀	PH	en-US
핏케언 제도	PN	en-US
폴란드	PL	en-US, pl-PL
포르투갈	PT	en-US, pt-PT
푸에르토리코	홍보	영어(미국), 영어(미국)
카타르	품질 보증	en-US, ar-SA
레위니옹 주	답장	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
Saint-Barthélemy	BL (보이즈 러브)	en-US
세인트 키츠 네비스	KN	en-US
세인트루시아	LC	영어(미국), 영어(미국)
세인트 마틴	MF	영어(미국), 영어(미국)
생 피에르 미켈론	오후 시간	en-US
세인트 빈센트 그레나딘	벤처 캐피털	en-US
사모아	WS	en-US
산마리노	SM	en-US
사우디아라비아	SA	en-US
세네갈	SN	en-US, fr-FR
세르비아	RS	en-US, sr-Latn-RS, en-US
세이셸	사우스 캐롤라이나	en-US
시에라리온	SL	en-US
싱가포르	SG	en-US, zh-SG
신트 유스타티우스	XE	en-US
신트 마틴	SX	영어(미국), 영어(미국)
슬로바키아	SK	en-US, sk-SK
슬로베니아	국제단위계	en-US, sl-SI
솔로몬 제도	SB	en-US
소말리아	그래서	en-US
남아프리카 공화국	ZA	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
스위스	채널	en-US, fr-FR, en-US, en-US
대만	TW	영어(미국), 중국어(홍콩)
타지키스탄	TJ	en-US
탄자니아	TZ	en-US
태국	목	en-US, th-TH
Timor-Leste	TL (압축 번역)	en-US
토고	TG	en-US
토켈라우	TK	en-US
통가	받는 사람	en-US
트리니다드 토바고	TT	en-US
튀니지	테네시	en-US, fr-FR, en-US
튀르키예	TR	en-US, tr-TR
투르크메니스탄	TM	en-US
터크스 케이커스 제도	TC	en-US
투발루	텔레비전	en-US
미국 외딴 섬	유엠 (UM)	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
바티칸 시국	버지니아	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