Поделиться через


Управление существующими частными предложениями с помощью API

Api можно использовать для удаления или отзыва существующих частных предложений.

Удаление существующего частного предложения

Используйте этот метод, чтобы удалить существующее частное предложение, пока он еще находится в состоянии черновика. Необходимо использовать идентификатор частного предложения, чтобы указать, какое частное предложение нужно удалить. Для нескольких частных предложений только источник MPO может удалить частное предложение.

Запросить

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

Заголовок запроса

Верхний колонтитул Тип Описание
Авторизация Строка Обязательный. Маркер доступа Microsoft Entra в форме Bearer <token>.

Параметры запроса

$version — обязательный. Это версия схемы, которая используется в запросе.

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"
        }
    ]
}

Отклик

Ответ содержит идентификатор задания, который можно использовать позже для опроса состояния.

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

Коды ошибок

Код состояния HTTP Description
401 Ошибка проверки подлинности. Убедитесь, что вы используете действительный маркер доступа Microsoft Entra.
400 Проверка схемы. Убедитесь, что текст запроса соответствует правильной схеме и включает все обязательные поля.

Отзыв существующего частного предложения

Используйте этот метод для отзыва существующего частного предложения. Отмена предложения означает, что ваш клиент больше не сможет получить доступ к нему.

Примечание.

Для многопартийных частных предложений поставщик программного обеспечения может отозвать отправленное частное предложение, если партнер канала еще не опубликовал и сделал его доступным для конечного клиента. Партнер канала может отказаться только от опубликованного частного предложения, если клиент не принял его. Если частное предложение уже было доступно для клиента, чтобы принять и ISV необходимо внести изменения в него, партнер канала должен сначала отозвать частное предложение, чтобы ISV может затем отозвать и вернуть частное предложение обратно в проект состояния, чтобы внести изменения.

Необходимо использовать идентификатор частного предложения, чтобы указать, какое частное предложение вы хотите отозвать.

Запросить

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

Заголовок запроса

Верхний колонтитул Тип Описание
Авторизация Строка Обязательный. Маркер доступа Microsoft Entra в форме Bearer <token>.

Параметры запроса

$version — обязательный. Это версия схемы, которая используется в запросе.

Текст запроса (для isV)

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

Текст запроса (для партнера канала)

{
    "$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

Ответ содержит идентификатор задания, который можно использовать позже для опроса состояния.

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

Коды ошибок

Код состояния HTTP Description
401 Ошибка проверки подлинности. Убедитесь, что вы используете действительный маркер доступа Microsoft Entra.
400 Проверка схемы. Убедитесь, что текст запроса соответствует правильной схеме и включает все обязательные поля.