Freigeben über

ProductGroup

  • Artikel

Das Basisproduktgruppenobjekt, 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 benutzerdefinierte Etikettenproduktgruppe um.
asItemId ProductItemId Wandelt die Produktgruppe in eine Produkt-ID-Produktgruppe um.
asProductType ProductType Wandelt die Produktgruppe in eine Produkttyp-Produktgruppe um.
Kinder ProductGroupSelector Ruft einen Selektor ab, der zum Filtern der Liste der untergeordneten Produktgruppen dieser Produktgruppe verwendet wird.
getAdGroup Anzeigengruppe 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 dieser Entität ab.
Getid string Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.
getMaxCpc double Ruft den maximalen Kosten-pro-Klick-Gebotsbetrag für diese Produktgruppe ab.
Getstats Statistiken Ruft die Leistungsdaten für diese Produktgruppe ab.
Getvalue Zeichenfolge Ruft den Wert dieser Produktgruppe ab.
isExcluded Boolesch Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe ausgeschlossen wird.
isOtherCase Boolesch Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alle anderen Fälle darstellt, die nicht durch ihre gleichgeordnete Produktgruppe dargestellt werden.
Elternteil ProductGroup Ruft die übergeordnete Produktgruppe dieser Produktgruppe ab.
setMaxCpc(double cpc) void Legt den maximalen Kosten-pro-Klick-Gebotsbetrag fest, der für diese Produktgruppe verwendet werden soll.

asBrand

Wandelt diese Produktgruppe in eine Markenproduktgruppe um.

Hinweis

Es ist nicht notwendig, die Produktgruppe in eine Markenproduktgruppe zu umwandeln, 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 für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

asCategory

Wandelt diese Produktgruppe in eine Kategorieproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Kategorie-Produktgruppe zu umwandeln, 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 für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

asChannel

Wandelt diese Produktgruppe in eine Channel-Produktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Kanalproduktgruppe umzuwanderen, 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 für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

asChannelExclusivity

Wandelt diese Produktgruppe in eine Kanalexklusivitätsproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Kanalexklusivitätsproduktgruppe zu umwandeln, 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 für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

asCondition

Wandelt diese Produktgruppe in eine Bedingungsproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine Bedingungsproduktgruppe zu umwandeln, 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 für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

asCustomLabel

Wandelt diese Produktgruppe in eine benutzerdefinierte Etikettenproduktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine CustomLabel-Produktgruppe zu umwandeln, um auf den Wert des Etiketts 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 Bezeichnungstyp der Wert gilt. Beispiel: benutzerdefinierte Bezeichnung 0 bis 4.

Rückgabewerte

Typ Beschreibung
ProductCustomLabel Enthält die Methoden, die für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

asItemId

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

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine ItemId-Produktgruppe umzuwanderen, 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 für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

asProductType

Wandelt diese Produktgruppe in eine Produkttyp-Produktgruppe um.

Hinweis

Es ist nicht erforderlich, die Produktgruppe in eine ProductType-Produktgruppe zu umwandeln, 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 verwendet wird. Beispiel: PRODUCT_TYPE_L1 usw.

Rückgabewerte

Typ Beschreibung
ProductType Enthält die Methoden, die für den Zugriff auf die Eigenschaften der Produktgruppe verwendet werden.

Untergeordnetes Element

Ruft einen Selektor ab, der 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
Anzeigengruppe 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 – Der obere Rand der Struktur
  • MARKE
  • KATEGORIE
  • ZUSTAND
  • CUSTOM_LABEL
  • ITEM_ID
  • PRODUCT_TYPE

getEntityType

Ruft den Typ dieser Entität ab.

Rückgabewerte

Typ Beschreibung
string Der Typ dieser Entität, d. h. ProductGroup.

Getid

Ruft die ID ab, die diese Produktgruppe eindeutig identifiziert.

Rückgabewerte

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

getMaxCpc

Ruft den maximalen Kosten-pro-Klick-Gebotsbetrag dieser Produktgruppe ab.

Rückgabewerte

Typ Beschreibung
double Der Gebotsbetrag. Gibt NULL zurück, wenn nicht festgelegt ist oder dies eine negative Produktgruppe ist (isExluded ist true).

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 einschließen.

Rückgabewerte:

Typ Beschreibung
Statistiken Die Leistungsdaten 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
Boolescher Wert Ist true , wenn diese Produktgruppe eine negative Gruppe ist; andernfalls false. Anstatt beispielsweise alle Abfahrtsskis einzuschließen, schließen Sie sie aus.

isOtherCase

Ruft einen booleschen Wert ab, der bestimmt, ob diese Produktgruppe alles darstellt, was nicht durch die nebengeordnete Produktgruppe (aka., der andere Fall) dargestellt wird.

Rückgabewerte:

Typ Beschreibung
Boolescher Wert Ist true , wenn diese Produktgruppe den "anderen" Fall darstellt; andernfalls false. Wenn Sie beispielsweise Alle Produkte (der Stammknoten) durch Sportartikel unterteilen, erstellt der Dienst eine gleichgeordnete Produktgruppe, die die Produkte darstellt, die nicht in Sportartikeln enthalten sind, und legt dieses Feld auf true fest. Die übergeordnete ID dieser Produktgruppe und die Produktgruppe Sportartikel verweisen auf den Stammknoten.

übergeordnetes Element

Ruft das übergeordnete Element dieser Produktgruppe ab.

Rückgabewerte:

Typ Beschreibung
ProductGroup Übergeordnetes Element dieser Produktgruppe. Gibt NULL zurück, wenn dies die Stammgruppe ist.

setMaxCpc(double cpc)

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

Argumente

Name Typ Beschreibung
Cpc double Der Gebotsbetrag. Der Gebotsbetrag ist in der Währung des Kontos, die die minimalen und maximalen Gebotswerte bestimmt, die Sie angeben können. Legen Sie das Gebot nicht fest, wenn diese Produktgruppe unterteilt ist (über untergeordnete Elemente verfügt) oder eine negative Produktgruppe ist (isExcludedist true).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.