AdsApp

Il s’agit de l’objet de niveau supérieur utilisé pour accéder à un seul compte et le gérer.

Remarque

Cet objet remplace l’objet BingAdsApp . Dans l’immédiat, Scripts continuera à prendre en charge BingAdsApp pour la rétrocompatibilité ; Cependant, nous vous encourageons à mettre à jour vos scripts pour utiliser cet objet dès que possible.

Méthodes

Nom de la méthode	Type renvoyé	Description
adGroups	AdGroupSelector	Obtient un sélecteur utilisé pour filtrer la liste des groupes d’annonces dans ce compte.
publicités	AdSelector	Obtient un sélecteur utilisé pour filtrer la liste des annonces de ce compte.
les budgets	Sélecteur de budget	Obtient un sélecteur utilisé pour filtrer la liste des budgets partagés dans ce compte.
Campagnes	Sélecteur de campagne	Obtient un sélecteur utilisé pour filtrer la liste des campagnes de ce compte.
createLabel(string name, string description, string backgroundColor)	void	Cette méthode crée une étiquette.
currentAccount	Account	Obtient le compte que le script traite actuellement.
getExecutionInfo	Informations sur l’exécution	Renvoie des informations sur l’environnement dans lequel le script est en cours d’exécution.
Mots clés	KeywordSelector	Obtient un sélecteur utilisé pour filtrer la liste des mots clés de ce compte.
Étiquettes	Sélecteur d’étiquette	Obtient un sélecteur utilisé pour filtrer la liste des étiquettes de ce compte.
negativeKeywordLists	NegativeKeywordListSelector	Obtient un sélecteur utilisé pour filtrer la liste des listes de mots clés négatifs dans ce compte.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Obtient un générateur utilisé pour ajouter une liste de mots clés négatifs à ce compte.
performanceMaxCampaigns	Sélecteur de campagne	Obtient un sélecteur utilisé pour filtrer la liste des campagnes Performance Max dans ce compte.
productGroups	ProductGroupSelector	Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits de ce compte.
shoppingAdGroups	AdGroupSelector	Obtient un sélecteur utilisé pour filtrer la liste des groupes d’annonces utilisés pour les achats dans ce compte.
Campagnes d’achat	Sélecteur de campagne	Obtient un sélecteur utilisé pour filtrer la liste des campagnes utilisées pour les achats dans ce compte.
Listes d’utilisateurs	UserListSelector	Obtient un sélecteur utilisé pour filtrer la liste des listes d’utilisateurs dans ce compte.

adGroups

Obtient un sélecteur utilisé pour filtrer la liste des groupes d’annonces dans ce compte.

Retourne

Type	Description
AdGroupSelector	Sélecteur utilisé pour filtrer la liste des groupes d’annonces dans le compte actuel.

publicités

Obtient un sélecteur utilisé pour filtrer la liste des annonces de ce compte.

Retourne

Type	Description
AdSelector	Sélecteur utilisé pour filtrer la liste des annonces dans le compte actuel.

les budgets

Obtient un sélecteur utilisé pour filtrer la liste des budgets partagés dans ce compte.

Cette méthode renvoie uniquement les budgets partagés. Pour obtenir des budgets non partagés (campagne individuelle), appelez la méthode getBudget de la campagne spécifique. Le budget de la campagne n’est pas partagé si la isExplicitlyShared méthode retourne false.

Retourne

Type	Description
Sélecteur de budget	Un sélecteur utilisé pour filtrer la liste des budgets partagés dans le compte courant.

Campagnes

Obtient un sélecteur utilisé pour filtrer la liste des campagnes de ce compte.

Retourne

Type	Description
Sélecteur de campagne	Un sélecteur utilisé pour filtrer la liste des campagnes dans le compte actuel.

createLabel(string name, string description, string backgroundColor)

Cette méthode crée une étiquette.

Pour connaître les limites du nombre d’étiquettes que vous pouvez créer par compte, consultez Limites. Pour consulter un exemple qui ajoute une étiquette à un compte, consultez Utilisation d’étiquettes.

Arguments

