La classe AdsManagerApp des scripts Google Ads vous permet de gérer les comptes associés à votre compte administrateur. Vous pouvez gérer tous vos comptes annonceur à l'aide d'un seul script au lieu de créer un script distinct pour chaque compte.
Récupérer la liste des comptes
Vous pouvez récupérer des comptes sous un compte administrateur à l'aide de la méthode accounts, par exemple:
const accountSelector = AdsManagerApp.accounts()
.withCondition('customer_client.descriptive_name = "My Account"');
const accountIterator = accountSelector.get();
Certaines restrictions s'appliquent aux comptes pouvant être récupérés:
- Les comptes administrateur ne peuvent pas être récupérés si vous disposez d'une hiérarchie à plusieurs niveaux. Seuls les comptes client peuvent être sélectionnés.
- Par défaut, les comptes clôturés, désactivés et suspendus ne sont pas renvoyés. Vous pouvez remplacer ce comportement en appelant
withConditionen spécifiant un filtre différent pourcustomer_client.status.
L'appel accounts récupère par défaut la liste de tous les comptes client dans la hiérarchie du compte administrateur. Vous pouvez utiliser la méthode withLimit de la classe ManagedAccountSelector pour limiter le nombre de comptes récupérés par votre script. Vous pouvez également sélectionner les comptes par numéro client à l'aide de la méthode withIds:
// Hyphens in the account ID are optional.
const accountSelector = AdsManagerApp.accounts()
.withIds(['123-456-7890', '234-567-8901', '345-678-9012']);
Travailler sur des comptes client
Une fois que vous avez récupéré les comptes client, vous pouvez les itérer à l'aide des méthodes hasNext et next de l'itérateur. Vous devez utiliser la méthode select pour définir le contexte d'exécution sur un compte client. Une fois que vous avez sélectionné un compte client, tous les autres appels d'API s'appliquent à ce compte jusqu'à ce que vous sélectionniez explicitement un autre compte:
// Keep track of the manager account for future reference.
const managerAccount = AdsApp.currentAccount();
// Select your accounts
const accountIterator = AdsManagerApp.accounts()
// ... Write some logic here to select the accounts you want using
// withCondition or withIds
// Iterate through the list of accounts
for (const account of accountIterator) {
// Select the client account.
AdsManagerApp.select(account);
// Select campaigns under the client account
const campaignIterator = AdsApp.campaigns().get();
// Operate on client account
...
}
Travailler sur plusieurs comptes en parallèle
Les scripts Google Ads vous permettent d'effectuer des opérations en parallèle sur plusieurs comptes client à l'aide de la méthode executeInParallel de la classe ManagedAccountSelector. La méthode executeInParallel a la signature suivante:
function executeInParallel(functionName, optionalCallbackFunctionName, optionalInput);
La méthode executeInParallel exécute une fonction spécifiée par functionName sur chaque ManagedAccount auquel ManagedAccountSelector correspond. Une fois tous les comptes traités, la fonction de rappel, si elle est spécifiée par optionalCallbackFunctionName, est exécutée une fois, en transmettant une liste d'objets ExecutionResult comme argument pour tout traitement ultérieur. Voici un exemple d'utilisation type:
function main() {
const accountSelector = AdsManagerApp.accounts()
.withLimit(50)
.withCondition('customer_client.currency_code = "USD"');
accountSelector.executeInParallel("processClientAccount", "afterProcessAllClientAccounts");
}
function processClientAccount() {
const clientAccount = AdsApp.currentAccount();
// Process your client account here.
...
// optionally, return a result, as text.
return "";
}
function afterProcessAllClientAccounts(results) {
for (const result of results) {
// Process the result further
...
}
}
La fonction spécifiée par functionName peut éventuellement accepter un argument de chaîne (optionalInput). Ce paramètre peut être utilisé pour transmettre un paramètre supplémentaire à toutes les méthodes parallèles appelées par executeInParallel:
function main() {
const accountSelector = AdsManagerApp.accounts().withIds([1234567890, 3456787890]);
const sharedParameter = "INSERT_SHARED_PARAMETER_HERE";
accountSelector.executeInParallel("processClientAccount", null, sharedParameter);
}
function processClientAccount(sharedParameter) {
// Process your client account here.
...
}
Si vous souhaitez transmettre un objet de configuration JavaScript contenant des paramètres spécifiques au compte, vous pouvez d'abord le convertir en chaîne à l'aide de la méthode JSON.stringify:
function main() {
...
const accountFlags = {
'1234567890': {
'label': 'Brand 1 campaigns',
},
'3456787890': {
'label': 'Brand 2 campaigns',
}
};
accountSelector.executeInParallel("processClientAccount", null,
JSON.stringify(accountFlags));
...
}
function processClientAccount(sharedParameter) {
const accountFlags = JSON.parse(sharedParameter);
// Process your client account here.
...
}
La fonction spécifiée par functionName peut également renvoyer une chaîne au lieu d'un objet via JSON.stringify:
function processClientAccount() {
...
const jsonObj = {value: 10, list: [1,2,3,4,5,6], name: "Joe Smith"};
return JSON.stringify(jsonObj);
}
Les valeurs renvoyées sont transmises à la fonction de rappel dans une liste d'objets ExecutionResult. Si vous avez renvoyé une chaîne JSON à partir de la fonction, vous pouvez la reconvertir en objet JavaScript à l'aide de la méthode JSON.parse:
function callbackFunctionName(results) {
for (var i = 0; i < results.length; i++) {
var resultObj = JSON.parse(results[i].getReturnValue());
}
}
La méthode executeInParallel fonctionne sur un maximum de 50 accounts. Vous devrez donc implémenter vos propres restrictions pour limiter le nombre de comptes récupérés par votre script. Vous pouvez utiliser la méthode withLimit ou withIds de la classe ManagedAccountSelector pour limiter le nombre de comptes récupérés par votre script.
Limites de durée d'exécution
Pour en savoir plus sur les limites de temps d'exécution des scripts Ads Manager, consultez cette page.