REST Resource: curators.dataSegments

Ressource : DataSegment

Définit un identifiant pour un segment d'inventaire pouvant être ciblé par les curateurs ou les média-planners dans l'UI des accords ou des packages d'enchères. La curation de l'inventaire est effectuée par des curateurs sur des plates-formes externes. -- Next ID: 9 --

Représentation 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
}
Champs
name

string

Immuable. Identifiant. Identifiant unique du segment de données. L'ID de compte correspond à l'ID du compte qui a créé le segment. Format : curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

Uniquement en sortie. Heure de création du segment de données.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour du segment de données.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

state

enum (State)

Uniquement en sortie. État du segment de données.

Des frais seront facturés lorsque d'autres comptes utiliseront ce segment de données. Par exemple, lorsque d'autres comptes ajoutent ce segment de données à un accord ou à un package d'enchères. Une fois défini, le type de frais du segment de données ne peut plus être modifié. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
cpmFee

object (Money)

Facultatif. Frais fixes facturés pour mille impressions. Une fois défini, le code de la devise ne peut plus être modifié.

millipercentOfMediaFee

string (int64 format)

Facultatif. Les frais seront facturés sous forme de pourcentage du coût de l'impression, exprimé en millièmes de pour cent. Par exemple, 1 % est représenté par 1 000.

Fin des champs mutuellement exclusifs.
userListId

string

Facultatif. Immuable. ID de la liste d'utilisateurs encapsulée par ce segment de données.

Les curateurs disposant d'un compte de partenaire pour les données associé peuvent créer un segment de données qui encapsule une liste d'utilisateurs appartenant au compte de partenaire pour les données associé. Vous pouvez importer et gérer des listes d'utilisateurs à l'aide de l'API Data Manager. Associer une liste d'utilisateurs à un segment de données vous permet de définir un segment d'inventaire basé sur une audience que vous créez.

État

Uniquement en sortie. Utilisez les méthodes d'activation et de désactivation pour modifier l'état.

Enums
STATE_UNSPECIFIED Valeur par défaut.
ACTIVE Le segment de données est actif.
INACTIVE Le segment de données est inactif.
SUSPENDED Le segment de données est suspendu et ne peut pas être activé.

Méthodes

activate

Active un segment de données.

create

Crée un segment de données appartenant au curateur indiqué.

deactivate

Désactive un segment de données.

get

Récupère un segment de données en fonction de son nom.

list

Répertorie les segments de données appartenant à un curateur.

patch

Met à jour un segment de données.