컨테이너에 대한 제품 수집 API

아티클
06/14/2024

제품 수집 API는 모든 상업용 Marketplace 제품에서 모든 기존 제출 API를 통합하는 현대화된 API입니다. 시작하는 방법에 대한 자세한 내용은 제품 수집 API를 참조하세요.

이 문서에서는 컨테이너에 특별히 API를 사용하는 방법에 대한 지침을 제공합니다.

기존 리소스 구성 검색

단일 API 호출에서 특정 제품 내의 모든 리소스를 검색합니다.

GET resource-tree/<product-durableID>?$version=<schema-version>

제품의 지속성 ID와 함께 "리소스 트리" 리소스 유형을 사용하여 특정 제품 내의 모든 리소스 구성을 검색할 수 있습니다. 제공하는 스키마 버전은 요청된 제품의 적용 가능한 각 리소스에 대해 지원되는 최대 버전으로 사용됩니다.

참고 항목

제품의 지속성 ID를 모르는 경우 제품의 외부 ID를 대신 사용하고 실행하여 먼저 제품 리소스를 검색할 수 있습니다. 자세한 내용은 Product API: 메서드 1: 리소스 트리를 참조하세요.

샘플 GET 호출:

GET https://graph.microsoft.com/rp/product-ingestion/resource-tree/product/12345678-abcd-efgh-1234-12345678901?targetType=" preview"&$version=2022-03-01-preview5

샘플 응답:

{
  "$schema": "https://schema.mp.microsoft.com/schema/resource-tree/2022-03-01-preview2",
  "root": "product/12345678-abcd-efgh-1234-12345678901",
  "target": {
    "targetType": "preview"
  },
  "resources": [
  { 
    "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3",
    "id": "product/12345678-abcd-efgh-1234-12345678901",
    "identity": {
      "externalID": "product_external_id_example"
    },
    "type": "azureContainer",
    "alias": "product_example"
  },
  { 
    "$schema": "https://schema.mp.microsoft.com/schema/commercial-marketplace-setup/2022-03-01-preview2",
    "id": "commercial-marketplace-setup/12345678-abcd-efgh-1234-12345678901",
    "product": "product/12345678-abcd-efgh-1234-12345678901",
    "sellThroughMicrosoft": true
  },
  {
    "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2",
    "id": "plan/12345678-abcd-efgh-1234-12345678901/98756328-04e9-55ae-9403-52b6c971a956
  ...
  }, 
     // The response would include all existing resources within this product.
  {
     ...
  }]
}

비공개 대상 그룹 동기화

라이브 제품의 경우 초안, 미리 보기 및 라이브 환경에서 개인 대상 그룹에 대한 업데이트는 게시 없이 동시에 수행할 수 있습니다. 특정 계획에서 추가하거나 제거할 대상 그룹을 지정하여 "price-and-availability-update-private-audiences" 리소스를 사용하여 개인 대상 그룹을 동기화할 수 있습니다. 이렇게 하면 초안, 미리 보기 및 라이브 환경이 동기화되어 개인 대상 그룹 값이 동일합니다. 비공개 대상 그룹을 동기화할 때 제출 리소스를 제공할 필요가 없습니다.

초안 대상 그룹을 편집하려면 "가격 및 가용성 계획" 리소스 및 "privateAudiences" 속성을 사용합니다. 미리 보기 및 라이브로 설정되는 값에 대한 일반 게시 흐름을 거쳐야 합니다.

Important

제품이 비공개 대상 그룹을 구성하는 데 여러 식별자 유형을 지원하는 경우(예: 테넌트 ID와 구독 ID 지원) 새로운 식별자 유형을 처음으로 제공할 때에는 전체 게시를 수행해야 합니다. 이 경우 개인 대상 그룹을 동기화할 수 없습니다.

비공개 대상 그룹 구성을 동기화하는 요청 샘플: