REST Resource: curators.dataSegments

リソース: DataSegment

キュレーターまたはメディア プランナーが取引またはオークション パッケージの UI でターゲティングできる広告枠セグメントの識別子を定義します。広告枠のキュレーションは、外部プラットフォームのキュレーターによって行われます。-- 次の ID: 9 --

JSON 表現
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
フィールド
name

string

変更不可。ID。データ セグメントの固有識別子。アカウント ID は、セグメントを作成したアカウント ID に対応します。形式: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

出力専用。データ セグメントが作成された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

出力専用。データ セグメントが最後に更新された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

state

enum (State)

出力専用。データ セグメントの状態。

他のアカウントがこのデータ セグメントを使用すると、料金が請求されます。たとえば、他のアカウントがこのデータ セグメントを取引またはオークション パッケージに追加した場合です。データ セグメントの料金タイプは、一度設定すると変更できません。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
cpmFee

object (Money)

省略可。1,000 回のインプレッションごとに請求される固定料金。一度設定した通貨コードは変更できません。

millipercentOfMediaFee

string (int64 format)

省略可。この料金は、インプレッション費用の割合として請求され、ミリパーセントで表されます。たとえば、1% は 1000 と表されます。

相互に排他的なフィールドの終了。
userListId

string

省略可。変更不可。このデータ セグメントでラップされたユーザーリストの ID。

リンクされたデータ パートナー アカウントを持つキュレーターは、リンクされたデータ パートナー アカウントが所有するユーザーリストをラップするデータ セグメントを作成できます。ユーザーリストは、Data Manager API を使用してアップロードおよび管理できます。ユーザーリストをデータ セグメントにリンクすると、作成したオーディエンスに基づいて広告枠のセグメントを定義できます。

州

出力専用。状態を変更するには、activate メソッドと deactivate メソッドを使用します。

列挙型
STATE_UNSPECIFIED デフォルト値。
ACTIVE データ セグメントが有効です。
INACTIVE データ セグメントが無効です。
SUSPENDED データ セグメントが一時停止されているため、有効にできません。

メソッド

activate

データ セグメントを有効にします。

create

指定されたキュレーターが所有するデータ セグメントを作成します。

deactivate

データ セグメントを無効にします。

get

名前を指定してデータ セグメントを取得します。

list

キュレーターが所有するデータ セグメントを一覧表示します。

patch

データ セグメントを更新します。