ProductGroup
製品グループの管理に使用されるメソッドを含む基本 製品グループ オブジェクト。
使用例:
var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();
var productGroups = shoppingCampaign.productGroups().get();
while (productGroups.hasNext()) {
var group = productGroups.next();
}
メソッド
| メソッド名 | 戻り値の型 | 説明 |
|---|---|---|
| asBrand | ProductBrand | 製品グループをブランド製品グループにキャストします。 |
| asCategory | ProductCategory | 製品グループをカテゴリ製品グループにキャストします。 |
| asChannel | ProductChannel | 製品グループをチャネル製品グループにキャストします。 |
| asChannelExclusivity | ProductChannelExclusivity | 製品グループをチャネル排他性製品グループにキャストします。 |
| asCondition | ProductCondition | 製品グループを条件製品グループにキャストします。 |
| asCustomLabel | ProductCustomLabel | 製品グループをカスタム ラベル製品グループにキャストします。 |
| asItemId | ProductItemId | 製品グループをアイテム ID 製品グループにキャストします。 |
| asProductType | ProductType | 製品グループを製品タイプの製品グループにキャストします。 |
| 子供 | ProductGroupSelector | この製品グループの子製品グループの一覧をフィルター処理するために使用されるセレクターを取得します。 |
| getAdGroup | AdGroup | この製品グループが属する広告グループを取得します。 |
| getCampaign | キャンペーン | この製品グループが属するキャンペーンを取得します。 |
| getDimension | string | この製品グループのディメンションを取得します。 |
| getEntityType | string | このエンティティの型を取得します。 |
| getId | string | この製品グループを一意に識別する ID を取得します。 |
| getMaxCpc | double | この製品グループの最大クリック単価を取得します。 |
| getStats | 統計 | この製品グループのパフォーマンス データを取得します。 |
| Getvalue | String | この製品グループの値を取得します。 |
| isExcluded | ブール型 | この製品グループを除外するかどうかを決定するブール値を取得します。 |
| isOtherCase | ブール型 | この製品グループが、その兄弟製品グループで表されていない他のすべてのケースを表すかどうかを決定するブール値を取得します。 |
| 親 | ProductGroup | この製品グループの親製品グループを取得します。 |
| setMaxCpc(double cpc) | void | この製品グループに使用するクリック単価の上限額を設定します。 |
asBrand
この製品グループをブランド製品グループにキャストします。
注:
ブランドの価値にアクセスするために、製品グループをブランド製品グループにキャストする必要はありません。 getValue メソッドを呼び出すことで、ブランドの値にアクセスできます。
戻り値
| 型 | 説明 |
|---|---|
| ProductBrand | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
asCategory
この製品グループをカテゴリ製品グループにキャストします。
注:
カテゴリの値にアクセスするために、製品グループをカテゴリ製品グループにキャストする必要はありません。 getValue メソッドを呼び出すことで、カテゴリの値にアクセスできます。
戻り値
| 型 | 説明 |
|---|---|
| ProductCategory | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
asChannel
この製品グループをチャネル製品グループにキャストします。
注:
チャネルの値にアクセスするために、製品グループをチャネル製品グループにキャストする必要はありません。 getValue メソッドを呼び出すことで、チャネルの値にアクセスできます。
戻り値
| 型 | 説明 |
|---|---|
| ProductChannel | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
asChannelExclusivity
この製品グループをチャネル排他性製品グループにキャストします。
注:
チャネルの値にアクセスするために、製品グループをチャネル排他性製品グループにキャストする必要はありません。 getValue メソッドを呼び出すことで、チャネルの値にアクセスできます。
戻り値
| 型 | 説明 |
|---|---|
| ProductChannelExclusivity | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
asCondition
この製品グループを条件製品グループにキャストします。
注:
条件の値にアクセスするために、製品グループを Condition 製品グループにキャストする必要はありません。 getValue メソッドを呼び出すことで、条件の値にアクセスできます。
戻り値
| 型 | 説明 |
|---|---|
| ProductCondition | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
asCustomLabel
この製品グループをカスタム ラベル製品グループにキャストします。
注:
ラベルの値にアクセスするために、製品グループを CustomLabel 製品グループにキャストする必要はありません。 getValue メソッドを呼び出すことで、ラベルの値にアクセスできます。 値の対象となるラベルの種類を把握する必要がある場合にのみ、製品グループを CustomLabel にキャストする必要があります。 たとえば、カスタム ラベル 0 から 4 です。
戻り値
| 型 | 説明 |
|---|---|
| ProductCustomLabel | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
asItemId
この製品グループをアイテム ID 製品グループにキャストします。
注:
ID の値にアクセスするために、製品グループを ItemId 製品グループにキャストする必要はありません。 getValue メソッドを呼び出すことで、ID の値にアクセスできます。
戻り値
| 型 | 説明 |
|---|---|
| ProductItemId | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
asProductType
この製品グループを製品タイプの製品グループにキャストします。
注:
製品グループを ProductType 製品グループにキャストして、型の値にアクセスする必要はありません。 getValue メソッドを呼び出すことで、型の値にアクセスできます。 製品グループを ProductType にキャストする必要があるのは、値の対象となる型を把握する必要がある場合のみです。 たとえば、PRODUCT_TYPE_L1などです。
戻り値
| 型 | 説明 |
|---|---|
| ProductType | 製品グループのプロパティにアクセスするために使用されるメソッドが含まれます。 |
children
この製品グループの子製品グループの一覧をフィルター処理するために使用される セレクター を取得します
戻り値
| 型 | 説明 |
|---|---|
| ProductGroupSelector | この製品グループ内の子の一覧をフィルター処理するために使用されるセレクター。 |
getAdGroup
この製品グループが属する広告グループを取得します。
戻り値
| 型 | 説明 |
|---|---|
| AdGroup | この製品グループが属する広告グループ。 |
getCampaign
この製品グループが属するキャンペーンを取得します。
戻り値
| 型 | 説明 |
|---|---|
| キャンペーン | この製品グループが属するキャンペーン。 |
getDimension
この製品グループのディメンションを取得します。
戻り値
| 型 | 説明 |
|---|---|
| String | この製品グループのディメンション。 使用可能な値は次のとおりです。
|
getEntityType
このエンティティの型を取得します。
戻り値
| 型 | 説明 |
|---|---|
| string | このエンティティの型 ( ProductGroup)。 |
getId
この製品グループを一意に識別する ID を取得します。
戻り値
| 型 | 説明 |
|---|---|
| string | この製品グループを一意に識別する ID。 |
getMaxCpc
この製品グループのクリック単価の最大単価を取得します。
戻り値
| 型 | 説明 |
|---|---|
| double | 入札金額。 設定されていない場合、または負の製品グループisExluded ( が true) の場合は null を返します。 |
getStats
この製品グループのパフォーマンス データを取得します。
このメソッドを呼び出すには、製品グループ セレクターのforDateRangeチェーンにいずれかのメソッドを含める必要があります。
戻り値:
| 型 | 説明 |
|---|---|
| 統計 | この製品グループのパフォーマンス データ。 |
Getvalue
この製品グループの値を取得します。
戻り値:
| 型 | 説明 |
|---|---|
| String | この製品グループの値。 ルート グループの場合は null を返します。 |
isExcluded
この製品グループが負の製品グループであるかどうかを判断するブール値を取得します。
戻り値:
| 型 | 説明 |
|---|---|
| ブール型 | この製品グループが負のグループの場合は true です。それ以外の場合は false。 たとえば、すべてのダウンヒル スキーを含める代わりに、それらを除外します。 |
isOtherCase
この製品グループが、その兄弟製品グループ (別名、その他のケース) によって表されていない他のすべてを表すかどうかを決定するブール値を取得します。
戻り値:
| 型 | 説明 |
|---|---|
| ブール型 | この製品グループが "other" ケースを表す場合は true です。それ以外の場合は false。 たとえば、すべての製品 (ルート ノード) を Sporting Goods で除算した場合、サービスは、スポーツ用品以外の製品を表す兄弟製品グループを作成し、このフィールドを true に設定します。 この製品グループと Sporting Goods 製品グループの親 ID は、ルート ノードを指します。 |
親
この製品グループの親を取得します。
戻り値:
| 型 | 説明 |
|---|---|
| ProductGroup | この製品グループの親。 ルート グループの場合は null を返します。 |
setMaxCpc(double cpc)
この製品グループのクリック単価の上限額を設定します。
引数
| 名前 | 型 | 説明 |
|---|---|---|
| クリック 単価 | double | 入札金額。 入札金額はアカウントの通貨で、指定できる最小入札額と最大入札額を決定します。 この製品グループが分割されている (子を持つ) か、負の製品グループisExcluded ( true) の場合は、入札を設定しないでください。 |
戻り値
| 型 | 説明 |
|---|---|
| void | Nothing を返します。 |