Tenez compte de ces consignes lorsque vous utilisez BatchJobService
.
Améliorer le débit
Il est préférable d'avoir moins de tâches plus importantes plutôt qu'un nombre de tâches plus petites.
Classez les opérations importées par type d'opération. Par exemple, si votre tâche contient des opérations visant à ajouter des campagnes, des groupes d'annonces et des critères de groupe d'annonces, ordonnez les opérations de votre importation de sorte que toutes les opérations de campagne apparaissent en premier, suivies de toutes les opérations sur les groupes d'annonces, et enfin de toutes les opérations liées aux critères des groupes d'annonces.
Dans les opérations du même type, le regroupement par ressource parente peut améliorer les performances. Par exemple, si vous disposez d'une série d'objets
AdGroupCriterionOperation
, il peut être plus efficace de regrouper les opérations par groupe d'annonces que de combiner des opérations qui affectent les critères de groupe d'annonces dans différents groupes d'annonces.
Éviter les problèmes de simultanéité
Lorsque vous soumettez plusieurs tâches simultanées pour le même compte, essayez de réduire la probabilité que des tâches s'exécutent sur les mêmes objets en même temps, tout en conservant des tâches de grande taille. De nombreux jobs non terminés (dont l'état est
RUNNING
) qui tentent de modifier le même ensemble d'objets peuvent entraîner des problèmes d'interblocage, ce qui peut entraîner un important ralentissement et même des échecs de tâche.N'envoyez pas plusieurs opérations qui modifient le même objet dans la même tâche, car le résultat peut être imprévisible.
Récupérer les résultats de manière optimale
N'interrogez pas l'état du job trop fréquemment, au risque d'atteindre des erreurs de limite de débit.
Ne récupérez pas plus de 1 000 résultats par page. Le serveur peut renvoyer moins d'erreurs en raison de la charge ou d'autres facteurs.
L'ordre des résultats sera le même que celui de l'importation.
Conseils d'utilisation supplémentaires
Vous pouvez définir la durée maximale d'exécution d'un job par lot avant son annulation. Lorsque vous créez une tâche par lot, définissez le champ
metadata.execution_limit_seconds
sur la limite de temps souhaitée, en secondes. Il n'y a pas de limite de temps par défaut simetadata.execution_limit_seconds
n'est pas défini.Il est recommandé de ne pas ajouter plus de 1 000 opérations par
AddBatchJobOperationsRequest
et d'utilisersequence_token
pour importer le reste des opérations dans la même tâche. Selon le contenu des opérations, un trop grand nombre d'opérations dans une seuleAddBatchJobOperationsRequest
peut entraîner une erreurREQUEST_TOO_LARGE
. Vous pouvez gérer cette erreur en réduisant le nombre d'opérations et en réessayantAddBatchJobOperationsRequest
.
Limites
Chaque
BatchJob
accepte jusqu'à un million d'opérations.Chaque compte peut comporter jusqu'à 100 tâches actives ou en attente à la fois.
Les jobs en attente datant de plus de sept jours sont automatiquement supprimés.
Chaque
AddBatchJobOperationsRequest
a une taille maximale de 10 484 504 octets. Si vous dépassez cette limite, vous recevrez uneINTERNAL_ERROR
. Vous pouvez déterminer la taille de la requête avant de l'envoyer et prendre les mesures appropriées si elle est trop volumineuse.Java
static final int MAX_REQUEST_BYTES = 10_484_504; ... (code to get the request object) int sizeInBytes = request.getSerializedSize();
Python
from google.ads.googleads.client import GoogleAdsClient MAX_REQUEST_BYTES = 10484504 ... (code to get the request object) size_in_bytes = request._pb.ByteSize()
Ruby
require 'google/ads/google_ads' MAX_REQUEST_BYTES = 10484504 ... (code to get the request object) size_in_bytes = request.to_proto.bytesize
PHP
use Google\Ads\GoogleAds\V16\Resources\Campaign; const MAX_REQUEST_BYTES = 10484504; ... (code to get the request object) $size_in_bytes = $campaign->byteSize() . PHP_EOL;
.NET
using Google.Protobuf; const int MAX_REQUEST_BYTES = 10484504; ... (code to get the request object) int sizeInBytes = request.ToByteArray().Length;
Perl
use Devel::Size qw(total_size); use constant MAX_REQUEST_BYTES => 10484504; ... (code to get the request object) my $size_in_bytes = total_size($request);