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."],[[["\u003cp\u003eData segments define inventory portions targetable by curators or media planners in deals or auction packages.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a data segment includes its name, creation and update times, a CPM fee, and its state.\u003c/p\u003e\n"],["\u003cp\u003eKey fields for a data segment include its unique identifier, creation and update timestamps, the CPM fee charged to other accounts using it, and its current state.\u003c/p\u003e\n"],["\u003cp\u003eData segments can be in one of three states: unspecified, active, or inactive, with state changes managed via activate and deactivate methods.\u003c/p\u003e\n"],["\u003cp\u003eVarious methods allow users to create, activate, deactivate, get, list, and patch data segments.\u003c/p\u003e\n"]]],[],null,["# REST Resource: buyers.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/v1alpha/buyers.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/v1alpha/buyers.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/v1alpha/buyers.dataSegments/activate) | Activates a data segment. |\n| ### [create](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.dataSegments/create) | Creates a data segment owned by the listed curator. |\n| ### [deactivate](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.dataSegments/deactivate) | Deactivates a data segment. |\n| ### [get](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.dataSegments/get) | Gets a data segment given its name. |\n| ### [list](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.dataSegments/list) | List the data segments owned by a curator. |\n| ### [patch](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.dataSegments/patch) | Updates a data segment. |"]]