Method: advertisers.lineItems.bulkUpdate

Met à jour plusieurs éléments de campagne.

Impossible d'envoyer des requêtes à ce point de terminaison en même temps que les demandes suivantes mettant à jour le même élément de campagne:

Vous ne pouvez pas créer ni modifier d'éléments de campagne YouTube et partenaires à l'aide de l'API.

Requête HTTP

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkUpdate

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
advertiserId

string (int64 format)

Obligatoire. Référence de l'annonceur auquel appartient cet élément de campagne.

Corps de la requête

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

Représentation JSON 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Champs
lineItemIds[]

string (int64 format)

Obligatoire. ID des éléments de campagne à mettre à jour.
targetLineItem

object (LineItem)

Obligatoire. Un objet d'élément de campagne contenant les champs à mettre à jour et les nouvelles valeurs à attribuer à tous les éléments de campagne spécifiés dans lineItemIds.
updateMask

string (FieldMask format)

Obligatoire. Masque de champ identifiant les champs à mettre à jour.

Actuellement, seuls les champs suivants sont acceptés:

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

Message de réponse pour LineItemService.BulkUpdateLineItems.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Champs
updatedLineItemIds[]

string (int64 format)

Identifiants des éléments de campagne mis à jour.
failedLineItemIds[]

string (int64 format)

Identifiants des éléments de campagne qui n'ont pas pu être mis à jour.
skippedLineItemIds[]

string (int64 format)

Identifiants des éléments de campagne ignorés lors des mises à jour. Par exemple, les opérations mutate inutiles qui n'entraînent aucune modification des éléments de campagne ne sont ignorées, et le suivi des ID d'élément de campagne correspondants peut s'effectuer ici.
errors[]

object (Status)

Erreurs renvoyées par les éléments de campagne n'ayant pas pu être mis à jour.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/display-video

Pour en savoir plus, consultez la présentation d'OAuth 2.0.