Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Contient les méthodes de filtrage et de classement des listes de mots clés négatifs. Pour plus d’informations sur les sélecteurs, consultez Sélecteurs.
Exemple d’utilisation :
var iterator = AdsApp.negativeKeywordLists()
.withCondition("MemberCount > 10")
.orderBy("Name")
.get();
while (iterator.hasNext()) {
var nkwList = iterator.next();
}
Méthodes
| Nom de la méthode | Type renvoyé | Description |
|---|---|---|
| get | NegativeKeywordListIterator | Obtient un itérateur utilisé pour itérer dans la liste des listes de mots clés négatifs. |
| orderBy(string orderBy) | NegativeKeywordListSelector | Applique le classement spécifié aux listes de mots clés négatifs sélectionnées. |
| withCondition(string condition) | NegativeKeywordListSelector | Applique des critères de filtre aux listes de mots clés négatifs. |
| withIds(string[] ids) | NegativeKeywordListSelector | Obtient des listes de mots clés négatifs avec les ID spécifiés. |
| withLimit(int limit) | NegativeKeywordListSelector | Obtient les n premières listes de mots clés négatifs qui correspondent aux critères de sélection. |
Avoir
Obtient un itérateur utilise pour itérer au sein de la liste des listes de mots clés négatifs.
Retourne
| Type | Description |
|---|---|
| NegativeKeywordListIterator | Itérateur utilisé pour itérer au sein des listes de mots clés négatifs. |
orderBy(string orderBy)
Applique le classement spécifié aux listes de mots clés négatifs sélectionnées.
Spécifiez le paramètre orderBy sous la forme « columnName orderDirection » où :
- columnName est l’une des colonnes prises en charge
- orderDirection est l’ordre dans lequel trier les résultats. Définissez sur ASC pour classer les résultats dans l’ordre croissant ou sur DESC pour classer les résultats dans l’ordre décroissant. La valeur par défaut est ASC.
Par exemple, l’appel suivant retourne des listes de mots clés négatifs dans l’ordre croissant par MemberCount.
selector = selector.orderBy("MemberCount");
Les sélecteurs prennent en charge le classement des entités par un seul champ. Vous ne pouvez pas classer la liste des entités par champ x, et dans x par champ y, et ainsi de suite. Si vous spécifiez plusieurs orderBy() appels dans une chaîne ou dans des appels de sélecteur distincts, les scripts commandent la liste des entités à l’aide du champ spécifié dans le dernier orderBy() appel.
Arguments
| Nom | Type | Description |
|---|---|---|
| Orderby | string | Ordre à appliquer. |
Retourne
| Type | Description |
|---|---|
| NegativeKeywordListSelector | Sélecteur avec classement appliqué. |
withCondition(string condition)
Applique des critères de filtre aux listes de mots clés négatifs.
Spécifiez le paramètre de condition sous la forme « columnName operator value » où :
- columnName est l’une des colonnes prises en charge.
- est l’un des opérateurs pris en charge.
Opérateurs
L’opérateur que vous utilisez dépend du type de la colonne. Les opérateurs respectent la casse. Par exemple, utilisez STARTS_WITH au lieu de starts_with.
Opérateurs pour les colonnes qui contiennent des entiers et des valeurs longues :
<
<=
>
>=
=
!=
Opérateurs pour les colonnes qui contiennent des valeurs doubles :
<
>
Opérateurs pour les colonnes qui contiennent des valeurs de chaîne :
=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE
Opérateurs pour les colonnes qui contiennent des valeurs d’énumération :
=
!=
IN []
NOT_IN []
Opérateurs pour les colonnes qui contiennent un tableau de chaînes :
CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE
Colonnes prises en charge. Les noms des colonnes sont sensibles à la casse.
| Column | Type | Exemple |
|---|---|---|
| MemberCount | int | Nombre de mots clés négatifs dans la liste.withCondition("MemberCount > 10") |
| Nom | string | Nom de la liste de mot clé négative.withCondition("Name = 'LIST NAME GOES HERE'") |
| ReferenceCount | int | Nombre de campagnes associées à la liste.withCondition("ReferenceCount > 10") |
| SharedSetId | double | ID d’une liste de mot clé négative. Si vous utilisez simplement ceci pour la comparaison d’égalité, envisagez d’utiliser la méthode à la withIds place.withCondition("SharedSetId = 123456789") |
Arguments
| Nom | Type | Description |
|---|---|---|
| Condition | chaîne | Condition à ajouter au sélecteur. |
Retourne
| Type | Description |
|---|---|
| NegativeKeywordListSelector | Sélecteur avec la condition appliquée. |
withIds(string[] ids)
Obtient des listes de mots clés négatifs avec les ID spécifiés.
Vous pouvez appliquer une ou plusieurs conditions à un sélecteur. Une chaîne de conditions est considérée comme une opération AND. Par exemple, l’entité est sélectionnée uniquement si la condition A a la valeur true ET si la condition B a la valeur true. Par exemple, l’appel suivant sélectionne uniquement la liste de mots clés négatifs 33333.
AdsApp.negativeKeywordLists()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Arguments
| Nom | Type | Description |
|---|---|---|
| Ids | string[] | Un tableau de mot clé négatifs répertorie les ID. Pour connaître les limites, consultez Limites d’exécution de script. |
Retourne
| Type | Description |
|---|---|
| NegativeKeywordListSelector | Sélecteur avec les ID appliqués. |
withLimit(int limit)
Obtient les n premières listes de mots clés négatifs qui correspondent aux critères de sélection.
Arguments
| Nom | Type | Description |
|---|---|---|
| limit | int | Nombre de listes de mots clés négatifs à retourner. Le nombre réel peut être inférieur. |
Retourne
| Type | Description |
|---|---|
| NegativeKeywordListSelector | Sélecteur avec limite appliquée. |