La version v1beta2 de l'API Display & Video 360 a été abandonnée. Les requêtes adressées à une version abandonnée peuvent renvoyer une erreur.
Vous devez utiliser l'API Display & Video 360 version 2. Consultez notre guide de migration pour connaître la procédure de migration de la v1 vers la v2.
Method: targetingTypes.targetingOptions.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Liste les options de ciblage d'un type donné.
Requête HTTP
GET https://displayvideo.googleapis.com/v1beta2/targetingTypes/{targetingType}/targetingOptions
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
targetingType |
enum (TargetingType )
Obligatoire. Type d'option de ciblage à répertorier. Les valeurs acceptées sont les suivantes :
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_VIEWABILITY
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_OMID
|
Paramètres de requête
Paramètres |
advertiserId |
string (int64 format)
Obligatoire. Annonceur pour lequel cette demande est effectuée.
|
pageSize |
integer
Taille de la page demandée. Doit être compris entre 1 et 100 . Si aucune valeur n'est spécifiée, la valeur par défaut est 100 . Renvoie le code d'erreur INVALID_ARGUMENT si une valeur non valide est spécifiée.
|
pageToken |
string
Jeton identifiant une page de résultats que le serveur doit renvoyer. En règle générale, il s'agit de la valeur de nextPageToken renvoyée par l'appel précédent à la méthode targetingOptions.list . Si aucune valeur n'est spécifiée, la première page de résultats est renvoyée.
|
orderBy |
string
Champ selon lequel la liste doit être triée. Les valeurs acceptées sont les suivantes :
targetingOptionId (par défaut)
Par défaut, l'ordre de tri est croissant. Pour spécifier l'ordre décroissant d'un champ, vous devez ajouter le suffixe "desc" au nom du champ. Exemple : targetingOptionId desc
|
filter |
string
Permet de filtrer en fonction des propriétés des options de ciblage. Syntaxe acceptée:
- Les expressions de filtre sont composées d'une ou de plusieurs restrictions.
- Les restrictions peuvent être combinées à l'aide d'opérateurs logiques
OR .
- Une restriction se présente sous la forme
{field} {operator} {value} .
- L'opérateur doit être "=" (signe égal).
- Champs acceptés :
carrierAndIspDetails.type
geoRegionDetails.geoRegionType
targetingOptionId
Exemples :
- Toutes les options de ciblage (
GEO REGION ) appartenant au sous-type GEO_REGION_TYPE_COUNTRY ou GEO_REGION_TYPE_STATE : geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR
geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE"
- Toutes les options de ciblage (
CARRIER AND ISP ) appartenant au sous-type CARRIER_AND_ISP_TYPE_CARRIER : carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER" .
La longueur de ce champ ne doit pas dépasser 500 caractères.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Message de réponse pour targetingOptions.list
.
Représentation JSON |
{
"targetingOptions": [
{
object (TargetingOption )
}
],
"nextPageToken": string
} |
Champs |
targetingOptions[] |
object (TargetingOption )
Liste des options de ciblage. Cette liste est absente si elle est vide.
|
nextPageToken |
string
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ pageToken lors de l'appel suivant de la méthode targetingOptions.list pour récupérer la page de résultats suivante.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/display-video
Pour en savoir plus, consultez la présentation d'OAuth 2.0.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/12/02 (UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Il n'y a pas l'information dont j'ai besoin"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Trop compliqué/Trop d'étapes"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Obsolète"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problème de traduction"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Mauvais exemple/Erreur de code"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Autre"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Facile à comprendre"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"J'ai pu résoudre mon problème"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Autre"
}]