Udostępnij za pośrednictwem

Zarządzanie istniejącymi ofertami prywatnymi za pośrednictwem interfejsu API

  • Artykuł

Za pomocą interfejsów API można usuwać lub wycofywać istniejące oferty prywatne.

Usuwanie istniejącej oferty prywatnej

Użyj tej metody, aby usunąć istniejącą ofertę prywatną, gdy jest ona nadal w wersji roboczej. Musisz użyć prywatnego identyfikatora oferty, aby określić, która oferta prywatna ma zostać usunięta. W przypadku ofert prywatnych z wieloma częściami tylko inicjator MPO może usunąć ofertę prywatną.

Żądanie

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

Nagłówek żądania

Nagłówek Type Opis
Autoryzacja String Wymagany. Token dostępu firmy Microsoft Entra w postaci Bearer <token>.

Parametry żądania

$version — wymagane. Jest to wersja schematu używanego w żądaniu.

Request body

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
        {
        "$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705",
        "privateOfferType": "multipartyPromotionOriginator",
        "state": "deleted"
        }
    ]
}

Response

Odpowiedź zawiera identyfikator jobId, którego można użyć później do sondowania stanu.

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
    "jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
    "jobStatus": "notStarted",
    "jobResult": "pending",
    "jobStart": "2021-12-21T21:29:54.9702903Z",
    "jobEnd": "0001-01-01",
    "errors": []
}

Kody błędów

Kod stanu HTTP opis
401 Błąd uwierzytelniania: Upewnij się, że używasz prawidłowego tokenu dostępu firmy Microsoft Entra.
400 Weryfikacja schematu. Upewnij się, że treść żądania jest zgodna z prawidłowym schematem i zawiera wszystkie wymagane pola.

Wycofanie istniejącej oferty prywatnej

Użyj tej metody, aby wycofać istniejącą ofertę prywatną. Wycofanie oferty oznacza, że klient nie będzie już mógł uzyskać do niej dostępu.

Uwaga

W przypadku ofert prywatnych wielopartyjnych niezależnego dostawcy oprogramowania mogą wycofać przesłaną ofertę prywatną, jeśli partner kanału nie opublikował go i udostępnił go jeszcze klientowi końcowemu. Partner kanału może wycofać opublikowaną prywatną ofertę tylko wtedy, gdy klient go nie zaakceptował. Jeśli oferta prywatna została już udostępniona dla klienta do zaakceptowania, a niezależnego dostawcy oprogramowania musi wprowadzić w nim zmiany, partner kanału musi najpierw wycofać ofertę prywatną, aby niezależne dostawcy oprogramowania mógł następnie wycofać i przywrócić prywatną ofertę z powrotem do stanu roboczego, aby dokonać edycji.

Musisz użyć prywatnego identyfikatora oferty, aby określić, która oferta prywatna ma zostać wycofana.

Żądanie

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

Nagłówek żądania

Nagłówek Type Opis
Autoryzacja String Wymagany. Token dostępu firmy Microsoft Entra w postaci Bearer <token>.

Parametry żądania

$version — wymagane. Jest to wersja schematu używanego w żądaniu.

Treść żądania (dla niezależnego dostawcy oprogramowania)

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
         {
        "$schema": "https://schema.mp.microsoft.com/schema/private-offer/ 2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705", 
        "privateOfferType": "multipartyPromotionOriginator",
        "state": "withdrawn"
        }
    ]
}

Treść żądania (dla partnera kanału)

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
     "resources": [
         {
        $schema": "https://schema.mp.microsoft.com/schema/private-offer/ 2023-07-15",
        "id": "private-offer/456e-a345-c457-1234",
        "name": "privateOffercustomer1705", 
        "privateOfferType": "multiPartyPromotionChannelPartner",
        "state": "withdrawn"
        }
    ]
}

Response

Odpowiedź zawiera identyfikator jobId, którego można później użyć do sondowania stanu.

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
    "jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
    "jobStatus": "notStarted",
    "jobResult": "pending",
    "jobStart": "2021-12-21T21:29:54.9702903Z",
    "jobEnd": "0001-01-01",
    "errors": []
}

Kody błędów

Kod stanu HTTP opis
401 Błąd uwierzytelniania: Upewnij się, że używasz prawidłowego tokenu dostępu firmy Microsoft Entra.
400 Weryfikacja schematu. Upewnij się, że treść żądania jest zgodna z prawidłowym schematem i zawiera wszystkie wymagane pola.

Powiązana zawartość