Method: advertisers.lineItems.generateDefault

Crée un élément de campagne avec des paramètres (y compris le ciblage) hérités de l'ordre d'insertion et un ENTITY_STATUS_DRAFT entityStatus. Si la requête aboutit, elle affiche l'élément de campagne créé. Des valeurs par défaut sont définies en fonction des trois champs :

Il est impossible de créer ni de modifier des éléments de campagne YouTube et partenaires à l'aide de l'API.

Requête HTTP

POST https://displayvideo.googleapis.com/v4/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. ID 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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Champs
insertionOrderId

string (int64 format)

Obligatoire. Identifiant 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 et ne pas dépasser 240 octets.
lineItemType

enum (LineItemType)

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

object (MobileApp)

Application mobile promue par l'élément de campagne.

Cela ne s'applique que lorsque lineItemType est LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL ou LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Indique si cet élément de campagne diffusera des annonces à caractère politique dans l'Union européenne.

Si containsEuPoliticalAds a été défini sur DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING dans l'annonceur parent, ce champ sera défini sur DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING s'il n'est pas spécifié autrement. Vous pouvez ensuite mettre à jour ce champ à l'aide de l'UI, de l'API ou des fichiers de données structurées.

Ce champ doit être attribué lorsque vous créez un élément de campagne. Sinon, la requête advertisers.lineItems.create échouera.

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 plus d'informations, consultez la OAuth 2.0 Overview.