ProductGroup

Das Basis-Produktgruppenobjekt, das die Methoden enthält, die zum Verwalten einer Produktgruppe verwendet werden.

Anwendungsbeispiel:

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

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

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

Methoden

Methodenname Rückgabetyp Beschreibung
asBrand ProductBrand Wandelt die Produktgruppe in eine Markenproduktgruppe um.
asCategory ProductCategory Wandelt die Produktgruppe in eine Kategorieproduktgruppe um.
asChannel ProductChannel Wandelt die Produktgruppe in eine Kanalproduktgruppe um.
asChannelExclusivity ProductChannelExclusivity Wandelt die Produktgruppe in eine Kanalexklusivitätsproduktgruppe um.
asCondition ProductCondition Wandelt die Produktgruppe in eine Bedingungsproduktgruppe um.
asCustomLabel ProductCustomLabel Wandelt die Produktgruppe in eine Produktgruppe mit benutzerdefinierten Bezeichnungen um.
asItemId ProductItemId Wandelt die Produktgruppe in eine Artikel-ID-Produktgruppe um.
asProductType ProductType Wandelt die Produktgruppe in eine Produkttypproduktgruppe um.
Kinder ProductGroupSelector Ruft einen Selektor ab, der zum Filtern der Liste der untergeordneten Produktgruppen dieser Produktgruppe verwendet wird.
getAdGroup AdGroup Ruft die Anzeigengruppe ab, zu der diese Produktgruppe gehört.
getCampaign Kampagnen Ruft die Kampagne ab, zu der diese Produktgruppe gehört.
getDimension string Ruft die Dimension dieser Produktgruppe ab.
getEntityType string Ruft den Typ dieses Objekts ab.
getId string Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.
getMaxCpc double Ruft den maximalen Gebotsbetrag für die Kosten pro Klick für diese Produktgruppe ab.
getStats Statistik Ruft die Leistungsdaten für diese Produktgruppe ab.
getValue Zeichenfolge Ruft den Wert dieser Produktgruppe ab.
isExcluded Boolean Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe ausgeschlossen wird.
isOtherCase Boolean Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alle anderen Fälle darstellt, die nicht durch die gleichgeordnete Produktgruppe repräsentiert werden.
Übergeordnetes Element ProductGroup Ruft die übergeordnete Produktgruppe dieser Produktgruppe ab.
setMaxCpc(double cpc) void Legt den maximalen Gebotsbetrag für die Kosten pro Klick fest, der für diese Produktgruppe verwendet werden soll.

asBrand

Wandelt diese Produktgruppe in eine Markenproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Markenproduktgruppe umzuwandeln, um auf den Wert der Marke zuzugreifen. Sie können auf den Wert der Marke zugreifen, indem Sie die getValue-Methode aufrufen.

Rückgabewerte

Typ Beschreibung
ProductBrand Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

asCategory

Wandelt diese Produktgruppe in eine Kategorieproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Kategorieproduktgruppe umzuwandeln, um auf den Wert der Kategorie zuzugreifen. Sie können auf den Wert der Kategorie zugreifen, indem Sie die getValue-Methode aufrufen.

Rückgabewerte

Typ Beschreibung
ProductCategory Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

asChannel

Wandelt diese Produktgruppe in eine Kanalproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Kanalproduktgruppe umzuwandeln, um auf den Wert des Kanals zuzugreifen. Sie können auf den Wert des Kanals zugreifen, indem Sie die getValue-Methode aufrufen.

Rückgabewerte

Typ Beschreibung
ProductChannel Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

asChannelExclusivity

Wandelt diese Produktgruppe in eine Kanalexklusivitäts-Produktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Kanalexklusivitätsproduktgruppe umzuwandeln, um auf den Wert des Kanals zuzugreifen. Sie können auf den Wert des Kanals zugreifen, indem Sie die getValue-Methode aufrufen.

Rückgabewerte

Typ Beschreibung
ProductChannelExclusivity Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

asCondition

Wandelt diese Produktgruppe in eine Bedingungsproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Bedingungsproduktgruppe umzuwandeln, um auf den Wert der Bedingung zuzugreifen. Sie können auf den Wert der Bedingung zugreifen, indem Sie die getValue-Methode aufrufen.

Rückgabewerte

Typ Beschreibung
ProductCondition Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

asCustomLabel

Wandelt diese Produktgruppe in eine Produktgruppe mit benutzerdefinierten Bezeichnungen um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine CustomLabel-Produktgruppe umzuwandeln, um auf den Wert des Labels zuzugreifen. Sie können auf den Wert der Bezeichnung zugreifen, indem Sie die getValue-Methode aufrufen. Sie müssen die Produktgruppe nur dann in CustomLabel umwandeln, wenn Sie wissen müssen, für welchen Etikettentyp der Wert gilt. Beispiele: Benutzerdefinierte Bezeichnung 0 bis 4.

Rückgabewerte

Typ Beschreibung
ProductCustomLabel Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

asItemId

Wandelt diese Produktgruppe in eine Artikel-ID-Produktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine ItemId-Produktgruppe umzuwandeln, um auf den Wert der ID zuzugreifen. Sie können auf den Wert der ID zugreifen, indem Sie die getValue-Methode aufrufen.

