REST Resource: exchanges.publishers

Ressource: Éditeur

Encapsule un seul éditeur.

Représentation JSON
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
Champs
name

string

Uniquement en sortie. Nom de route relatif de cet éditeur. Doit être au format "exchanges/{seller_id}/publishers/{publisherId}". Exemple : "exchanges/1234/publishers/5678".

externalPublisherId

string

Obligatoire. [OBSOLÈTE] Ce champ sera bientôt remplacé par externalPublisherIds[]. Identifiant unique de l'éditeur fourni par Exchange. Doit correspondre à l'ID de l'éditeur envoyé dans les demandes d'enchère.

100 caractères max. Les caractères autorisés sont les caractères alphanumériques, les traits de soulignement, les tirets et les points.

externalPublisherIds[]

string

Facultatif. ID d'éditeur fournis par la place de marché. Chaque ID doit être unique et correspondre à l'ID de l'éditeur envoyé dans les requêtes d'enchères.

10 comptes maximum. 100 caractères maximum par pièce d'identité. Les caractères autorisés sont les caractères alphanumériques, les traits de soulignement, les tirets et les points.

displayName

string

Obligatoire. Nom à afficher de cet éditeur. Doit être encodé en UTF-8 et ne pas dépasser 30 caractères.

status

enum (DiscoveryObjectStatus)

Obligatoire. État de cet éditeur. Les éditeurs dont l'état est "EN PAUSE" ou "SUPPRIMÉ" ne sont pas présentés aux annonceurs DV3.

mediumCapability

enum (MediumCapability)

Obligatoire. Supports sur lesquels cet éditeur prévoit d'héberger ses annonces.

description

string

Obligatoire. Texte de la description de cet éditeur. Doit être encodé en UTF-8 et ne pas dépasser 1 000 caractères. Obligatoire.

contactInfo[]

string

Obligatoire. Adresses e-mail des points de contact permettant aux annonceurs de communiquer avec l'éditeur. 10 contacts maximum 100 caractères maximum par contact. Exemple: [Contact aux États-Unis - John Smith: john.smith@abc.com] Obligatoire.

commitmentCapability[]

enum (CommitmentCapability)

Facultatif. Types d'engagements acceptés par cet éditeur.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Obligatoire. Répartition des prévisions pour l'inventaire de cet éditeur. Les annonceurs DV3 peuvent voir et filtrer ces répartitions. Veuillez indiquer la répartition des prévisions par domaine.

logoUrl

string

Uniquement en sortie. URL du logo de cet éditeur.

floorPrice

object (Money)

Facultatif. Prix plancher de cet éditeur. Doit avoir le même code de devise que le prix plafond.

ceilingPrice

object (Money)

Facultatif. Prix plafond de cet éditeur. Le code de devise doit être identique à celui du prix plancher.

generalCapability

string

Facultatif.

tvMetadata

object (TVMetadata)

Facultatif. Métadonnées pour les éditeurs proposant des offres TV. Obligatoire lorsque la capacité de support contient la télévision. Non applicable lorsque la capacité de support n'inclut pas la télévision.

urgOwners[]

enum (UnderRepresentedGroup)

Facultatif. Groupes sous-représentés dont le propriétaire est membre, le cas échéant

MediumCapability

Énumération des fonctionnalités moyennes. L'interface de la place de marché (dans le module "Inventaire" de DV360) comprend différentes sections pour l'inventaire. "Numérique: inclut les éditeurs et les packages d'enchères couvrant l'inventaire display, vidéo (y compris la TV connectée et le service de distribution par contournement) et audio." "TV" : nouvelle section dédiée à la découverte de l'inventaire de TV connectée et de service de distribution par contournement (OTT). La TV connectée et l'OTT sont définis comme suit: "La TV connectée (CTV) inclut tous les appareils correspondant aux descriptions suivantes: - Appareils connectés ou de streaming: appareils qui se connectent à un écran de télévision pour diffuser des vidéos (Roku, Apple TV, etc.) - Smart TV: téléviseurs avec connexion Internet intégrée (Smart TV Samsung, etc.) - Consoles de jeu: consoles de jeu connectées à Internet (Xbox, PlayStation, Wii, etc.) - Boîtiers décodeurs: appareils donnant accès à du contenu classique via le câble et la vidéo à la demande." "Over the Top (OTT)" désigne les contenus vidéo semblables à la télévision diffusés par un fournisseur de contenus vidéo sur Internet, en dehors des réseaux fermés des fournisseurs de télécommunications et de services de télévision par câble. Les vidéos OTT peuvent être visionnées sur ordinateur, mobile, tablette, ainsi que sur des TV connectées ou des boîtiers décodeur (à condition que le contenu soit diffusé via IP pour ces derniers). "Audio: section dédiée récemment lancée pour l'inventaire audio." "OOH: éditeurs de publicité extérieure numérique."

Enums
MEDIUM_CAPABILITY_UNSPECIFIED Capacité moyenne non spécifiée. Saisie non valide.
MEDIUM_CAPABILITY_DIGITAL Capacité numérique moyenne.
MEDIUM_CAPABILITY_TV Téléviseur de capacité moyenne
MEDIUM_CAPABILITY_AUDIO Audio de capacité moyenne.
MEDIUM_CAPABILITY_OOH Fonctionnalité moyenne en dehors de la maison.

CommitmentCapability

Énumération des capacités d'engagement.

Enums
COMMITMENT_CAPABILITY_UNSPECIFIED La capacité d'engagement n'est pas spécifiée. Saisie non valide.
COMMITMENT_CAPABILITY_GUARANTEED L'éditeur dispose d'un inventaire garanti.
COMMITMENT_CAPABILITY_NON_GUARANTEED L'éditeur dispose d'un inventaire non garanti.

TVMetadata

Métadonnées des éditeurs proposant des offres TV.

Représentation JSON
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
Champs
tvDeliveryType

enum (TVDeliveryType)

Obligatoire. Type de diffusion des annonces télévisées.

topShows[]

string

Facultatif. Liste des titres de séries TV les plus populaires appartenant à l'éditeur. Taille maximale : 10. Le fichier doit être encodé au format UTF-8.

TVDeliveryType

Énumération des types de diffusion pour la télévision.

Enums
TV_DELIVERY_TYPE_UNSPECIFIED Type de diffusion TV non spécifié. Saisie non valide.
TV_DELIVERY_TYPE_CTV Type de diffusion TV : TV connectée.
TV_DELIVERY_TYPE_LINEAR_TV Type de diffusion TV : télévision linéaire.

Méthodes

create

Crée un éditeur.

get

Récupère un éditeur.

list

Répertorie les éditeurs.

patch

Met à jour un éditeur.
Importer le logo de l'éditeur.