PlacementGroups

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表現

パッケージまたはロードブロッキングのプロパティが含まれています。

{
  "kind": "dfareporting#placementGroup",
  "id": long,
  "idDimensionValue": dimensionValues Resource,
  "accountId": long,
  "subaccountId": long,
  "advertiserId": long,
  "advertiserIdDimensionValue": dimensionValues Resource,
  "campaignId": long,
  "campaignIdDimensionValue": dimensionValues Resource,
  "name": string,
  "siteId": long,
  "siteIdDimensionValue": dimensionValues Resource,
  "directorySiteId": long,
  "directorySiteIdDimensionValue": dimensionValues Resource,
  "archived": boolean,
  "pricingSchedule": {
    "testingStartDate": date,
    "startDate": date,
    "endDate": date,
    "pricingType": string,
    "capCostOption": string,
    "flighted": boolean,
    "pricingPeriods": [
      {
        "startDate": date,
        "endDate": date,
        "units": long,
        "rateOrCostNanos": long,
        "pricingComment": string
      }
    ],
    "floodlightActivityId": long
  },
  "placementGroupType": string,
  "contentCategoryId": long,
  "placementStrategyId": long,
  "comment": string,
  "childPlacementIds": [
    long
  ],
  "primaryPlacementId": long,
  "primaryPlacementIdDimensionValue": dimensionValues Resource,
  "createInfo": {
    "time": long
  },
  "lastModifiedInfo": {
    "time": long
  },
  "externalId": string
}
プロパティ名 説明 メモ
accountId long このプレースメント グループのアカウント ID。空白のままにできる読み取り専用のフィールドです。
advertiserId long このプレースメント グループの広告主 ID。挿入時に必須のフィールドです。
advertiserIdDimensionValue nested object 広告主の ID のディメンション値。自動生成される読み取り専用のフィールドです。
archived boolean このプレースメント グループがアーカイブされているかどうか。
campaignId long このプレースメント グループのキャンペーン ID。挿入時に必須のフィールドです。
campaignIdDimensionValue nested object キャンペーンの ID のディメンション値。自動生成される読み取り専用のフィールドです。
childPlacementIds[] list このプレースメント グループに割り当てられているプレースメントの ID。自動生成される読み取り専用のフィールドです。
comment string このプレースメント グループの注釈。
contentCategoryId long このプレースメント グループに割り当てられているコンテンツ カテゴリの ID。
createInfo nested object このプレースメント グループの作成に関する情報。読み取り専用のフィールドです。
createInfo.time long 最終変更のタイムスタンプ(エポックからのミリ秒)。
directorySiteId long このプレースメント グループに関連付けられているディレクトリ サイト ID。挿入時に、このフィールドまたは site_id フィールドを設定して、このプレースメント グループに関連付けられるサイトを指定する必要があります。挿入後に読み取り専用となる必須のフィールドです。
directorySiteIdDimensionValue nested object ディレクトリ サイトの ID のディメンション値。自動生成される読み取り専用のフィールドです。
externalId string このプレースメントの外部 ID。
id long このプレースメント グループの ID。自動生成される読み取り専用のフィールドです。
idDimensionValue nested object このプレースメント グループの ID のディメンション値。自動生成される読み取り専用のフィールドです。
kind string リソースの種類を識別します。値: 固定文字列 "dfareporting#placementGroup"
lastModifiedInfo nested object このプレースメント グループの最新の変更に関する情報。読み取り専用のフィールドです。
lastModifiedInfo.time long 最終変更のタイムスタンプ(エポックからのミリ秒)。
name string このプレースメント グループの名前。必須のフィールドです。256 文字未満で指定してください。
placementGroupType string このプレースメント グループのタイプ。パッケージは、タグのグループの単一の料金設定ポイントとして機能するシンプルなプレースメント グループです。ロードブロッキングは、単一の料金設定ポイントとして機能するだけでなく、その中のすべてのタグが同時に配信されることを前提とするプレースメント グループです。ロードブロッキングでは、割り当てられたプレースメントのいずれかをレポートのメインとして指定する必要があります。挿入時に必須のフィールドです。

設定可能な値は次のとおりです。
  • "PLACEMENT_PACKAGE"
  • "PLACEMENT_ROADBLOCK"
placementStrategyId long このプレースメント グループに割り当てられたプレースメント戦略の ID。
pricingSchedule nested object このプレースメント グループの料金設定スケジュール。挿入時に必須のフィールドです。
pricingSchedule.capCostOption string プレースメントの費用上限オプション。