Rückgabewerte

Typ Beschreibung
ProductItemId Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

asProductType

Wandelt diese Produktgruppe in eine Produkttypproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine ProductType-Produktgruppe umzuwandeln, um auf den Wert des Typs zuzugreifen. Sie können auf den Wert des Typs zugreifen, indem Sie die getValue-Methode aufrufen. Sie müssen die Produktgruppe nur dann in "ProductType" umwandeln, wenn Sie wissen müssen, für welchen Typ der Wert gilt. Beispielsweise PRODUCT_TYPE_L1 usw.

Rückgabewerte

Typ Beschreibung
ProductType Enthält die Methoden, die verwendet werden, um auf die Eigenschaften der Produktgruppe zuzugreifen.

Untergeordnetes Element

Ruft eine Auswahl ab, die zum Filtern der Liste der untergeordneten Produktgruppen dieser Produktgruppe verwendet wird.

Rückgabewerte

Typ Beschreibung
ProductGroupSelector Ein Selektor, der zum Filtern der Liste der untergeordneten Elemente in dieser Produktgruppe verwendet wird.

getAdGroup

Ruft die Anzeigengruppe ab, zu der diese Produktgruppe gehört.

Rückgabewerte

Typ Beschreibung
AdGroup Die Anzeigengruppe, zu der diese Produktgruppe gehört.

getCampaign

Ruft die Kampagne ab, zu der diese Produktgruppe gehört.

Rückgabewerte

Typ Beschreibung
Kampagnen Die Kampagne, zu der diese Produktgruppe gehört.

getDimension

Ruft die Dimension dieser Produktgruppe ab.

Rückgabewerte

Typ Beschreibung
Zeichenfolge Die Dimension dieser Produktgruppe. Die folgenden Werte sind möglich:
  • ROOT — Die Spitze der Struktur
  • MARKE
  • KATEGORIE
  • BEDINGUNG
  • CUSTOM_LABEL
  • ITEM_ID
  • PRODUCT_TYPE

getEntityType

Ruft den Typ dieses Objekts ab.

Rückgabewerte

Typ Beschreibung
string Der Typ dieser Entität, bei dem es sich um "ProductGroup" handelt.

getId

Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.

Rückgabewerte

Typ Beschreibung
string Die ID, die diese Produktgruppe eindeutig identifiziert.

getMaxCpc

Ruft das maximale Gebot für die Kosten pro Klick dieser Produktgruppe ab.

Rückgabewerte

Typ Beschreibung
double Der Gebotsbetrag. Gibt Null zurück, wenn nicht festgelegt oder es sich um eine negative Produktgruppe handelt (isExluded ist wahr).

getStats

Ruft die Leistungsdaten für diese Produktgruppe ab.

Um diese Methode aufzurufen, müssen Sie eine der forDateRange Methoden in die Kette der Produktgruppenauswahl aufnehmen.

Rückgabewerte:

Typ Beschreibung
Statistik Die Performance-Daten für diese Produktgruppe.

getValue

Ruft den Wert dieser Produktgruppe ab.

Rückgabewerte:

Typ Beschreibung
Zeichenfolge Der Wert dieser Produktgruppe Gibt Null zurück, wenn dies die Stammgruppe ist.

isExcluded

Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe eine negative Produktgruppe ist.

Rückgabewerte:

Typ Beschreibung
Boolean Ist wahr , wenn es sich bei dieser Produktgruppe um eine negative Gruppe handelt; Andernfalls wird "false" verwendet. Anstatt beispielsweise alle Abfahrtsski einzubeziehen, schließen Sie sie aus.

isOtherCase

Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alles andere darstellt, was nicht durch die gleichgeordnete Produktgruppe repräsentiert wird (auch bekannt als die andere Groß-/Kleinschreibung).

Rückgabewerte:

Typ Beschreibung
Boolean Ist wahr , wenn diese Produktgruppe den "anderen" Fall darstellt; Andernfalls wird "false" verwendet. Wenn Sie beispielsweise Alle Produkte (den Stammknoten) durch Sportartikel teilen, erstellt der Dienst eine gleichgeordnete Produktgruppe, die die Produkte darstellt, die nicht in Sportartikel enthalten sind, und legt dieses Feld auf "true" fest. Die übergeordnete ID dieser Produktgruppe und die Produktgruppe Sporting Goods zeigen auf den Wurzelknoten.

übergeordnetes Element

Ruft das übergeordnete Element dieser Produktgruppe ab.

Rückgabewerte:

Typ Beschreibung
ProductGroup Das übergeordnete Element dieser Produktgruppe. Gibt Null zurück, wenn dies die Stammgruppe ist.

setMaxCpc(double cpc)

Legt den maximalen Gebotsbetrag für Kosten pro Klick für diese Produktgruppe fest.

Argumente

Name Typ Beschreibung
CPC double Der Gebotsbetrag. Der Gebotsbetrag wird in der Währung des Kontos angegeben, die den von Ihnen angegebenen minimalen und maximalen Gebotswert bestimmt. Legen Sie das Gebot nicht fest, wenn diese Produktgruppe unterteilt ist (untergeordnete Elemente hat) oder eine negative Produktgruppe ist (isExcludedist wahr).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.