Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
custombatch est une méthode courante qui vous permet de regrouper plusieurs appels d'API, ou "entrées", dans une seule requête HTTP. Chaque entrée ne fait référence qu'à un seul appel de méthode.
Nous vous recommandons d'utiliser cette méthode si:
vous venez de commencer à utiliser l'API et que vous avez de nombreuses données produit à importer ;
vous devez synchroniser les données locales avec le serveur en envoyant de nombreuses mises à jour et suppressions.
Envoyer des requêtes par lot
Envoyer des requêtes par lot revient à envoyer plusieurs appels d'API parallèlement. Notez qu'il n'y a aucune garantie que les entrées soient exécutées dans l'ordre défini dans la requête. Nous vous recommandons de ne pas émettre d'appels interdépendants dans une seule requête par lot (par exemple, créer et mettre à jour une même livraison).
De même, il est possible que vous receviez les réponses à vos requêtes par lot dans un ordre différent de celui dans lequel vous avez envoyé les entrées. Vous pouvez utiliser BatchId pour corréler les requêtes et les réponses, car les réponses peuvent être renvoyées dans le désordre.
Vous pouvez envoyer des requêtes groupées dans l'API en appelant la méthode custombatch appropriée:
Ressources et méthodes custombatch correspondantes
Pour éviter les erreurs lors de l'importation de lots volumineux, nous vous recommandons de limiter la taille des requêtes custombatch à 1 000 entrées maximum. Les valeurs maximales suivantes s'appliquent aux requêtes custombatch:
50 000 entrées par requête custombatch
Taille de transfert de 32 Mo
Les appels qui dépassent les valeurs maximales génèrent les erreurs request_too_large suivantes:
"Too many requests in a batch."
"Request payload size exceeds the limit: %d bytes."
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/06/19 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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"]]
