Partager via

ProductGroup

  • Article

Objet groupe de produits de base, qui contient les méthodes utilisées pour gérer un groupe de produits.

Exemple d’utilisation :

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

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

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

Méthodes

Nom de la méthode Type renvoyé Description
asBrand ProductBrand Convertit le groupe de produits en un groupe de produits de marque.
asCategory ProductCategory Convertit le groupe de produits en groupe de produits de catégorie.
asChannel ProductChannel Convertit le groupe de produits en un groupe de produits de canal.
asChannelExclusivity ProductChannelExclusivity Convertit le groupe de produits en un groupe de produits d’exclusivité de canal.
asCondition ProductCondition Convertit le groupe de produits en un groupe de produits de condition.
asCustomLabel ProductCustomLabel Convertit le groupe de produits en un groupe de produits d’étiquette personnalisée.
asItemId ProductItemId Convertit le groupe de produits en groupe de produits ID d’élément.
asProductType ProductType Convertit le groupe de produits en un groupe de produits de type de produit.
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.
getStats Stats Obtient les données de performances pour ce groupe de produits.
Getvalue Chaîne Obtient la valeur de ce groupe de produits.
isExcluded Valeur booléenne Obtient une valeur booléenne qui détermine si ce groupe de produits est exclu.
isOtherCase Valeur booléenne 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.

asBrand

Convertit ce groupe de produits en un groupe de produits de marque.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en groupe de produits de marque pour accéder à la valeur de la marque. Vous pouvez accéder à la valeur de la marque en appelant la méthode getValue .

Retourne

Type Description
ProductBrand Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

asCategory

Convertit ce groupe de produits en groupe de produits de catégorie.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en groupe de produits Catégorie pour accéder à la valeur de la catégorie. Vous pouvez accéder à la valeur de la catégorie en appelant la méthode getValue .

Retourne

Type Description
ProductCategory Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

asChannel

Convertit ce groupe de produits en un groupe de produits de canal.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en groupe de produits de canal pour accéder à la valeur du canal. Vous pouvez accéder à la valeur du canal en appelant la méthode getValue .

Retourne

Type Description
ProductChannel Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

asChannelExclusivity

Convertit ce groupe de produits en un groupe de produits d’exclusivité de canal.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en un groupe de produits d’exclusivité de canal pour accéder à la valeur du canal. Vous pouvez accéder à la valeur du canal en appelant la méthode getValue .

Retourne

Type Description
ProductChannelExclusivity Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

asCondition

Convertit ce groupe de produits en groupe de produits de condition.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en groupe de produits Condition pour accéder à la valeur de la condition. Vous pouvez accéder à la valeur de la condition en appelant la méthode getValue .

Retourne

Type Description
ProductCondition Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

asCustomLabel

Convertit ce groupe de produits en un groupe de produits d’étiquette personnalisée.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en groupe de produits CustomLabel pour accéder à la valeur de l’étiquette. Vous pouvez accéder à la valeur de l’étiquette en appelant la méthode getValue . Vous devez uniquement convertir le groupe de produits en CustomLabel si vous avez besoin de savoir à quel type d’étiquette la valeur est destinée. Par exemple, l’étiquette personnalisée 0 à 4.

Retourne

Type Description
ProductCustomLabel Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

asItemId

Convertit ce groupe de produits en un groupe de produits d’ID d’élément.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en un groupe de produits ItemId pour accéder à la valeur de l’ID. Vous pouvez accéder à la valeur de l’ID en appelant la méthode getValue .

Retourne

Type Description
ProductItemId Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

asProductType

Convertit ce groupe de produits en un groupe de produits de type de produit.

Remarque

Il n’est pas nécessaire de convertir le groupe de produits en un groupe de produits ProductType pour accéder à la valeur du type. Vous pouvez accéder à la valeur du type en appelant la méthode getValue . Vous devez uniquement convertir le groupe de produits en ProductType si vous avez besoin de savoir à quel type la valeur est destinée. Par exemple, PRODUCT_TYPE_L1, etc.

Retourne

Type Description
ProductType Contient les méthodes utilisées pour accéder aux propriétés du groupe de produits.

children

Obtient un sélecteur utilisé pour filtrer la liste de 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
Chaîne Dimension de ce groupe de produits. Les valeurs possibles sont les suivantes :
  • ROOT : haut de l’arborescence
  • MARQUE
  • CATÉGORIE
  • CONDITION
  • CUSTOM_LABEL
  • ITEM_ID
  • PRODUCT_TYPE

getEntityType

Obtient le type de cette entité.

Retourne

Type Description
string Type de cette entité, qui est ProductGroup.

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

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 la valeur de ce groupe de produits.

Renvoie :

Type Description
Chaîne Valeur de ce groupe de produits. Retourne null s’il s’agit du groupe racine.

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. Retourne null s’il s’agit du groupe racine.

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.