REST Resource: advertisers.youtubeAdGroups

Ressource: YoutubeGroup

Groupe d'annonces YouTube unique associé à un élément de campagne YouTube et partenaires.

Représentation JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "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 le groupe d'annonces appartient.
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 le groupe d'annonces appartient.
displayName

string

Nom à afficher du groupe d'annonces.

Il doit être encodé au format UTF-8 et ne doit pas dépasser 255 octets.
youtubeAdIds[]

string (int64 format)

ID des ressources [youtube_ad_group_ad][] associées au groupe d'annonces.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

Format des annonces du groupe d'annonces.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

Stratégie d'enchères utilisée par le groupe d'annonces.
entityStatus

enum (EntityStatus)

Détermine si le groupe d'annonces peut dépenser son budget et définir des enchères sur l'inventaire.

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

object (TargetingExpansionConfig)

Paramètres d'élargissement du ciblage du groupe d'annonces.

Cette configuration ne s'applique que lorsque le ciblage par liste d'audience éligible est attribué au groupe d'annonces.
productFeedData

object (ProductFeedData)

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

YoutubeAndPartnersAdGroupFormat

Format du groupe d'annonces YouTube.

Enums
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED La valeur de format n'est pas spécifiée ou est inconnue dans cette version.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM Annonces InStream.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY Annonces In-Feed.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Les annonces bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Annonces InStream non désactivables.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Annonces audio InStream non désactivables.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Annonces responsives pour les campagnes vidéo pour l'action.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Groupes d'annonces ciblant la couverture effective, y compris les annonces InStream et bumper.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Bannière Masthead qui s'affiche dans l'emplacement supérieur 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)

Mode de sélection des produits par le flux de produits
productMatchDimensions[]

object (ProductMatchDimension)

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

boolean

Indique si l'affichage des produits est désactivé pour le flux de 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 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 à associer au produit. dimension ne peut être qu'un des éléments suivants :
productOfferId

string

Identifiant de l'offre de produit à mettre en correspondance avec un produit ayant le même ID d'offre.
customLabel

object (CustomLabel)

Étiquette personnalisée à associer à tous les produits associés à l'étiquette.

CustomLabel

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

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

enum (CustomLabelKey)

Clé du libellé.
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.

Méthodes

bulkListAdGroupAssignedTargetingOptions

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

get

 Récupère un groupe d'annonces YouTube.

list

 Liste les groupes d'annonces YouTube.