To send item updates, use the /{catalog_id}/batch
endpoint.
To create, update, or delete items in your catalog, make an HTTP POST
call to:
https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>
The parameter names for /{catalog_id}/batch and /{catalog_id}/items_batch may appear to be similar, but they are distinctly different.
Parameter | Type | Description |
---|---|---|
| boolean | When |
| object | A JSON object containing all requests. |
| object | A JSON object containing fields and values for an item.
|
| string |
|
| string | The advertiser-supplied |
The UPDATE
method can also be used to create items if they don't already exist.
For more details, see the API reference.
requests
param can contain up to 5,000 updates.See the list of supported fields for the /{catalog_id}/batch
endpoint.
You can use the applink
field to specify deep link information; it works in a similar way to Deep Links. Provide your deep link information in the JSON format shown below.
"applink" : {"ios": [{"url":"example-ios://electronic","app_store_id":42,"app_name":"Electronic Example iOS"}],"iphone": [{"url":"example-iphone://electronic","app_store_id":43,"app_name":"Electronic Example iPhone"}],"ipad": [{"url":"example-ipad://electronic","app_store_id":44,"app_name":"Electronic Example iPad"}],"android": [{"url":"example-android://electronic","package":"com.electronic","class":"com.electronic.Example","app_name":"Electronic Example Android",}],"windows_phone": [{"url":"example-windows://electronic","app_id":"64ec0d1b-5b3b-4c77-a86b-5e12d465edc0","app_name":"Electronic Example Windows"}]}
There's a minor difference in the field names compared to the ones in Deep Links as each app type is a separate node and is enclosed in their respective fields.
'data\[applink\]\[android\]'
is an array with only one value specified under it. This is the same case for other app types.
We don't support iOS Universal Links.
/{catalog_id}/items_batch
/{catalog_id}/check_batch_request_status
/{catalog_id}/localized_items_batch