Sign in
curators

Creates a data segment owned by the listed curator. The data segment will be created in the ACTIVE state, meaning it will be immediately available for buyers to use in preferred deals, private auction deals, and auction packages.

post/v1/{+parent}/dataSegments

Request

  • Base URL: https://curationpartners.googleapis.com
  • URL: https://curationpartners.googleapis.com/v1/{+parent}/dataSegments
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/curation-partners) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/curation-partners)

Path parameters

parentstring required

Required. The parent resource where this data segment will be created. Format: curators/{accountId}

Request body

state'STATE_UNSPECIFIED' | 'ACTIVE' | 'INACTIVE' | 'SUSPENDED'

Output only. The state of the data segment.

namestring

Immutable. Identifier. The unique identifier for the data segment. Account ID corresponds to the account ID that created the segment. Format: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTimestring google-datetime

Output only. Time the data segment was created.

updateTimestring google-datetime

Output only. Time the data segment was last updated.

millipercentOfMediaFeestring int64

Optional. The fee will be charged as a percentage of the impression cost, represented in millipercent. For example, 1% is represented as 1000.

userListIdstring

Optional. Immutable. The ID of the User List wrapped by this Data Segment. Curators with a linked Data Partner account can create a data segment that wraps a user list owned by the linked Data Partner account. User lists can be uploaded and managed using the Data Manager API. Linking a user list to a data segment lets you define a segment of inventory that is based on an audience you create.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.