AdsApp

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

Remarque

Cet objet remplace l’objet BingAdsApp . Dans un avenir immédiat, Scripts continuera à prendre en charge BingAdsApp pour la compatibilité descendante ; Toutefois, nous vous encourageons à mettre à jour vos scripts pour utiliser cet objet dès que vous le souhaitez.

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.
Annonces	AdSelector	Obtient un sélecteur utilisé pour filtrer la liste des annonces dans ce compte.
Budgets	BudgetSelector	Obtient un sélecteur utilisé pour filtrer la liste des budgets partagés dans ce compte.
Campagnes	CampaignSelector	Obtient un sélecteur utilisé pour filtrer la liste des campagnes dans 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	ExecutionInfo	Retourne 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 dans ce compte.
Étiquettes	LabelSelector	Obtient un sélecteur utilisé pour filtrer la liste des étiquettes dans ce compte.
negativeKeywordLists	NegativeKeywordListSelector	Obtient un sélecteur utilisé pour filtrer la liste des listes de mot clé négatives dans ce compte.
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	Obtient un générateur utilisé pour ajouter une liste de mot clé négative à ce compte.
productGroups	ProductGroupSelector	Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits dans 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.
shoppingCampaigns	CampaignSelector	Obtient un sélecteur utilisé pour filtrer la liste des campagnes utilisées pour les achats dans ce compte.
userLists	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.

Annonces

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

Retourne

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

Budgets

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

Cette méthode retourne 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
BudgetSelector	Sélecteur utilisé pour filtrer la liste des budgets partagés dans le compte actuel.

Campagnes

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

Retourne

Type	Description
CampaignSelector	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 obtenir 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 au format #RRGGBB. Par exemple, #CB0400. L’un des 16 noms de couleurs CSS connus. Par exemple, aqua, jaune et fuchsia. Tenez compte de l’accessibilité lors du choix de la couleur. S’il 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 au sein du 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 à 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	Compte que le script traite actuellement. Pour savoir comment l’utiliser dans un scénario multicomptes, consultez la méthode select de AccountsApp.

getExecutionInfo

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

Renvoie :

Type	Description
ExecutionInfo	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 dans 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 dans ce compte.

Retourne

Type	Description
LabelSelector	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 mot clé négatives dans ce compte.

Retourne

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

newNegativeKeywordListBuilder

Obtient un générateur utilisé pour ajouter une liste de mot clé négative à ce compte.

Retourne

Type	Description
NegativeKeywordListBuilder	Générateur utilisé pour ajouter une liste de mot clé négative au compte actuel.

productGroups

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

Retourne

Type	Description
ProductGroupSelector	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.

shoppingCampaigns

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

Retourne

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

userLists

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 à un seul compte