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 transações ou pacotes de leilão. A curadoria do inventário é feita por curadores em plataformas externas. -- Next ID: 9 --

Representação JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "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. Hora 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. Hora 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.

A taxa será cobrada quando outras contas usarem esse segmento de dados. Por exemplo, quando outras contas adicionam esse segmento de dados a uma transação ou um pacote de leilão. Não é possível mudar o tipo de taxa do segmento de dados depois que ele é definido. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
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 de impressão, representada em milésimos de porcentagem. Por exemplo, 1% é representado como 1000.

Fim dos campos mutuamente exclusivos.
userListId

string

Opcional. Imutável. O ID da lista de usuários incluída neste segmento de dados.

Os curadores com uma conta de parceiro de dados vinculada podem criar um segmento de dados que envolve uma lista de usuários de propriedade da conta de parceiro de dados vinculada. É possível fazer upload e gerenciar listas de usuários 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 que você criar.

Estado

Apenas saída. Use os métodos de ativação e desativação 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 de propriedade do curador listado.

deactivate

Desativa um segmento de dados.

get

Recebe um segmento de dados pelo nome.

list

Lista os segmentos de dados que pertencem a um curador.

patch

Atualiza um segmento de dados.