IG User Product Appeal

Представляет статус обжалования отклонения товара. Подробную информацию об использовании см. в руководстве по меткам товаров.

Создание

POST /{ig-user-id}/product_appeal

Отправляет запрос для обжалования отклонения товара.

Ограничения

Аккаунты авторов в Instagram не поддерживаются.
Истории, Instagram TV, видео Reels, Live и упоминания не поддерживаются.

Требования

Тип	Требование
Маркеры доступа	Пользователь
Роли в Business	Пользователь приложения должен иметь роль администратора в том Business Manager, который владеет Instagram Магазином, связанным с IG User.
Instagram Магазин	Пользователь IG User должен иметь утвержденный Instagram Магазин с каталогом, в котором указаны товары.
Разрешения	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Если пользователь приложения получил роль на Странице, связанной с целевым пользователем IG User, через Business Manager, также потребуется одно из следующих разрешений: `ads_management`; `business_management`.

Синтаксис запроса

POST https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?appeal_reason={appeal-reason}
  &product_id={product-id}
  &access_token={access-token}

Параметры пути

Заполнитель	Значение
`{api-version}`	Версия API.
`{ig-user-id}`	Обязательный параметр. ID пользователя внутри приложения.

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

Ключ	Заполнитель	Значение
`access_token`	`{access-token}`	Обязательный параметр. Маркер доступа пользователя приложения.
`appeal_reason`	`{appeal-reason}`	Обязательный параметр. Пояснение причины одобрить товар.
`product_id`	`{product-id}`	Обязательный параметр. ID товара.

Ответ

Объект, обозначающий успех или отклонение. Получение ответа не означает, что решение по обжалованию вынесено.

{
  "success": {success}
}

Содержание ответа

Свойство	Значение
`success`	Указывает, API принял запрос (`true`) или не принял запрос (`false`). Получение ответа не означает, что решение по обжалованию вынесено.

Пример запроса cURL

Запрос

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/product_appeal?appeal_reason=product%20is%20a%20toy%20and%20not%20a%20real%20weapon&product_id=4382881195057752&access_token=EAAOc..."

Ответ

{
  "success": true
}

Чтение

GET /{ig-user-id}/product_appeal

Получает статус обжалования для отклоненного товара.

Ограничения

Аккаунты авторов в Instagram не поддерживаются.
Истории, Instagram TV, видео Reels, Live и упоминания не поддерживаются.

Требования

Тип	Требование
Маркеры доступа	Пользователь
Роли в Business	Пользователь приложения должен иметь роль администратора в том Business Manager, который владеет Instagram Магазином, связанным с IG User.
Instagram Магазин	Пользователь IG User должен иметь утвержденный Instagram Магазин с каталогом, в котором указаны товары.
Разрешения	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` Если пользователь приложения получил роль на Странице, связанной с целевым пользователем IG User, через Business Manager, также потребуется одно из следующих разрешений: `ads_management`; `business_management`.

Синтаксис запроса

GET https://graph.facebook.com/{api-version}/{ig-user-id}/product_appeal
  ?product_id={product-id}
  &access_token={access-token}

Параметры пути

Заполнитель	Значение
`{api-version}`	Версия API.
`{ig-user-id}`	Обязательный параметр. ID пользователя внутри приложения.

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

Ключ	Заполнитель	Значение
`access_token`	`{access-token}`	Обязательный параметр. Маркер доступа пользователя приложения.
`product_id`	`{product-id}`	Обязательный параметр. ID товара.

Ответ

Объект в формате JSON, содержащий массив метаданных статуса обжалования.

{
  "data": [
    {
      "eligible_for_appeal": {eligible-for-appeal},
      "product_id": {product-id},
      "review_status": "{review-status}"
    }
  ]
}

Содержание ответа

Свойство Значение

Свойство	Значение
`eligible_for_appeal`	Указывает, можно ли обжаловать решение (да, если значение `true`, и нет, если значение `false`).
`product_id`	ID товара.
`review_status`	Статус проверки. Возможные значения: `approved` — товар одобрен; `rejected` — товар отклонен; `pending` — на рассмотрении; `outdated` — товар одобрен, но в него были внесены изменения, и требуется повторная проверка; `""` — нет статуса проверки; `no_review` — нет статуса проверки.

eligible_for_appeal

Указывает, можно ли обжаловать решение (да, если значение true, и нет, если значение false).

product_id

ID товара.

review_status

Статус проверки. Возможные значения:

approved — товар одобрен;
rejected — товар отклонен;
pending — на рассмотрении;
outdated — товар одобрен, но в него были внесены изменения, и требуется повторная проверка;
"" — нет статуса проверки;
no_review — нет статуса проверки.

Пример запроса cURL

Запрос

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/product_appeal?product_id=4029274203846188&access_token=EAAOc..."

Ответ

{
  "data": [
    {
      "product_id": 4029274203846188,
      "review_status": "approved",
      "eligible_for_appeal": false
    }
  ]
}

Обновление

Эта операция не поддерживается.

Удаление

Эта операция не поддерживается.