Cloud 파트너 포털 API 참조

  • 아티클

참고 항목

Cloud 파트너 포털 API는 파트너 센터와 통합되었으며, 계속 파트너 센터에서 작동합니다. 전환에는 작은 변경 내용이 도입됩니다. 이 문서에 나열된 CPP API의 변경 내용을 검토하여 파트너 센터로 전환한 후에도 코드가 계속 작동하는지 확인합니다. CPP API는 파트너 센터로 전환하기 전에 이미 통합된 기존 제품에만 사용해야 합니다. 새 제품은 파트너 센터 제출 API를 사용해야 합니다.

Cloud 파트너 포털 REST API를 사용하면 워크로드, 제품 및 게시자 프로필을 프로그래밍 방식으로 검색하고 조작할 수 있습니다. 이 API는 Azure RBAC(Azure 역할 기반 액세스 제어)를 사용하여 처리 시에 올바른 권한을 적용합니다.

이 참조는 Cloud 파트너 포털 REST API에 대한 기술 세부 정보를 제공합니다. 이 문서의 페이로드 샘플은 참조 전용이며 새 기능이 추가되면 변경될 수 있습니다.

필수 구성 요소 및 고려 사항

API를 사용하기 전에 다음을 검토해야 합니다.

  • 계정에 서비스 주체를 추가하고 인증을 위한 Microsoft Entra 액세스 토큰을 가져오는 방법을 알아보기 위한 필수 구성 요소 문서입니다.
  • 이러한 API를 호출하는 데 사용할 수 있는 두 가지 동시성 제어 전략입니다.
  • 버전 관리 및 오류 처리와 같은 기타 API 고려 사항

파트너 센터로 마이그레이션한 후 CPP API 변경

API 변경 내용 설명 영향
POST 게시, GoLive, 취소 마이그레이션된 제품의 경우 응답 헤더의 형식은 다르지만 동일한 방식으로 계속 작동하며 작업 상태 검색하기 위한 상대 경로를 표시합니다. 제품에 대한 해당 POST 요청을 보낼 때 Location 헤더는 제품의 마이그레이션 상태 따라 두 가지 형식 중 하나입니다.
  • 미이동 제안
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • 마이그레이션된 제안
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
GET 작업 응답의 ‘알림-이메일’ 필드가 이전에 지원되었던 제품 유형의 경우 이 필드는 더 이상 사용되지 않으며 마이그레이션된 제품에 대해 더 이상 반환되지 않습니다. 마이그레이션된 제품의 경우 더 이상 요청에 지정된 이메일 목록에 알림을 보내지 않습니다. 대신 API 서비스는 파트너 센터의 알림 전자 메일 프로세스와 일치하여 이메일을 보냅니다. 특히 알림은 파트너 센터에서 계정 설정의 판매자 연락처 정보 섹션에 설정된 이메일 주소로 전송되어 작업 진행 상황을 알립니다.

파트너 센터에서 계정 설정의 판매자 연락처 정보 섹션에 있는 전자 메일 주소 집합을 검토하여 알림에 올바른 전자 메일이 제공되었는지 확인합니다.

일반 작업

이 참조는 다음과 같은 일반적인 작업을 수행하기 위한 API를 자세히 설명합니다.

제품

작업

응용 프로그램 게시

다른 작업

문제 해결

API 버전 및 업데이트

업데이트 무엇이 변경되었습니까?
12-2022 이제 CPP 공용 API(버전 2017-10-31)가 고객 잠재 고객을 구성하는 동안 clientId 및 clientSecret for Marketo 커넥터를 캡처하도록 업데이트되었습니다. 잠재 고객 구성 중에는 앞으로 serverId 필드를 제공할 필요가 없습니다. API에 대한 이 업데이트에는 버전 업데이트 또는 호환성이 손상되는 변경이 포함되지 않습니다.