Method: advertisers.lineItems.generateDefault

Permet de créer un élément de campagne avec des paramètres (y compris le ciblage) hérités de l'ordre d'insertion et une entityStatus de type "ENTITY_STATUS_DRAFT". Si l'opération réussit, l'élément de campagne nouvellement créé est renvoyé. Il existe des valeurs par défaut basées sur les trois champs:

Impossible de créer ou de modifier des éléments de campagne YouTube et partenaires via l'API.

Requête HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:generateDefault

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
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
Champs
insertionOrderId

string (int64 format)

Obligatoire. ID unique de l'ordre d'insertion auquel appartient l'élément de campagne.

displayName

string

Obligatoire. Nom à afficher de l'élément de campagne.

Doit être encodé au format UTF-8 avec une taille maximale de 240 octets.

lineItemType

enum (LineItemType)

Obligatoire. Type de l'élément de campagne.

mobileApp

object (MobileApp)

Application mobile dont l'élément de campagne fait la promotion.

Cela n'est applicable que lorsque lineItemType est défini sur LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL ou LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

Corps de la réponse

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

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.