Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Modifie de manière groupée les options de ciblage de 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 compatible qu'avec les groupes d'annonces Demand Gen.

Requête HTTP

POST https://displayvideo.googleapis.com/v5/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 les options de ciblage attribuées appartiendront. Vous pouvez spécifier jusqu'à 25 ID de groupe d'annonces.
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

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

Types de ciblage acceptés :

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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 la forme d'une liste de CreateAssignedTargetingOptionRequest.

Types de ciblage acceptés :

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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 bien été mis à jour.
failedAdGroupIds[]

string (int64 format)

Uniquement en sortie. ID des groupes d'annonces dont la mise à jour a échoué.
errors[]

object (Status)

Uniquement en sortie. Informations sur l'erreur pour chaque groupe d'annonces dont la mise à jour a échoué.

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.