REST Resource: curators.dataSegments
Stay organized with collections
Save and categorize content based on your preferences.
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,
"cpmFee": {
object (Money )
},
"state": enum (State )
} |
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 (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" .
|
updateTime |
string (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" .
|
cpmFee |
object (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.
|
state |
enum (State )
Output only. The state of the data segment.
|
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. |
Methods |
|
Activates a data segment. |
|
Creates a data segment owned by the listed curator. |
|
Deactivates a data segment. |
|
Gets a data segment given its name. |
|
List the data segments owned by a curator. |
|
Updates a data segment. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-12 UTC.
[null,null,["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. |"]]