ProductCategory

Contient les méthodes de gestion d’un groupe de produits de catégorie. Cet objet dérive de ProductGroup.

Utilisé par le moteur de livraison pour déterminer si un produit du catalogue de l’annonceur est servi. Le moteur peut servir le produit si la catégorie du produit correspond exactement au nom de catégorie retourné par getName.

Exemple d’utilisation :

    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

    var productGroups = shoppingCampaign.productGroups().get();

    while (productGroups.hasNext()) {
        var group = productGroups.next();

        switch (group.getDimension()) {
            case "CATEGORY": {
                // It's not necessary to cast the product group to a category product
                // group since the getValue() method returns the same value as getName().
                // var category = group.asCategory().getName();

                var category = group.getValue();
                break;
            }
            // Other cases
        }
    }

Méthodes

Nom de la méthode	Type renvoyé	Description
children	ProductGroupSelector	Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits enfants de ce groupe de produits.
getAdGroup	AdGroup	Obtient le groupe d’annonces auquel appartient ce groupe de produits.
getCampaign	Campagne	Obtient la campagne à laquelle ce groupe de produits appartient.
getDimension	string	Obtient la dimension de ce groupe de produits.
getEntityType	string	Obtient le type de cette entité.
getId	string	Obtient l’ID qui identifie de façon unique ce groupe de produits.
getMaxCpc	double	Obtient le montant maximal de l’enchère coût par clic pour ce groupe de produits.
Getname	string	Obtient le nom de catégorie du produit.
getStats	Stats	Obtient les données de performances pour ce groupe de produits.
Getvalue	string	Obtient la valeur de ce groupe de produits.
isExcluded	Boolean	Obtient une valeur booléenne qui détermine si ce groupe de produits est exclu.
isOtherCase	Boolean	Obtient une valeur booléenne qui détermine si ce groupe de produits représente tous les autres cas non représentés par son groupe de produits frère.
Parent	ProductGroup	Obtient le groupe de produits parent de ce groupe de produits.
setMaxCpc(double cpc)	void	Définit le montant maximal de l’enchère coût par clic à utiliser pour ce groupe de produits.

children

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

Retourne

Type	Description
ProductGroupSelector	Sélecteur utilisé pour filtrer la liste des enfants de ce groupe de produits.

getAdGroup

Obtient le groupe d’annonces auquel appartient ce groupe de produits.

Retourne

Type	Description
AdGroup	Groupe d’annonces auquel appartient ce groupe de produits.

getCampaign

Obtient la campagne à laquelle ce groupe de produits appartient.

Retourne

Type	Description
Campagne	Campagne à laquelle appartient ce groupe de produits.

getDimension

Obtient la dimension de ce groupe de produits.

Retourne

Type	Description
String	Dimension de ce groupe de produits, qui est définie sur CATEGORY.

getEntityType

Obtient le type de cette entité.

Retourne

Type	Description
string	Le type de cette entité, qui est ProductCategory.

getId

Obtient l’ID qui identifie de façon unique ce groupe de produits.

Retourne

Type	Description
string	ID qui identifie de façon unique ce groupe de produits.

getMaxCpc

Obtient le montant maximal du coût par clic de ce groupe de produits.

Retourne

Type	Description
double	Montant de l’offre. Retourne null s’il n’est pas défini ou s’il s’agit d’un groupe de produits négatif (isExluded a la valeur true).

Getname

Obtient le nom de catégorie du produit. Cette méthode retourne la même valeur que la getValue() méthode .

Retourne

Type	Description
string	Nom de la catégorie du produit. Par exemple, Animals & Pet Supplies.

getStats

Obtient les données de performances pour ce groupe de produits.

Pour appeler cette méthode, vous devez inclure l’une des forDateRange méthodes dans la chaîne du sélecteur de groupe de produits .

Renvoie :

Type	Description
Stats	Données de performances pour ce groupe de produits.

Getvalue

Obtient le nom de catégorie du produit.

Renvoie :

Type	Description
string	Nom de la catégorie du produit. Il s’agit de la même valeur que celle retournée par la méthode getName .

isExcluded

Obtient une valeur booléenne qui détermine si ce groupe de produits est un groupe de produits négatif.

Renvoie :

Type	Description
Boolean	A la valeur true si ce groupe de produits est un groupe négatif ; sinon, false. Par exemple, au lieu d’inclure tous les skis alpins, vous les excluez.

isOtherCase

Obtient une valeur booléenne qui détermine si ce groupe de produits représente tout le reste qui n’est pas représenté par son groupe de produits frère (c’est-à-dire, l’autre cas).

Renvoie :

Type

Description

Boolean

A la valeur true si ce groupe de produits représente l'« autre » cas ; sinon, false. Par exemple, si vous divisez Tous les produits (le nœud racine) par Articles de sport, le service crée un groupe de produits frère qui représente les produits non dans Articles de sport et définit ce champ sur true. L’ID parent de ce groupe de produits et le groupe de produits Articles de sport pointent vers le nœud racine.

parent

Obtient le parent de ce groupe de produits.

Renvoie :

Type	Description
ProductGroup	Parent de ce groupe de produits.

setMaxCpc(double cpc)

Définit le montant maximal du coût par clic pour ce groupe de produits.

Arguments

Nom	Type	Description
Cpc	double	Montant de l’offre. Le montant de l’enchère est dans la devise du compte, ce qui détermine les valeurs d’enchère minimale et maximale que vous pouvez spécifier. Ne définissez pas l’enchère si ce groupe de produits est subdivisé (a des enfants) ou s’il s’agit d’un groupe de produits négatif (isExcluded a la valeur true).

Retourne

Type	Description
void	Renvoie la valeur nothing.