Method: exchanges.orders.patch

Met à jour une commande.

Requête HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
order.name

string

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

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "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.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
Champs
order.displayName

string

Nom de la commande affiché pour l'acheteur. 250 caractères maximum. Facultatif.
order.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.
order.publisherEmail

string

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

string

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

object (Budget)

Uniquement en sortie. Budget défini par l'acheteur. Applicable uniquement aux scénarios d'offre instantanée.
order.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.
order.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.
order.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".
order.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.
updateMask

string (FieldMask format)

Masque permettant de contrôler les champs à mettre à jour. Obligatoire.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Order.

Champs d'application des autorisations

Requiert l'habilitation OAuth suivante :

  • https://www.googleapis.com/auth/doubleclickbidmanager

Pour plus d'informations, consultez la OAuth 2.0 Overview.