Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 11 nov.
Actualización del documento en Español (España): 9 abr.

Enviar actualizaciones de artículos

Para enviar actualizaciones de artículos, usa el punto de conexión /{catalog_id}/batch.

Para crear artículos en tu catálogo, actualizarlos o eliminarlos, haz una llamada HTTP POST a:

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>

Parámetros

Los nombres de parámetros de /{catalog_id}/batch y /{catalog_id}/items_batch pueden parecer similares, pero son claramente diferentes.

Te recomendamos usar la API /{catalog_id}/items_batch, que admite más casos de uso y se mantiene de manera activa.

Parámetro	Tipo	Descripción
`allow_upsert`	Booleano	Cuando `allow_upsert` sea `false`, no se completarán las solicitudes de actualización para artículos que no existan en el catálogo. De lo contrario, se crearán nuevos artículos.
`requests`	Objeto	Objeto JSON que contiene todas las solicitudes.
`requests.data`	Objeto	Un objeto JSON que contiene campos y valores de un artículo. Cuando el método es `CREATE`, este objeto debe contener todos los campos obligatorios. Cuando el método es `UPDATE`, puede contener cualquier campo. Nota: Consulta los campos admitidos que se pueden pasar.
`requests.method`	Cadena	`CREATE`, `UPDATE` y `DELETE`
`requests.retailer_id`	Cadena	El `id` de un artículo suministrado por el anunciante; no el FBID.

El método UPDATE también se puede usar para crear artículos, si todavía no existen.

Para obtener más información, consulta Referencia de la API.

El parámetro requests puede contener hasta 5.000 actualizaciones.
En cada catálogo, puedes realizar una cantidad de llamadas por hora definida según la fórmula de limitación de frecuencia relativa a este caso de uso del negocio: lote de catálogos. Si eso no es suficiente, contáctanos.
El límite de tamaño de lote es de 5.000.
El código de error 1 con el mensaje "Please reduce the amount of data you're asking for, then retry your request" indica que el tamaño de los datos (en bytes) que se recibe en la solicitud a la API es demasiado grande. Para solucionar este problema, reduce el número de elementos del lote y vuelve a intentarlo. De esta manera, te asegurarás de que la solicitud esté dentro de los límites aceptables y se pueda procesar correctamente.

Consulta la lista de campos admitidos del punto de conexión /{catalog_id}/batch.