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

  • 아티클

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

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

필수 조건

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

  • 고객 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 만들고 자격 유형 및 EducationSegment자격 유형을 (선택 사항)와 함께 Website 지정 Education 합니다.

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

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

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

// 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

자격이 없는 기존 고객의 GovernmentCommunityCloud로 고객의 자격을 업데이트하려면 파트너도 고객의 유효성 검사 코드를 포함해야 합니다.

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

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

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

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

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

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

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

REST 요청

요청 구문

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

URI 매개 변수

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

속성 Type 필수 설명
customer-tenant-id GUID 예 이 값은 재판매인이 자신에게 속한 특정 고객에 대한 결과를 필터링할 수 있도록 하는 GUID 유형의 customer-tenant-id입니다.

요청 헤더

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

요청 본문

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

속성 형식 필수 설명
자격검증 string 예 CustomerQualification 열거형의 문자열 값입니다.

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

속성 형식 필수 설명
자격검증 string 예 Education
EducationSegment string 예 K12, 상위 교육
Website string 아니요 교육 엔터티에 대한 웹 사이트

교육 자격이 있는 경우 교육부문 은 필수 필드입니다.

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

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

속성 형식 필수 설명
자격검증 string 예 GovernmentCommunityCloud
ValidationCode string 예 파트너의 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: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
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 응답

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

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 201 CREATED
Content-Length: 29
Content-Type: application/json
MS-CorrelationId: 7d2456fd-2d79-46d0-9f8e-5d7ecd5f8745
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
{
    "qualification": "Education",
    "vettingStatus": "InReview",
    "vettingCreateDate": "2020-12-04T20:54:24Z" // UTC
}