REST Resource: exchanges.orders

Ressource : Order

Offre non négociable que l'acheteur doit accepter.

Représentation JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
Champs
name

string

Nom de ressource relatif pour la commande. Généré par le serveur. Exemple : "exchanges/1234/orders/5678". Uniquement en sortie.
displayName

string

Nom de la commande affiché pour l'acheteur. 250 caractères maximum. Facultatif.
partnerId[]

string (int64 format)

ID de partenaire dans Google Display & Video 360, anciennement DoubleClick Bid Manager(DBM). N'autorise qu'un seul ID de partenaire. Obligatoire.
publisherEmail

string

Adresse e-mail de l'éditeur. Veuillez saisir un format d'adresse e-mail valide. 250 caractères maximum. Facultatif.
publisherName

string

Nom de l'éditeur. 250 caractères maximum. Obligatoire.
budget

object (Budget)

Uniquement en sortie. Budget défini par l'acheteur. Applicable uniquement aux scénarios d'offre instantanée.
status

enum (OrderStatus)

État de la commande. L'état peut changer une fois que les utilisateurs DV3 ont accepté, annulé ou archivé une commande. Prise en charge de la mise à jour sur "ANNULÉ" après la création dans l'API pour indiquer que cette commande a été annulée sur la plate-forme d'échange.
wseatConfig

object (WSeatConfig)

Facultatif. Configuration WSeat : spécifie la configuration WSeat côté plate-forme d'échange. Les plates-formes d'échange qui utilisent des accords multisieges doivent veiller à ce que ce champ soit renseigné et à jour.
updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de la commande ou de ses produits sous-jacents.

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".
buyerInfo

object (BuyerInfo)

Uniquement en sortie. Informations sur l'acheteur, y compris les détails du partenaire et de l'annonceur. Applicable uniquement aux scénarios d'offre instantanée.

Budget

Budget spécifié.

Représentation JSON 
{
  "budgetType": enum (BudgetType),

  // Union field budget can be only one of the following:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of list of possible types for union field budget.
}
Champs
budgetType

enum (BudgetType)

Type de budget spécifié.
Champ d'union budget. Un seul type de budget peut être inclus. budget ne peut être qu'un des éléments suivants :
impressions

string (int64 format)

Budget d'impression.
money

object (Money)

Budget dans une devise.

BudgetType

Types de budget

Enums
BUDGET_TYPE_UNSPECIFIED Budget non spécifié. Non valide pour la saisie.
BUDGET_TYPE_CURRENCY Budget dans une devise.
BUDGET_TYPE_IMPRESSION Budget d'impression.

OrderStatus

État de la commande.

Enums
ORDER_STATUS_UNSPECIFIED État de la commande non spécifié. Inattendu. Indique que l'état de la négociation est inconnu. Valeur saisie non valide.
PENDING_ACCEPTANCE État de la commande : en attente d'acceptation.
ACCEPTED L'état de la commande est "Acceptée".
ARCHIVED L'état de la commande a été archivé.
CANCELLED L'état de la commande est "Annulée".
NEGOTIATING L'état de la commande est "En cours de négociation". Applicable uniquement aux scénarios d'offres instantanées.

WSeatConfig

Configuration WSeat.

Représentation JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Champs
exchangeWseatStatus

enum (WSeatStatus)

Facultatif. État actuel de la configuration WSeat côté plate-forme d'échange.
exchangeWseatIds[]

string (int64 format)

Facultatif. ID WSeat côté place de marché.
updateTime

string (Timestamp format)

Uniquement en sortie. Ce champ est mis à jour automatiquement par DV3 lorsque la configuration WSeatConfiguration est modifiée par la place de marché.

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".

WSeatStatus

Options d'énumération de l'état WSeat.

Enums
W_SEAT_STATUS_UNSPECIFIED WSeatStatus non spécifié.
W_SEAT_STATUS_ENFORCED WSeatStatus appliqué. Indique que l'échange applique le WSeatId en l'envoyant à DV3 ou en vérifiant les wseatids dans les réponses aux enchères.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus non appliqué. Indique que la place de marché n'envoie pas de wseatid dans les demandes d'enchères et ne le valide pas.

BuyerInfo

Informations sur l'acheteur pour les scénarios d'accord instantané.

Représentation JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Champs
partner

object (PartnerInfo)

Uniquement en sortie. Informations sur le partenaire
advertisers[]

object (AdvertiserInfo)

Uniquement en sortie. Informations sur l'annonceur.

PartnerInfo

Informations sur les partenaires pour les scénarios d'accord instantané.

Représentation JSON 
{
  "title": string
}
Champs
title

string

Uniquement en sortie. Titre à afficher du partenaire dans Display & Video 360.

AdvertiserInfo

Informations sur l'annonceur pour les scénarios d'accord instantané.

Représentation JSON 
{
  "advertiserId": string,
  "domainUri": string
}
Champs
advertiserId

string (int64 format)

Uniquement en sortie. Référence annonceur dans Display & Video 360.
domainUri

string

Uniquement en sortie. URI du domaine du site Web de l'annonceur.

Méthodes

accept

 Accepte la commande.

create

 Crée une commande.

get

 Récupère la commande.

list

 Ordre des listes.

patch

 Met à jour une commande.