Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
custombatch è un metodo comune che consente di raggruppare più chiamate API,
note come "entries", in un'unica richiesta HTTP. Ogni voce fa riferimento solo a una singola chiamata di metodo.
Il batch personalizzato è una buona scelta quando:
Hai appena iniziato a utilizzare l'API e hai molti dati di prodotto da caricare.
Devi sincronizzare i dati locali con il server inviando molti aggiornamenti ed eliminazioni.
Effettuare richieste batch
L'invio di richieste batch è simile all'invio di chiamate API in parallelo. Tieni presente che
non è garantito che l'ordine delle voci definito nella richiesta sia
lo stesso in cui vengono eseguite. Ti consigliamo di non utilizzare chiamate interdipendenti in una singola richiesta batch (ad esempio la creazione e l'aggiornamento della stessa spedizione).
Analogamente, le risposte ricevute per le richieste raggruppate possono essere restituite in un ordine diverso rispetto a quello delle voci di richiesta. BatchId può essere utilizzato per correlare richieste e risposte, poiché le risposte potrebbero essere restituite fuori sequenza.
Puoi raggruppare le richieste nell'API chiamando il metodo custombatch appropriato:
Per evitare errori durante il caricamento di batch di grandi dimensioni, ti consigliamo di limitare le dimensioni
delle richieste custombatch a un massimo di 1000 voci. Per le richieste custombatch si applicano i seguenti valori massimi:
50.000 voci per richiesta custombatch
Dimensioni trasferimento di 32 MB
Le chiamate che superano i valori massimi generano i seguenti errori request_too_large:
"Too many requests in a batch."
"Request payload size exceeds the limit: %d bytes."
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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"]]
