Версия API Graph

Canvas Product Set

Чтение

A product set inside the canvas

С 14 сентября 2021 года в следующих полях будут появляться ошибки для вызовов версии 12.0 и более поздних, выполненных приложениями, у которых отсутствуют необходимые разрешения конечной точки. Для всех версий это изменение вступит в силу 13 декабря 2021 г.

  • storefront_settings

Example

use FacebookAds\Api;
use FacebookAds\Http\RequestInterface;

$params = array(
  'fields' => array(
    'id',
    'name',
    'product_set_id',
  ),
);

$data = Api::instance()->call(
  '/' . <CANVAS_PRODUCT_SET_ID>,
  RequestInterface::METHOD_GET,
  $params)->getContent();
curl -G \
  --data-urlencode 'fields=[ 
    "id", 
    "name", 
    "product_set_id" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<CANVAS_PRODUCT_SET_ID>

Параметры

Эта конечная точка не содержит параметров.

Поля

ПолеОписание
id
numeric string

The id of the element

bottom_padding
numeric string

The padding below the element

element_group_key
string

The element group key to bundle multiple elements in editing

element_type
enum

The type of the element

image_overlay_spec

How to render overlays over a product item

item_description
string

A token to represent which field from the product to show in the product description

item_headline
string

A token to represent which field from the product to show in the product headline

max_products
unsigned int32

Maximum number of products to show

name
string

The name of the element

product_set_id
numeric string

The product set id which contains a subset of products within a product catalog

retailer_item_ids
list<string>

An array of items that should be shown first in the product set element. If this is not set then products will be dynamically chosen

show_in_feed
bool

A flag that products should be shown in feed unit

top_padding
numeric string

The padding above the element

Error Codes

ОшибкаОписание
368The action attempted has been deemed abusive or is otherwise disallowed
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
100Invalid parameter

Создание

Нельзя выполнить эту операцию в этой конечной точке.

Обновление

Нельзя выполнить эту операцию в этой конечной точке.

Удаление

Нельзя выполнить эту операцию в этой конечной точке.

Create a Collection Ads Product Set

To create a product set used in Collection ads from a set of products in Dynamic Ads:

curl -F 'canvas_product_set={ "bottom_padding": 8, "max_items": 50, "name": "Collection Product Set Name", "product_set_id": "PRODUCT_SET_ID", "show_in_feed": true, "item_headline": "See more at {{product.brand | titleize}}", "item_description": "{{product.price}}", "retailer_item_ids": [ "RETAILER_ID_1", "RETAILER_ID_2", "RETAILER_ID_3", "RETAILER_ID_4", ], "top_padding": 24 }' \ -F 'access_token=ACCESS_TOKEN' \ https://graph.facebook.com/VERSION/PAGE_ID/canvas_elements