Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

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

Le même ensemble de requêtes de suppression et de création sera appliqué à tous les groupes d'annonces spécifiés. Plus précisément, l'opération supprimera les options de ciblage attribuées fournies dans BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests de chaque groupe d'annonces, puis créera les options de ciblage attribuées fournies dans BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests.

Cette méthode n'est disponible que pour les groupes d'annonces de génération de la demande.

Requête HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

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 appartiennent les groupes d'annonces.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Champs
adGroupIds[]

string (int64 format)

Obligatoire. ID des groupes d'annonces auxquels appartiendront les options de ciblage attribuées. Vous pouvez spécifier jusqu'à 25 ID de groupes d'annonces.

deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

Facultatif. Options de ciblage attribuées à supprimer par lot, spécifiées sous forme de liste de DeleteAssignedTargetingOptionsRequest.

Types de ciblage acceptés :

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

Facultatif. Options de ciblage attribuées à créer par lot, spécifiées sous forme de liste de CreateAssignedTargetingOptionRequest.

Types de ciblage acceptés :

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Corps de la réponse

Message de réponse pour adGroups.bulkEditAssignedTargetingOptions.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Champs
updatedAdGroupIds[]

string (int64 format)

Uniquement en sortie. ID des groupes d'annonces qui ont été mis à jour.

failedAdGroupIds[]

string (int64 format)

Uniquement en sortie. ID des groupes d'annonces qui n'ont pas pu être mis à jour.

errors[]

object (Status)

Uniquement en sortie. Informations sur les erreurs pour chaque groupe d'annonces qui n'a pas pu être mis à jour.

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.