REST Resource: advertisers.adGroups

Ressource : AdGroup

Un seul groupe d'annonces associé à un élément de campagne.

Représentation JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
Champs
name

string

Uniquement en sortie. Identifiant. Nom de ressource du groupe d'annonces.
advertiserId

string (int64 format)

Uniquement en sortie. Identifiant unique de l'annonceur auquel appartient le groupe d'annonces.
adGroupId

string (int64 format)

Uniquement en sortie. Identifiant unique du groupe d'annonces. Attribué par le système.
lineItemId

string (int64 format)

Obligatoire. Immuable. Identifiant unique de l'élément de campagne auquel appartient le groupe d'annonces.
displayName

string

Obligatoire. Nom à afficher du groupe d'annonces.

Doit être encodé en UTF-8 et ne pas dépasser 255 octets.
adGroupFormat

enum (AdGroupFormat)

Obligatoire. Immuable. Format des annonces du groupe d'annonces.
bidStrategy

object (BiddingStrategy)

Facultatif. Stratégie d'enchères utilisée par le groupe d'annonces. Seuls les champs youtubeAndPartnersBid et demandGenBid peuvent être utilisés dans la stratégie d'enchères.
entityStatus

enum (EntityStatus)

Obligatoire. Détermine si le groupe d'annonces peut dépenser son budget et enchérir sur l'inventaire.

Si l'élément de campagne parent du groupe d'annonces n'est pas actif, le groupe d'annonces ne peut pas dépenser son budget, même si son propre état est ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

Facultatif. Paramètres de ciblage optimisé du groupe d'annonces.
productFeedData

object (ProductFeedData)

Facultatif. Paramètres du flux de produits dans ce groupe d'annonces.
adGroupInventoryControl

object (AdGroupInventoryControl)

Facultatif. Obligatoire pour les groupes d'annonces Demand Gen. Spécifie l'outil d'optimisation d'inventaire du groupe d'annonces.
adSource

enum (AdSource)

Facultatif. Source des annonces de ce groupe d'annonces. Ce champ n'est utilisé que lorsque les annonces sont générées automatiquement à partir d'une source donnée.
creativeAssignments[]

object (CreativeAssignment)

Facultatif. Créations utilisées pour générer des annonces dans le groupe d'annonces.

Ce champ ne peut être attribué que si adSource est défini sur AD_SOURCE_DV360_CREATIVE.

AdGroupFormat

Format du groupe d'annonces.

Enums
AD_GROUP_FORMAT_UNSPECIFIED La valeur du format n'est pas spécifiée ou est inconnue dans cette version.
AD_GROUP_FORMAT_IN_STREAM Annonces InStream.
AD_GROUP_FORMAT_VIDEO_DISCOVERY Annonces In-Feed.
AD_GROUP_FORMAT_BUMPER Les annonces bumper.
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Annonces InStream non désactivables
AD_GROUP_FORMAT_AUDIO Annonces audio InStream non désactivables.
AD_GROUP_FORMAT_RESPONSIVE Annonces responsives.
AD_GROUP_FORMAT_REACH Groupes d'annonces de couverture efficace, y compris les annonces InStream et bumper.
AD_GROUP_FORMAT_MASTHEAD Bannière Masthead diffusée en haut de la page d'accueil YouTube.
AD_GROUP_FORMAT_DEMAND_GEN Annonces Demand Gen.

ProductFeedData

Détails du flux de produits.

Représentation JSON 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Champs
productMatchType

enum (ProductMatchType)

Comment les produits sont sélectionnés par le flux de produits.
productMatchDimensions[]

object (ProductMatchDimension)

Liste des dimensions utilisées pour mettre en correspondance les produits.
isFeedDisabled

boolean

Indique si le flux de produits a désactivé l'affichage des produits.

ProductMatchType

Types de méthodes de mise en correspondance des produits.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED Non spécifié ou inconnu.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS Tous les produits sont mis en correspondance.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Des produits spécifiques sont sélectionnés.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Mettez en correspondance les produits en fonction de leurs étiquettes personnalisées.

ProductMatchDimension

Dimension utilisée pour faire correspondre les produits.

Représentation JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
Champs
Dimension et valeur sur lesquelles faire correspondre le produit. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
productOfferId

string

ID de l'offre de produit à faire correspondre à un produit ayant le même ID d'offre.
customLabel

object (CustomLabel)

Étiquette personnalisée permettant de faire correspondre tous les produits portant l'étiquette.
Fin des champs mutuellement exclusifs.

CustomLabel

Clé et valeur d'une étiquette personnalisée.

Représentation JSON 
{
  "key": enum (CustomLabelKey),
  "value": string
}
Champs
key

enum (CustomLabelKey)

Clé de l'étiquette.
value

string

Valeur de l'étiquette.

CustomLabelKey

Clé de l'étiquette personnalisée

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED Non spécifié ou inconnu.
CUSTOM_LABEL_KEY_0 Index de clé 0.
CUSTOM_LABEL_KEY_1 Index de clé 1.
CUSTOM_LABEL_KEY_2 Index de clé 2.
CUSTOM_LABEL_KEY_3 Index de clé 3.
CUSTOM_LABEL_KEY_4 Index de clé 4.

AdGroupInventoryControl

Contrôle de l'inventaire du groupe d'annonces.

Représentation JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
Champs
Contrôle de l'inventaire du groupe d'annonces. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

La stratégie d'inventaire.
selectedInventories

object (SelectedInventories)

Les inventaires sélectionnés.
Fin des champs mutuellement exclusifs.

AdGroupInventoryStrategy

Stratégie d'inventaire pour le groupe d'annonces.

Enums
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED Non spécifié ou inconnu.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY Le groupe d'annonces est activé pour l'ensemble de l'inventaire Google et du Réseau Display.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY Le groupe d'annonces est activé pour l'ensemble de l'inventaire Google.

SelectedInventories

Contrôle de l'inventaire du groupe d'annonces.

Représentation JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
Champs
allowYoutubeStream

boolean

Indique si le groupe d'annonces est activé pour l'inventaire InStream YouTube.
allowYoutubeShorts

boolean

Indique si le groupe d'annonces est activé pour l'inventaire YouTube Shorts.
allowYoutubeFeed

boolean

Indique si le groupe d'annonces est activé pour l'inventaire In-Feed YouTube.
allowDiscover

boolean

Indique si le groupe d'annonces a activé l'inventaire Discover.
allowGmail

boolean

Indique si le groupe d'annonces est activé pour l'inventaire Gmail.
allowGoogleDisplayNetwork

boolean

Indique si le groupe d'annonces est activé pour l'inventaire du Réseau Display de Google.

AdSource

Source des annonces de ce groupe d'annonces.

Enums
AD_SOURCE_UNSPECIFIED Non spécifié ou inconnu. La valeur par défaut est "regular ad source".
AD_SOURCE_DV360_CREATIVE Provient d'une création DV360.

CreativeAssignment

Détails d'une création attribuée au groupe d'annonces.

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

string (int64 format)

Obligatoire. ID de la création Display & Video 360 attribuée au groupe d'annonces.

Méthodes

bulkEditAssignedTargetingOptions

 Modifie de manière groupée les options de ciblage de plusieurs groupes d'annonces.

bulkListAssignedTargetingOptions

 Répertorie les options de ciblage attribuées à plusieurs groupes d'annonces pour différents types de ciblage.

create

 Crée un groupe d'annonces.

delete

 Supprime un groupe d'annonces.

get

 Récupère un groupe d'annonces.

list

 Répertorie les groupes d'annonces.

patch

 Met à jour un groupe d'annonces existant.