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.
Cette page décrit les différentes limites et restrictions à connaître concernant les scripts Google Ads. Ces limites peuvent changer à tout moment sans préavis. Assurez-vous donc que vos scripts sont flexibles et contiennent une gestion des erreurs.
Limites de temps d'exécution
scripts Google Ads
Les scripts Google Ads pour les comptes d'annonceur peuvent s'exécuter pendant 30 minutes maximum, après quoi ils sont annulés. Toutes les modifications apportées avant l'annulation du script seront appliquées.
Scripts Ads Manager
Les scripts Ads Manager peuvent normalement s'exécuter pendant 30 minutes maximum, après quoi ils sont annulés. Toutefois, si un script Ads Manager utilise la méthode executeInParallel pour traiter les comptes en parallèle et spécifie une méthode de rappel, il peut s'exécuter pendant 60 minutes maximum avant d'être annulé. Ceci est illustré dans la figure suivante, où processAccount est la fonction parallèle et allFinished est la méthode de rappel lors de l'appel de executeInParallel.
Toutes les modifications effectuées avant l'annulation du script sont appliquées.
Limites d'entités
Scripts des comptes Google Ads
Un seul itérateur renverra par défaut 50 000 résultats au maximum. Vous pouvez modifier cette valeur en appelant withLimit() sur le sélecteur.
Un seul sélecteur peut gérer au maximum 10 000 ID dans selector.withIds().
Si 10 000 ID ou plus sont spécifiés, selector.get() génère une erreur d'exécution. De même, spécifier une condition Id IN [LIST] avec une liste d'ID
10 000 entraînera une erreur d'exécution.
Les journaux sont tronqués à hauteur de 100 Ko. Un avertissement sera consigné si cela se produit.
Scripts de comptes administrateur
Chaque compte traité par un script Ads Manager dispose de son propre quota, comme indiqué ci-dessus.
Lorsqu'un script utilise la méthode executeInParallel, il peut traiter jusqu'à 50 comptes.
La méthode processAccount de executeInParallel peut renvoyer jusqu'à 10 Mo de données.
Limites d'importation groupée
La taille du fichier importé est limitée à 50 Mo et à un million de lignes. Il sera refusé lors de l'envoi s'il dépasse ces limites.
Une tâche d'importation expire au bout de deux heures. Elle cesse alors de traiter les données restantes du fichier importé.
Quotas pour les services Google
Les services Google Apps Script sous-jacents imposent des quotas quotidiens et des limites strictes pour certaines fonctionnalités. Consultez la liste de ces quotas et des messages d'exception associés.
Scripts autorisés
Le protocole OAuth2 est utilisé pour autoriser les scripts. Chaque compte est limité à 250 scripts autorisés. Au-delà de cette limite, l'un des scripts précédemment autorisés sera désautorisé. Cette situation n'est que temporaire. Le script peut être réautorisé la prochaine fois qu'il est ouvert.
Si vous atteignez fréquemment cette limite, envisagez d'utiliser plusieurs comptes utilisateur pour autoriser différents ensembles de scripts.
Campagnes vidéo et Shopping
Le sélecteur de campagne standard (AdsApp.campaigns().get()) filtrera les campagnes vidéo et Shopping des résultats. Utilisez plutôt les sélecteurs de campagne dédiés :
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/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eGoogle Ads scripts have an execution time limit of 30 minutes, while Ads Manager scripts can run for up to 60 minutes when using \u003ccode\u003eexecuteInParallel\u003c/code\u003e with a callback method.\u003c/p\u003e\n"],["\u003cp\u003eScripts for advertiser accounts have entity limits, including a 50,000 result limit per iterator, a 10,000 ID limit per selector, and a 100Kb logging output limit.\u003c/p\u003e\n"],["\u003cp\u003eAds Manager scripts have additional limits for processing accounts in parallel, with a maximum of 50 accounts and a 10MB data return limit for the \u003ccode\u003eprocessAccount\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eBulk uploads are restricted to files under 50MB and one million rows, with a two-hour timeout for processing.\u003c/p\u003e\n"],["\u003cp\u003eEach Google Ads account can authorize up to 250 scripts, and exceeding this limit will temporarily deauthorize older scripts.\u003c/p\u003e\n"]]],[],null,["# Limits\n\nThis page outlines various limits and limitations in Google Ads scripts that you\nshould be aware of. These limits can change at any time without warning, so\nensure that your scripts are flexible and contain error handling.\n\nExecution time limits\n---------------------\n\n### Google Ads scripts\n\nGoogle Ads scripts for advertiser accounts can execute for a **maximum of 30\nminutes**, after which they will be cancelled. All of the changes made\nbefore the script was cancelled will be applied.\n\n### Ads Manager scripts\n\nAds Manager scripts can normally execute for a **maximum of 30 minutes** after\nwhich they will be cancelled. However, if an Ads Manager script uses the\n[`executeInParallel`](/google-ads/scripts/docs/reference/adsmanagerapp/adsmanagerapp_managedaccountselector#executeInParallel_2)\nmethod to process accounts in parallel, and specifies a callback method, then it\ncan execute up to a **maximum of 60 minutes** before being cancelled. This is\nillustrated in the following figure, where `processAccount` is the parallel\nfunction, and `allFinished` is the callback method when calling\n[`executeInParallel`](/google-ads/scripts/docs/reference/adsmanagerapp/adsmanagerapp_managedaccountselector#executeInParallel_2).\n\nAll of the changes made before the script was cancelled will be applied.\n\nEntity limits\n-------------\n\n| **Note:** [Reports](/google-ads/scripts/docs/features/reports) are not subject to any entity limits.\n\n### Scripts of Google Ads accounts\n\n- A single **iterator** will default to at most 50,000 results returned. You\n can modify this by calling `withLimit()` on the selector.\n\n- A single **selector** can handle at most 10,000 IDs in `selector.withIds()`.\n If 10,000 or more IDs are specified, `selector.get()` will throw a runtime\n error. Similarly, specifying an `Id IN [LIST]` condition with a list of IDs\n\n \u003e 10,000 will result in a runtime error.\n- Logging output will be truncated at 100Kb. A warning will be logged if that\n happens.\n\n### Scripts of manager accounts\n\n- Each account processed by an Ads Manager script gets its own quota as [listed\n above](#scripts_of_google_ads_accounts).\n\n- When using the `executeInParallel` method, a script can process up to **50**\n accounts.\n\n- The `processAccount` method from `executeInParallel` can return up to\n **10MB** of data.\n\nBulk upload limits\n------------------\n\n- The upload file is limited to 50MB and one million rows, and will be rejected\n upon submission if it exceeds these limits.\n\n- An upload job times out after two hours and the job will stop processing any\n remaining data from the uploaded file.\n\nQuotas for Google services\n--------------------------\n\nThe underlying Google Apps Script services impose daily quotas and hard limits\non some features. See a list of these\n[quotas and accompanying exception messages](/apps-script/guides/services/quotas).\n| **Key Point:** To get around the \"Exceeded maximum execution time\" error, you can reschedule your script under multiple user accounts to extend the script's quota.\n\nAuthorized scripts\n------------------\n\nOAuth2 is used to authorize scripts. Each account has a limit of **250**\nauthorized scripts. Beyond that limit, one of the previously authorized\nscripts will be deauthorized. This is only temporary, and the script can be\nreauthorized the next time it is opened.\n\nIf you are frequently running into this limit, you should consider using\nmultiple user accounts to authorize different sets of scripts.\n\nVideo and shopping campaigns\n----------------------------\n\nThe standard campaign selector (`AdsApp.campaigns().get()`) will filter\nout [video](//support.google.com/google-ads/answer/2375497) and\n[shopping](//support.google.com/google-ads/answer/3455481) campaigns\nfrom the results. Use the dedicated campaign selectors instead:\n\n- [`videoCampaignSelector.get()`](/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaignselector)\n- [`shoppingCampaignSelector.get()`](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignselector)"]]
