Attention:Vous consultez la documentation de l'interface REST de l'API. La plupart de nos bibliothèques clientes officielles utilisent gRPC. Pour en savoir plus, consultez la présentation de REST.

Cette page a été traduite par l'API Cloud Translation.

CustomAudience

Représentation JSON
CustomAudienceStatus
CustomAudienceType
CustomAudienceMember
- Représentation JSON
CustomAudienceMemberType

Une audience personnalisée Il s'agit d'une liste d'utilisateurs par centres d'intérêt.

Représentation JSON

Représentation JSON
{ "resourceName": string, "id": string, "status": enum (`CustomAudienceStatus`), "name": string, "type": enum (`CustomAudienceType`), "description": string, "members": [ { object (`CustomAudienceMember`) } ] }

{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}

Champs
`resourceName`	`string` Immuable. Nom de ressource de l'audience personnalisée. Les noms de ressources d'audience personnalisées ont la forme suivante: `customers/{customerId}/customAudiences/{custom_audience_id}`
`id`	`string (int64 format)` Uniquement en sortie. ID de l'audience personnalisée.
`status`	`enum (CustomAudienceStatus)` Uniquement en sortie. État de cette audience personnalisée. Indique si l'audience personnalisée est activée ou supprimée.
`name`	`string` Nom de l'audience personnalisée. Il doit être unique pour toutes les audiences personnalisées créées par un client. Ce champ est obligatoire pour créer des opérations.
`type`	`enum (CustomAudienceType)` Type de l'audience personnalisée. ("INTEREST" OU "PURCHASE_INTENT" n'est pas autorisé pour les audiences personnalisées nouvellement créées, mais est conservé pour les audiences existantes)
`description`	`string` Description de cette audience personnalisée.
`members[]`	`object (CustomAudienceMember)` Liste des membres de l'audience personnalisée. Vous pouvez ajouter des membres lors de la création d'une CustomAudience. Si des membres sont présentés dans l'opération UPDATE, les membres existants seront remplacés.

CustomAudienceStatus

Enum contenant les états possibles des audiences personnalisées.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé uniquement pour la valeur renvoyée. Représente la valeur inconnue dans cette version.
`ENABLED`	État activé : l'audience personnalisée est activée et peut être ciblée.
`REMOVED`	État "Supprimé" : l'audience personnalisée est supprimée et ne peut plus être utilisée pour le ciblage.

CustomAudienceType

Énumération contenant les types d'audience personnalisée possibles.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé uniquement pour la valeur renvoyée. Représente la valeur inconnue dans cette version.
`AUTO`	Google Ads sélectionnera automatiquement la meilleure interprétation au moment de la diffusion.
`INTEREST`	associe les utilisateurs à leurs centres d'intérêt.
`PURCHASE_INTENT`	Associe les utilisateurs aux sujets qu'ils recherchent ou aux produits qu'ils envisagent d'acheter.
`SEARCH`	Correspond aux utilisateurs en fonction de ce qu'ils ont recherché dans la recherche Google.

CustomAudienceMember

Membre de l'audience personnalisée. Un membre peut être un MOT_CLE, une URL, une PLACE_CATEGORY ou une APPLICATION. Vous ne pouvez le créer ou le supprimer que, mais pas le modifier.

Représentation JSON

Représentation JSON
{ "memberType": enum (`CustomAudienceMemberType`), // Union field `value` can be only one of the following: "keyword": string, "url": string, "placeCategory": string, "app": string // End of list of possible types for union field `value`. }

{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}

Champs
`memberType`	`enum (CustomAudienceMemberType)` Type de membre de l'audience personnalisée : MOT_CLE, URL, PLACE_CATEGORY ou APPLICATION.
Champ d'union `value`. Valeur CustomAudienceMember. Un champ est renseigné en fonction du type de membre. `value` ne peut être qu'un des éléments suivants :
`keyword`	`string` Un mot clé ou une expression clé (10 mots et 80 caractères au maximum). Les langues utilisant des caractères double largeur, comme le chinois, le coréen et le japonais, sont limitées à 40 caractères pour décrire les centres d'intérêt ou les actions de l'utilisateur.
`url`	`string` URL HTTP, protocole inclus (2 048 caractères maximum), qui inclut les contenus qui intéressent les utilisateurs.
`placeCategory`	`string (int64 format)` Type de lieu décrit par une catégorie de lieux que les utilisateurs visitent.
`app`	`string` Nom de package des applications Android installées par les utilisateurs, par exemple com.google.example.

CustomAudienceMemberType

Énumération contenant les types de membres d'audience personnalisée possibles.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé uniquement pour la valeur renvoyée. Représente la valeur inconnue dans cette version.
`KEYWORD`	Utilisateurs dont les centres d'intérêt ou les actions sont décrits par un mot clé.
`URL`	Utilisateurs ayant des centres d'intérêt liés au contenu du site Web.
`PLACE_CATEGORY`	Utilisateurs qui visitent les types de lieux décrits par une catégorie de lieux.
`APP`	Utilisateurs ayant installé une application mobile