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

적용 대상: 파트너 센터

비적용 대상: 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

AgreementDocument 리소스는 현재 파트너 센터에서 Microsoft 퍼블릭 클라우드에서만 지원됩니다.

이 문서에서는 고객의 국가/지역 및 언어에 따라 Microsoft 고객 계약 템플릿을 다운로드하는 링크를 가져오는 방법을 설명합니다.

필수 조건

• 파트너 센터 .NET SDK를 사용하는 경우 버전 1.14 이상이 필요합니다.

  Important

  2023년 6월 현재 최신 파트너 센터 .NET SDK 릴리스 3.4.0이 보관됩니다. 유용한 정보가 포함된 추가 정보 파일과 함께 GitHub에서 SDK 릴리스를 다운로드할 수 있습니다.

  파트너는 파트너 센터 REST API를 계속 사용하는 것이 좋습니다.

• 자격 증명(파트너 센터 인증에서 설명). 이 시나리오에서는 앱 + 사용자 인증만 지원합니다.

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

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 고객 계약 templateId
   • Microsoft 고객 계약 템플릿이 적용되는 국가/지역
   • Microsoft 고객 계약 템플릿을 지역화해야 하는 언어

요청 구문

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

URI 매개 변수

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

요청 헤더

자세한 내용은 파트너 센터 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"
}

지원되는 국가/지역 및 언어 목록