REST Resource: curators.dataSegments

Источник: DataSegment

Определяет идентификатор сегмента рекламного инвентаря, который может быть использован кураторами или медиапланерами в пользовательском интерфейсе сделок или аукционных пакетов. Курирование инвентаря осуществляется кураторами на внешних платформах. -- Следующий ID: 9 --

JSON-представление 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // Union field fee can be only one of the following:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of list of possible types for union field fee.
  "userListId": string
}
Поля
name

string

Неизменяемый. Идентификатор. Уникальный идентификатор сегмента данных. Идентификатор учетной записи соответствует идентификатору учетной записи, создавшей сегмент. Формат: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string ( Timestamp format)

Только вывод. Время создания сегмента данных.

Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

updateTime

string ( Timestamp format)

Только вывод. Время последнего обновления сегмента данных.

Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

state

enum ( State )

Только вывод. Состояние сегмента данных.

fee использование данных профсоюза. Комиссия будет взиматься, когда другие учетные записи используют этот сегмент данных. Например, когда другие учетные записи добавляют этот сегмент данных в пакет сделки или аукциона. Тип комиссии сегмента данных нельзя изменить после установки. fee может быть только одной из следующих:
cpmFee

object ( Money )

Необязательно. Фиксированная плата взимается за тысячу показов. После установки код валюты изменить нельзя.

millipercentOfMediaFee

string ( int64 format)

Необязательно. Плата будет взиматься в процентах от стоимости оттиска, выраженных в миллипроцентах. Например, 1% обозначается как 1000.

userListId

string

Необязательный. Неизменяемый. Идентификатор списка пользователей, заключенного в этот сегмент данных.

Кураторы, имеющие связанную учетную запись партнера по данным, могут создавать сегмент данных, который включает список пользователей, принадлежащий этой учетной записи. Списки пользователей можно загружать и управлять ими с помощью API менеджера данных . Связывание списка пользователей с сегментом данных позволяет определить сегмент инвентаря на основе созданной вами аудитории.

Состояние

Только вывод. Для изменения состояния используйте методы активации и деактивации.

Перечисления
STATE_UNSPECIFIED Значение по умолчанию.
ACTIVE Сегмент данных активен.
INACTIVE Данный сегмент данных неактивен.
SUSPENDED Данный сегмент данных приостановлен и не может быть активирован.

Методы

activate

 Активирует сегмент данных.

create

 Создает сегмент данных, принадлежащий указанному куратору.

deactivate

 Деактивирует сегмент данных.

get

 Получает сегмент данных по его имени.

list

 Перечислите сегменты данных, принадлежащие куратору.

patch

 Обновляет сегмент данных.