Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les scripts Google Ads s'exécutent au mieux de leurs capacités. Ils tentent de modifier les données Google Ads, mais si une modification échoue, le script l'enregistre dans le journal des modifications et poursuit l'exécution :
// Attempt an invalid change.letamount=999999999999;campaign.getBudget().setAmount(amount);// Error is logged into Changes log, but the script keeps running.// Suppose we must know whether the change actually happened.if(campaign.getBudget()!=amount){// The current value of budget is not the one we expected.// The change must have failed.}
Voici quelques exemples d'opérations qui génèrent des erreurs similaires :
Définir une enchère de mot clé supérieure au budget de la campagne
Vous avez attribué à votre campagne un nom qui existe déjà.
Créer un groupe d'annonces dans une campagne qui a déjà atteint son quota de groupes d'annonces.
Toutefois, certaines erreurs ne peuvent pas être ignorées. Voici un exemple :
Avec ce code, le script ne peut pas produire d'itérateur keywords pertinent, car la plage de dates n'est pas spécifiée. L'exécution du script s'arrête alors et un message d'erreur est consigné dans les journaux de texte.
Des avertissements sont consignés par le script si les quotas sont dépassés. L'exécution du script se poursuivra, mais vous devez toujours examiner les avertissements.
Dans les journaux d'exécution, les erreurs sont en rouge et les avertissements en orange. Vous pouvez également générer des messages personnalisés dans ces journaux à des fins de dépannage et de surveillance.
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/09/05 (UTC).
[null,null,["Dernière mise à jour le 2025/09/05 (UTC)."],[[["\u003cp\u003eGoogle Ads scripts will log errors when changes fail but continue running, allowing you to check if a change was successful and handle it accordingly.\u003c/p\u003e\n"],["\u003cp\u003eCertain errors, such as missing required parameters, will halt script execution and require fixing before the script can run.\u003c/p\u003e\n"],["\u003cp\u003eWhile scripts proceed even when exceeding quotas, warnings are logged and should be reviewed.\u003c/p\u003e\n"],["\u003cp\u003eScript execution logs provide valuable information through errors (red), warnings (orange), and custom messages for debugging and monitoring.\u003c/p\u003e\n"],["\u003cp\u003eSuccessfully returned objects from Google Ads scripts are safe to use, indicating the operation was successful.\u003c/p\u003e\n"]]],[],null,["# Errors and Warnings\n\nGoogle Ads scripts execute in best-effort fashion: They attempt to make changes\nto Google Ads data, but if a certain change is not successful, the script\nrecords it into the [Changes log](/google-ads/scripts/docs/concepts/execution-logs)\nand proceeds with the execution: \n\n // Attempt an invalid change.\n let amount = 999999999999;\n campaign.getBudget().setAmount(amount);\n // Error is logged into Changes log, but the script keeps running.\n\n // Suppose we must know whether the change actually happened.\n if (campaign.getBudget() != amount) {\n // The current value of budget is not the one we expected.\n // The change must have failed.\n }\n\nOperations that output similar errors include:\n\n- Setting a keyword bid larger than the campaign budget.\n- Setting a campaign name to one that already exists.\n- Creating an ad group in a campaign that has already reached its quota for ad groups.\n\nSome errors, however, cannot be ignored. Here is an example: \n\n let keywords = AdsApp.keywords()\n .withCondition(\"metrics.clicks \u003e 10\")\n // Forgot forDateRange().\n .get();\n\nWith this code, the script cannot produce a meaningful `keywords` iterator\nsince the date range is not specified. Thus the script execution will halt, and\nan error message logged to the text logs.\n| **Key Point:** When Google Ads scripts successfully returns an object, it is safe to work with. An error would occur if fetching of an object failed.\n\nWarnings are logged by the script if\n[quotas](/google-ads/scripts/docs/limits) are exceeded. The script\nexecution will still proceed, but you should always review warnings.\n\nErrors are red and warnings are orange in execution logs. You can also\n[output custom messages](/google-ads/scripts/docs/concepts/execution-logs)\nto these logs for troubleshooting and monitoring purposes."]]