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 :
|
| 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. |