ProductCondition

条件商品グループの管理方法が含まれています。 このオブジェクトは ProductGroup から派生します。

広告主のカタログに掲載されている商品が提供されるかどうかを判断するために、配信エンジンによって使用されます。 製品の状態が getCondition によって返される条件と正確に一致する場合、エンジンは製品を提供する場合があります。

使用例:

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

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

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

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

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

メソッド

メソッド名	戻り値の型	説明
children	ProductGroupSelector	この商品グループの子商品グループのリストをフィルター処理するために使用するセレクターを取得します。
getAdGroup	AdGroup	この製品グループが属する広告グループを取得します。
getCampaign	Campaign	この商品グループが属するキャンペーンを取得します。
getCondition	string	製品の状態を取得します。
getDimension	string	この商品グループのディメンションを取得します。
getEntityType	string	このエンティティの型を取得します。
getId	string	この製品グループを一意に識別する ID を取得します。
getMaxCpc	double	この商品グループの最大クリック単価の金額を取得します。
getName	string	製品の状態を取得します。
getStats	統計情報	この製品グループのパフォーマンス データを取得します。
getValue	string	この商品グループの値を取得します。
isExcluded	ブール型	この製品グループを除外するかどうかを決定するブール値を取得します。
isOtherCase	ブール型	この製品グループが兄弟製品グループでは表されない他のすべてのケースを表すかどうかを判断するブール値を取得します。
parent	ProductGroup	この製品グループの親製品グループを取得します。
setMaxCpc(double cpc)	void	この商品グループに使用する最大クリック単価額を設定します。

children

この商品グループの子商品グループのリストをフィルター処理するために使用する セレクター を取得します。

戻り値

型	説明
ProductGroupSelector	この製品グループ内の子のリストをフィルター処理するために使用されるセレクター。

getAdGroup

この製品グループが属する広告グループを取得します。

戻り値

型	説明
AdGroup	この製品グループが属する広告グループ。

getCampaign

この商品グループが属するキャンペーンを取得します。

戻り値

型	説明
Campaign	この商品グループが属するキャンペーン。

getCondition

製品の状態を取得します。

戻り値

型	説明
string	製品の状態。 たとえば、[New] (新品)、[Used] (中古品)、Refurbished (再生品) などです。

getDimension

この商品グループのディメンションを取得します。

戻り値

型	説明
文字列	この商品グループの分析コード。[条件] に設定されています。

getEntityType

このエンティティの型を取得します。

戻り値

型	説明
string	このエンティティの型。 ProductCondition です。

getId

この製品グループを一意に識別する ID を取得します。

戻り値

型	説明
string	この商品グループを一意に識別する ID。

getMaxCpc

この商品グループの最大クリック単価の金額を取得します。

戻り値

型	説明
double	入札金額。 設定されていない場合、または負の製品グループ (isExluded が true の場合) を返します。

getName

製品の状態を取得します。 このメソッドは、 getValue() メソッドと同じ値を返します。

戻り値

型	説明
string	製品の状態。 たとえば、[New] (新品)、[Refurbished] (再生品)、Used(中古品) など。

getStats

この製品グループのパフォーマンス データを取得します。

このメソッドを呼び出すには、商品グループ セレクターのチェーンにいずれかのforDateRangeメソッドを含める必要があります。

戻り値:

型	説明
統計情報	この製品グループのパフォーマンス データ。

getValue

製品の状態を取得します。

戻り値:

型	説明
string	製品の状態。 これは、 getName メソッドが返す値と同じです。

isExcluded

この商品グループが負の商品グループかどうかを判断するブール値を取得します。

戻り値:

型	説明
ブール型	この製品グループが負のグループの場合は true 。それ以外の場合は false。 たとえば、すべての滑降スキーを含めるのではなく、除外します。

isOtherCase

この製品グループが、兄弟製品グループでは表されない他のすべてを表すかどうか (他のケース) を決定するブール値を取得します。

戻り値:

型	説明
ブール型	この製品グループが "other" ケースを表す場合は true 。それ以外の場合は false。 たとえば、[すべての商品] (ルート ノード) を [Sporting Goods] で除算すると、[Sporting Goods] に含まれない商品を表す兄弟商品グループが作成され、このフィールドが true に設定されます。 この商品グループの親 ID と Sporting Goods 商品グループはルート ノードを指します。

親

この製品グループの親を取得します。

戻り値:

型	説明
ProductGroup	この製品グループの親。

setMaxCpc(double cpc)

この商品グループの最大クリック単価金額を設定します。

引数

名前	型	説明
cpc	double	入札金額。 入札額はアカウントの通貨で定められ、この通貨によって指定できる下限と最高入札額が決まります。 商品グループが細分化されている (子がある)、または負の商品グループ (isExcludedが True) の場合は、入札単価を設定しないでください。

戻り値

型	説明
void	Nothing を返します。