Graph API 版本

Canvas Product Set

閱讀中

A product set inside the canvas

由 2021 年 9 月 14 日起，若應用程式在欠缺端點所需權限的情況下發出 12.0 版及以上版本的呼叫，以下欄位將會擲回錯誤。此變更由 2021 年 12 月 13 日起套用於所有版本。

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` AdCreativeLinkDataImageOverlaySpec	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

錯誤	說明
368	The action attempted has been deemed abusive or is otherwise disallowed
80001	There 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.
100	Invalid 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