REST Resource: curators.dataSegments

Recurso: DataSegment

Define um identificador para um segmento de inventário que pode ser segmentado por curadores ou planejadores de mídia na interface de pacotes de transações ou leilões. A curadoria do inventário é feita por curadores em plataformas externas. -- Próximo ID: 9 --

Representação 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
}
Campos
name

string

Imutável. Identificador. O identificador exclusivo do segmento de dados. O ID da conta corresponde ao ID da conta que criou o segmento. Formato: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}
createTime

string (Timestamp format)

Apenas saída. Horário em que o segmento de dados foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Horário em que o segmento de dados foi atualizado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (State)

Apenas saída. O estado do segmento de dados.
Campo de união fee. A taxa será cobrada quando outras contas usarem esse segmento de dados. Por exemplo, quando outras contas adicionam esse segmento de dados a um pacote de transação ou leilão. O tipo de taxa do segmento de dados não pode ser alterado depois de definido. fee pode ser apenas de um dos tipos a seguir:
cpmFee

object (Money)

Opcional. Uma taxa fixa cobrada por mil impressões. Depois de definido, o código da moeda não pode ser alterado.
millipercentOfMediaFee

string (int64 format)

Opcional. A taxa será cobrada como uma porcentagem do custo da impressão, representada em milésimos percentuais. Por exemplo, 1% é representado como 1000.
userListId

string

Opcional. Imutável. O ID da lista de usuários encapsulada por esse segmento de dados.

Os curadores com uma conta de parceiro de dados vinculada podem criar um segmento de dados que encapsula uma lista de usuários pertencente à conta de parceiro de dados vinculada. As listas de usuários podem ser enviadas e gerenciadas usando a API Data Manager. Ao vincular uma lista de usuários a um segmento de dados, você pode definir um segmento de inventário com base em um público-alvo criado.

Estado

Apenas saída. Use o método ativar e desativar para mudar o estado.

Tipos enumerados
STATE_UNSPECIFIED Valor padrão.
ACTIVE O segmento de dados está ativo.
INACTIVE O segmento de dados está inativo.
SUSPENDED O segmento de dados está suspenso e não pode ser ativado.

Métodos

activate

 Ativa um segmento de dados.

create

 Cria um segmento de dados pertencente ao curador listado.

deactivate

 Desativa um segmento de dados.

get

 Recebe um segmento de dados com base no nome dele.

list

 Lista os segmentos de dados pertencentes a um curador.

patch

 Atualiza um segmento de dados.