Defines an identifier for a segment of inventory that can be targeted by curators or media planners in the deals or auction packages UI. Curation of inventory is done by curators on external platforms.
Immutable. Identifier. The unique identifier for the data segment. Account ID corresponds to the account ID that created the segment. v1alpha format: buyers/{accountId}/dataSegments/{curatorDataSegmentId} v1beta format: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Output only. Time the data segment was last updated.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Required. This will be charged when other accounts use this data segment. For example, when other accounts add this data segment to a deal or auction package. Once set, the currency code cannot be changed.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-12 UTC."],[],[],null,["# REST Resource: curators.dataSegments\n\n- [Resource: DataSegment](#DataSegment)\n - [JSON representation](#DataSegment.SCHEMA_REPRESENTATION)\n- [State](#State)\n- [Methods](#METHODS_SUMMARY)\n\nResource: DataSegment\n---------------------\n\nDefines an identifier for a segment of inventory that can be targeted by curators or media planners in the deals or auction packages UI. Curation of inventory is done by curators on external platforms.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"createTime\": string, \"updateTime\": string, \"cpmFee\": { object (/authorized-buyers/apis/marketplace/reference/rest/Shared.Types/Money) }, \"state\": enum (/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#State) } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Immutable. Identifier. The unique identifier for the data segment. Account ID corresponds to the account ID that created the segment. v1alpha format: `buyers/{accountId}/dataSegments/{curatorDataSegmentId}` v1beta format: `curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}` |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time the data segment was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `updateTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time the data segment was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `cpmFee` | `object (`[Money](/authorized-buyers/apis/marketplace/reference/rest/Shared.Types/Money)`)` Required. This will be charged when other accounts use this data segment. For example, when other accounts add this data segment to a deal or auction package. Once set, the currency code cannot be changed. |\n| `state` | `enum (`[State](/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#State)`)` Output only. The state of the data segment. |\n\nState\n-----\n\nOutput only. Use the activate and deactivate method to change state.\n\n| Enums ||\n|---------------------|-------------------------------|\n| `STATE_UNSPECIFIED` | Default value. |\n| `ACTIVE` | The data segment is active. |\n| `INACTIVE` | The data segment is inactive. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| ### [activate](/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/activate) | Activates a data segment. |\n| ### [create](/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/create) | Creates a data segment owned by the listed curator. |\n| ### [deactivate](/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/deactivate) | Deactivates a data segment. |\n| ### [get](/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/get) | Gets a data segment given its name. |\n| ### [list](/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/list) | List the data segments owned by a curator. |\n| ### [patch](/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/patch) | Updates a data segment. |"]]