- [Resource: DataSegment](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#DataSegment)
  - [JSON representation](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#DataSegment.SCHEMA_REPRESENTATION)
- [State](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#State)
- [Methods](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#METHODS_SUMMARY)

## Resource: DataSegment

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.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "state": enum (`https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#State`), // Union field `fee` can be only one of the following: "cpmFee": { object (`https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/Shared.Types/Money`) }, "millipercentOfMediaFee": string // End of list of possible types for union field `fee`. "userListId": string } ``` |

| Fields ||
|---|---|
| `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}` |
| `createTime` | ``string (`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 use 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"`. |
| `updateTime` | ``string (`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 use 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"`. |
| `state` | ``enum (`https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments#State`)`` Output only. The state of the data segment. |
| Union field `fee`. Fee 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. Fee type of the data segment cannot be changed once set. `fee` can be only one of the following: ||
| `cpmFee` | ``object (`https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/Shared.Types/Money`)`` Optional. A fixed fee charged per thousand impressions. Once set, the currency code cannot be changed. |
| `millipercentOfMediaFee` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. The fee will be charged as a percentage of the impression cost, represented in millipercent. For example, 1% is represented as 1000. |
| `userListId` | `string` Optional. Immutable. The ID of the User List wrapped by this Data Segment. Data segments that wrap a user list allow curators to define a segment of inventory that is based on audiences the curator creates with a linked Data Manager account. The user list ID for an audience can be retrieved using the Data Manager API. |

## State

Output only. Use the activate and deactivate method to change state.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Default value. |
| `ACTIVE` | The data segment is active. |
| `INACTIVE` | The data segment is inactive. |
| `SUSPENDED` | The data segment is suspended and cannot be activated. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/activate` | Activates a data segment. |
| ### `https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/create` | Creates a data segment owned by the listed curator. |
| ### `https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/deactivate` | Deactivates a data segment. |
| ### `https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/get` | Gets a data segment given its name. |
| ### `https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/list` | List the data segments owned by a curator. |
| ### `https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments/patch` | Updates a data segment. |