Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
custombatch es un método común que te permite agrupar varias llamadas a la API, conocidas como "entradas", en una sola solicitud HTTP. Cada entrada solo hace referencia a una sola llamada de método.
El procesamiento por lotes personalizado es una buena opción en los siguientes casos:
Recién empiezas a usar la API y tienes muchos datos de productos para subir.
Debes sincronizar los datos locales con el servidor y, para ello, debes enviar muchas actualizaciones y eliminaciones.
Realiza solicitudes por lotes
Enviar solicitudes por lotes es similar a enviar llamadas a la API en paralelo. Ten en cuenta que no se garantiza que el orden de las entradas definidas en la solicitud sea el orden en que se ejecutan. Te recomendamos que no uses llamadas interdependientes en una sola solicitud por lotes (como crear y actualizar el mismo envío).
De manera similar, las respuestas recibidas para las solicitudes por lotes pueden mostrarse en un orden diferente al de las entradas de la solicitud. Se puede usar BatchId para correlacionar solicitudes y respuestas, ya que las respuestas pueden mostrarse fuera de secuencia.
Para realizar solicitudes por lotes en la API, llama al método custombatch correspondiente:
Recursos y sus métodos por lotes personalizados correspondientes
Para evitar errores cuando subas lotes grandes, te recomendamos limitar el tamaño de las solicitudes de custombatch a un máximo de 1,000 entradas. Se aplican los siguientes máximos a las solicitudes custombatch:
50,000 entradas por solicitud custombatch
Tamaño de transferencia de 32 MB
Las llamadas que superan los valores máximos generan los siguientes errores request_too_large:
"Too many requests in a batch."
"Request payload size exceeds the limit: %d bytes."
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-06-19 (UTC)"],[[["The Merchant API is the new version of the Content API for Shopping and is now in beta."],["Use the `custombatch` method to group several API calls into a single HTTP request for efficiency, especially for initial data uploads and synchronization."],["Batch requests have a limit of 50,000 entries and 32Mb transfer size; exceeding these limits will result in errors."],["There's no guarantee that batched requests will be executed or returned in the order they were defined; use `BatchId` to correlate requests and responses."],["For more details and to learn how the Merchant API can improve your integration, visit the announcement blog post."]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. It uses `custombatch`, a method to group multiple API calls into a single HTTP request for efficient data uploading and synchronization. `Custombatch` suits large data transfers but doesn't guarantee execution order. `BatchId` correlates requests and responses. Batches can have top-level or entry-specific errors. There is a recommended limit of 1,000 entries per batch with maximum limits of 50,000 entries, and 32Mb size.\n"]]