設定可能な値は次のとおりです。
  • "CAP_COST_CUMULATIVE"
  • "CAP_COST_MONTHLY"
  • "CAP_COST_NONE"
pricingSchedule.endDate date プレースメントの終了日。この日付は、プレースメントの開始日以降、キャンペーンの終了日以前にする必要があります。たとえば、開始日と終了日の両方を 2015 年 6 月 25 日に設定すると、有効なプレースメント期間は 2015 年 6 月 25 日のみになります。終了日の時間、分、秒は設定できません。設定するとエラーになります。挿入時に必須のフィールドです。
pricingSchedule.flighted boolean このプレースメントがフライティング設定済みかどうか。true の場合、料金設定期間は自動的に計算されます。
pricingSchedule.floodlightActivityId long このプレースメントに関連付けられている Floodlight アクティビティ ID。プレースメントの料金タイプが PRICING_TYPE_CPA に設定されている場合、このフィールドを設定する必要があります。
pricingSchedule.pricingPeriods[] list このプレースメントの料金設定期間。
pricingSchedule.pricingPeriods[].endDate date 料金設定期間の終了日。この日付は、料金設定期間の開始日以降、プレースメントの終了日以前にする必要があります。期間の終了日には期間の開始日と同じ日付を指定できます。たとえば、開始日と終了日の両方を 2015 年 6 月 25 日に設定すると、有効な料金設定期間は 2015 年 6 月 25 日のみになります。終了日の時間、分、秒は設定できません。設定するとエラーになります。
pricingSchedule.pricingPeriods[].pricingComment string この料金設定期間の注釈。
pricingSchedule.pricingPeriods[].rateOrCostNanos long この料金設定期間のレートまたは費用(ナノ単位、つまり 1,000,000,000 を掛けた値)。設定可能な値は 01000000000000000000 です。
pricingSchedule.pricingPeriods[].startDate date 料金設定期間の開始日。この日付は、プレースメントの開始日以降にする必要があります。開始日の時間、分、秒は設定しないでください。設定するとエラーになります。
pricingSchedule.pricingPeriods[].units long この料金設定期間の単位。設定可能な値は 010000000000 です。
pricingSchedule.pricingType string プレースメントの料金タイプ。挿入時に必須のフィールドです。

設定可能な値は次のとおりです。
  • "PRICING_TYPE_CPA"
  • "PRICING_TYPE_CPC"
  • "PRICING_TYPE_CPM"
  • "PRICING_TYPE_CPM_ACTIVEVIEW"
  • "PRICING_TYPE_FLAT_RATE_CLICKS"
  • "PRICING_TYPE_FLAT_RATE_IMPRESSIONS"
pricingSchedule.startDate date プレースメントの開始日。この日付は、キャンペーンの開始日以降にする必要があります。開始日の時間、分、秒は設定しないでください。設定するとエラーになります。挿入時に必須のフィールドです。
pricingSchedule.testingStartDate date このプレースメントのテスト開始日。開始日の時間、分、秒は設定しないでください。設定するとエラーになります。
primaryPlacementId long ロードブロッキング(プレースメント グループ)のメディア費用の計算に使用する、メインのプレースメントの ID。このフィールドを変更すると、影響を受けるすべてのロードブロッキング子プレースメントで primary フィールドが自動的に変更されます。
primaryPlacementIdDimensionValue nested object メインのプレースメントの ID のディメンション値。自動生成される読み取り専用のフィールドです。
siteId long このプレースメント グループに関連付けられているサイト ID。挿入時に、このフィールドまたは directorySiteId フィールドを設定して、このプレースメント グループに関連付けられるサイトを指定する必要があります。挿入後に読み取り専用となる必須のフィールドです。
siteIdDimensionValue nested object サイトの ID のディメンション値。自動生成される読み取り専用のフィールドです。
subaccountId long このプレースメント グループのサブアカウント ID。空白のままにできる読み取り専用のフィールドです。

メソッド

get
ID でプレースメント グループを 1 つ取得します。
insert
新しいプレースメント グループを挿入します。
list
プレースメント グループのリストを取得します。結果をフィルタできます。このメソッドはページ分けをサポートしています。
patch
既存のプレースメント グループを更新します。このメソッドはパッチのセマンティクスをサポートしています。
update
既存のプレースメント グループを更新します。