REST Resource: advertisers.adGroups

L'

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)
  }
}
Champs
name

string

Nom de ressource du groupe d'annonces.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Nom à afficher du groupe d'annonces.

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

enum (AdGroupFormat)

Format des annonces du groupe d'annonces.
bidStrategy

object (BiddingStrategy)

Stratégie d'enchères utilisée par le groupe d'annonces. Seul le champ youtubeAndPartnersBid peut être utilisé dans la stratégie d'enchères.
entityStatus

enum (EntityStatus)

Indique 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)

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

object (ProductFeedData)

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

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 axés sur la 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.

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 faire correspondre les produits.
isFeedDisabled

boolean

Indique si le flux de produits a été désactivé pour 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 ont été mis en correspondance.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Des produits spécifiques sont sélectionnés.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Faites correspondre les produits en fonction de leurs étiquettes personnalisées.

ProductMatchDimension

Dimension utilisée pour faire correspondre les produits.

Représentation JSON 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
Champs
Champ d'union dimension. Dimension et valeur sur lesquelles faire correspondre le produit. dimension ne peut être qu'un des éléments suivants :
productOfferId

string

ID de l'offre de produit à associer à un produit portant le même ID d'offre.
customLabel

object (CustomLabel)

Étiquette personnalisée à associer à tous les produits portant cette étiquette.

CustomLabel

Clé et valeur d'un libellé personnalisé.

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

enum (CustomLabelKey)

Clé du libellé.
value

string

Valeur du libellé.

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.

Méthodes

bulkListAdGroupAssignedTargetingOptions

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

get

 Récupère un groupe d'annonces.

list

 Liste les groupes d'annonces.