IG User Available Catalogs

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

Создание

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

Чтение

GET /{ig-user-id}/available_catalogs

Получает подборку каталогов товаров в принадлежащем пользователю IG User Instagram Магазине.

Ограничения

Аккаунты авторов в Instagram не поддерживаются.
Истории, Instagram TV, видео Reels, Live и упоминания не поддерживаются.
Возвращает данные только об отдельном каталоге, поскольку Instagram Магазины ограничены только одним каталогом.
Партнерские каталоги (каталоги торговых партнеров или каталоги авторов партнерского контента) не поддерживаются.

Требования

Тип	Требование
Маркеры доступа	Пользователь
Роли в 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}/available_catalogs
  ?fields={fields}
  &access_token={access-token}

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

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

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

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

Ответ

Объект в формате JSON, содержащий запрошенные данные.

{
  "data": [
    {
      "catalog_id": "{catalog-id}",
      "catalog_name": "{catalog-name}",
      "shop_name": "{shop-name}",
      "product_count": {product-count}
    }
  ]
}

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

Свойство	Значение
`catalog_id`	ID каталога.
`catalog_name`	Название каталога.
`shop_name`	Название каталога.
`product_count`	Количество товаров в каталоге. Включает в себя все товары независимо от статуса проверки.

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

Запрос

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

Ответ

{
  "data": [
    {
      "catalog_id": "960179311066902",
      "catalog_name": "Jay's Favorite Snacks",
      "shop_name": "Jay's Bespoke",
      "product_count": 11
    }
  ]
}

Обновление

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

Удаление

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