Nom	Type	Description
backgroundColor	string	Facultatif. Couleur d’arrière-plan à utiliser dans l’expérience utilisateur de l’étiquette. Vous pouvez spécifier la couleur à l’aide de : Nombre hexadécimal de trois octets de forme #RRGGBB. Par exemple, #CB0400. L’un des 16 noms de couleur CSS connus. Par exemple, aqua, jaune et fuchsia. Tenez compte de l’accessibilité lors du choix de la couleur. Si cela n’est pas spécifié, une couleur aléatoire est choisie pour vous.
description	string	Facultatif. Description qui décrit l’utilisation de l’étiquette. La taille maximale est de 200 caractères. Si vous spécifiez backgroundColor, vous devez fournir une description ou une chaîne vide («  »).
nom	string	Obligatoire. Nom de l’étiquette. Le nom respecte la casse et doit être unique dans le compte. La taille maximale est de 80 caractères. La méthode supprime les espaces blancs de début et de fin du nom.

Retourne

Type	Description
void	Renvoie la valeur nothing.

currentAccount

Obtient le compte que le script traite actuellement.

Remarque

Pour utiliser cette méthode dans un scénario impliquant plusieurs comptes, sélectionnez d’abord un compte à gérer. Si vous appelez cette méthode avant de sélectionner un compte, l’appel retourne null.

Retourne

Type	Description
Account	Le compte que le script traite actuellement. Pour savoir comment l’utiliser dans un scénario à plusieurs comptes, consultez la méthode de sélection de AccountsApp.

getExecutionInfo

Renvoie des informations sur l’environnement dans lequel le script est en cours d’exécution.

Renvoie :

Type	Description
Informations sur l’exécution	Les informations sur l’environnement dans lequel le script est en cours d’exécution.

keywords

Obtient un sélecteur utilisé pour filtrer la liste des mots clés de ce compte.

Retourne

Type	Description
KeywordSelector	Sélecteur utilisé pour filtrer la liste des mots clés dans le compte actuel.

Étiquettes

Obtient un sélecteur utilisé pour filtrer la liste des étiquettes de ce compte.

Retourne

Type	Description
Sélecteur d’étiquette	Un sélecteur utilisé pour filtrer la liste des étiquettes dans le compte actuel.

negativeKeywordLists

Obtient un sélecteur utilisé pour filtrer la liste des listes de mots clés négatifs dans ce compte.

Retourne

Type	Description
NegativeKeywordListSelector	Sélecteur utilisé pour filtrer la liste des listes de mots clés négatifs dans le compte actuel.

newNegativeKeywordListBuilder

Obtient un générateur utilisé pour ajouter une liste de mots clés négatifs à ce compte.

Retourne

Type	Description
NegativeKeywordListBuilder	Un constructeur utilisé pour ajouter une liste de mots clés négatifs au compte actuel.

performanceMaxCampaigns

Obtient un sélecteur utilisé pour filtrer la liste des campagnes utilisées pour Performance Max dans ce compte.

Retourne

Type	Description
Sélecteur de campagne	Sélecteur utilisé pour filtrer la liste des campagnes utilisées pour Performance Max dans le compte actuel.

productGroups

Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits de ce compte.

Retourne

Type	Description
ProductGroupSelector	Un sélecteur utilisé pour filtrer la liste des groupes de produits dans le compte actuel.

shoppingAdGroups

Obtient un sélecteur utilisé pour filtrer la liste des groupes d’annonces utilisés pour les achats dans ce compte.

Retourne

Type	Description
AdGroupSelector	Sélecteur utilisé pour filtrer la liste des groupes d’annonces utilisés pour les achats dans le compte actuel.

Campagnes d’achat

Obtient un sélecteur utilisé pour filtrer la liste des campagnes utilisées pour les achats dans ce compte.

Retourne

Type	Description
Sélecteur de campagne	Sélecteur utilisé pour filtrer la liste des campagnes utilisées pour les achats dans le compte actuel.

Listes d’utilisateurs

Obtient un sélecteur utilisé pour filtrer la liste des listes d’utilisateurs dans ce compte.

Retourne

Type	Description
UserListSelector	Sélecteur utilisé pour filtrer la liste des listes d’utilisateurs dans le compte actuel.

Voir aussi

Accès au compte unique