Partager via


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