Interfejs API importowania produktów dla kontenerów

2025-04-29

Interfejs API pozyskiwania produktów to zmodernizowany interfejs API, który łączy wszystkie istniejące interfejsy API przesyłania we wszystkich produktach platformy handlowej. Aby uzyskać szczegółowe informacje na temat rozpoczęcia pracy, zapoznaj się z interfejsem API pozyskiwania produktów.

Ten artykuł zawiera wskazówki dotyczące używania interfejsów API przeznaczonych specjalnie dla kontenerów.

Pobieranie istniejących konfiguracji zasobów

Pobierz wszystkie zasoby w ramach określonego produktu w jednym wywołaniu interfejsu API.

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

Wszystkie konfiguracje zasobów w określonym produkcie można pobrać przy użyciu typu zasobu "drzewo zasobów" wraz z trwałym identyfikatorem produktu. Udostępniana wersja schematu jest używana jako maksymalna obsługiwana wersja dla każdego z odpowiednich zasobów żądanego produktu.

Notatka

Jeśli nie znasz trwałego identyfikatora produktu, możesz najpierw pobrać zasób produktu przy użyciu identyfikatora zewnętrznego produktu i uruchomić go. Aby dowiedzieć się więcej, zobacz interfejs API produktu : Metoda 1: drzewo zasobów.

przykładowe wywołanie GET:

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

przykładowa odpowiedź

{
  "$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.
  {
     ...
  }]
}

Synchronizowanie prywatnych odbiorców

W przypadku produktu na żywo aktualizacje dla prywatnych odbiorców w wersji roboczej, wersji zapoznawczej i środowiskach na żywo mogą być wykonywane jednocześnie bez konieczności publikowania. Możesz zsynchronizować odbiorców prywatnych przy użyciu zasobu "price-and-availability-update-private-audiences", określając odbiorców, które chcesz dodać lub usunąć z określonego planu. Spowoduje to zsynchronizowanie wersji roboczej, wersji zapoznawczej i środowisk na żywo, aby mieć te same prywatne wartości odbiorców. Nie musisz podawać zasobu przesyłania podczas synchronizowania prywatnej grupy docelowej.

Aby edytować grupy odbiorców wersji roboczych, użyj zasobu "price-and-availability-plan" i właściwości "privateAudiences". Konieczne będzie przejście przez standardowy proces publikacji, aby wartości zostały ustawione w trybie podglądu i na żywo.

Ważny

Jeśli produkt obsługuje więcej niż jeden typ identyfikatora do skonfigurowania prywatnych odbiorców (na przykład zarówno identyfikatory dzierżawy, jak i identyfikatory subskrypcji), należy wykonać pełną publikację, jeśli po raz pierwszy podaje się nowy typ identyfikatora. W tym przypadku nie można zsynchronizować odbiorców prywatnych.

przykładowe żądanie synchronizacji konfiguracji odbiorców prywatnych: