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.

Limitaciones

  • 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.

Campos admitidos

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