다음을 통해 공유

고객의 자격을 비동기적으로 업데이트

고객의 자격을 비동기적으로 업데이트합니다.

파트너는 고객의 자격을 비동기적으로 "교육", "GovernmentCommunityCloud" 또는 "StateOwnedEntity"로 업데이트할 수 있습니다. "None" 및 "Nonprofit"과 같은 다른 값은 설정할 수 없습니다.

필수 구성 요소

  • 파트너 센터 인증설명된 대로 자격 증명. 이 시나리오에서는 App+User 자격 증명으로만 인증을 지원합니다.

  • 고객 ID(customer-tenant-id)입니다. 고객의 ID를 모르는 경우, 파트너 센터에서 고객 작업 영역을 선택하고, 고객 목록에서 고객을 선택한 다음, 계정을 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션을 확인하고 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

  • GCC(Government Community Cloud) 자격의 경우에만 다음 GDAP(세분화된 위임된 관리자 권한) 역할 중 하나 이상이 필요합니다. GDAP에 대해 자세히 알아보려면 GDAP 소개부터 MS Learn 문서를 살펴보세요.

    • 디렉터리 리더
    • 디렉터리 작성기
    • 라이선스 관리자
    • 사용자 관리자

C#

"Education"에 대한 고객의 자격을 만들려면 먼저 CustomerQualificationRequest 형식 개체를 만들고 Education(선택 사항)과 함께 EducationSegment 자격 유형 및 Website지정합니다.

그런 다음 고객 식별자를 사용하여 IAggregatePartner.Customers.ById 메서드를 호출합니다.

그런 다음 Qualification 속성을 사용하여 ICustomerQualification 인터페이스를 검색합니다.

마지막으로 CreateQualifications() 형식 개체를 입력 매개 변수로 사용하여 CreateQualificationsAsync() 또는 CustomerQualificationRequest 호출합니다.

// Education
var eduRequestBody = new CustomerQualificationRequest 
{
    Qualification = "Education",
    EducationSegment = "K12", // could also be "HigherEducation"
    Website = "example.edu"
};

var eduCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(eduRequestBody);

// State Owned Entity
var soeRequestBody = new CustomerQualificationRequest 
{
    Qualification = "StateOwnedEntity"
};

var soeCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(soeRequestBody);

샘플: 콘솔 샘플 앱. 프로젝트: SdkSamples 클래스: CreateCustomerQualification.cs

자격이 없는 기존 고객에 대해 으로 정부 커뮤니티 클라우드 자격을 업데이트하려면, 파트너는 고객의 유효성 검사 코드도 포함해야 합니다.

먼저 CustomerQualificationRequest 형식 개체를 만들고 GovernmentCommunityCloud 정규화 형식 및 유효성 검사 코드를 지정합니다.

그런 다음 고객 식별자를 사용하여 IAggregatePartner.Customers.ById 메서드를 호출합니다.

그런 다음 Qualification 속성을 사용하여 ICustomerQualification 인터페이스를 검색합니다.

마지막으로 CreateQualifications() 형식 개체를 입력 매개 변수로 사용하여 CreateQualificationsAsync() 또는 CustomerQualificationRequest 호출합니다.

var gccRequestBody = new CustomerQualificationRequest 
{
    Qualification = "GovernmentCommunityCloud",
    ValidationCode = "<validation code>"
};

var gccCustomerQualification = partnerOperations.Customers.ById(existingCustomer.Id).Qualification.CreateQualifications(gccRequestBody);

샘플: 콘솔 샘플 앱. 프로젝트: SdkSamples 클래스: CreateCustomerQualificationWithGCC.cs

REST 요청

요청 구문

메서드 요청 URI
포스트 {baseURL}/v1/customers/{customer_tenant_id}/qualifications HTTP/1.1

URI 매개 변수

다음 쿼리 매개 변수를 사용하여 자격을 업데이트합니다.

이름 타입 필수 묘사
고객-테넌트 ID GUID 예 값은 재판매인에 속한 특정 고객의 결과를 필터링할 수 있도록 하는 GUID 형식의 customer-tenant-id입니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더 참조하세요.

요청 본문

이 표에서는 요청 본문의 한정 개체에 대해 설명합니다.

재산 타입 필수 설명
자격 문자열 예 CustomerQualification 열거형의 문자열 값입니다.

이 표는 교육 자격에 대한 요청 본문을 특히 설명합니다.

재산 타입 필수 묘사
자격 문자열 예 교육
교육 부문 문자열 예 K12, 상위 교육
웹 사이트 문자열 아니요 교육 엔터티에 대한 웹 사이트

교육 자격이 필요한 경우, 교육 세그먼트는 필수 필드입니다.

  • EducationSegment에 허용되는 값은 K12 및 고등 교육입니다.
  • 웹 사이트는 선택적 필드로 유지되며, 자격은 교육용인 경우에만 관련이 있습니다. 그러나 사용 가능한 경우 포함/적용 가능한 경우 포함하는 것이 좋습니다.

이 표는 특히 GovernmentCommunityCloud 자격에 대한 요청 본문을 설명합니다.

재산 타입 필수 묘사
자격 문자열 예 정부커뮤니티클라우드 (GovernmentCommunityCloud)
유효성코드 문자열 예 파트너의 GCC 유효성 검사 코드입니다. 예제 - 123456

GovernmentCommunityCloud 자격이 있는 경우 ValidationCode는 필수 항목입니다.

요청 예제

POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Accept: application/json
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

// SOE
{
    "qualification": "StateOwnedEntity"
}

// Education
{
    "qualification": "Education",
    "educationSegment": "HigherEducation", // could also be "K12"
    "website": "contoso.edu"
}

// GCC
{
    "qualification": "GovernmentCommunityCloud",
    "validationCode": "123456"
}

REST 응답

성공하면 이 메서드는 응답 본문에 한정 개체를 반환합니다. 다음은 Education 자격이 있는 고객(이전 자격 없음)에 대한 POST 전화의 예입니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 기타 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽습니다. 전체 목록은 오류 코드참조하세요.

응답 예제

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}