- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Essayer
Recherche les options de ciblage d'un type donné sur la base des termes de recherche indiqués.
Requête HTTP
POST https://displayvideo.googleapis.com/v2/targetingTypes/{targetingType}/targetingOptions:search
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
targetingType |
Obligatoire. Type d'options de ciblage à récupérer. Les valeurs acceptées sont les suivantes :
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
Champs | |
---|---|
advertiserId |
Obligatoire. Annonceur pour lequel cette demande est effectuée. |
pageSize |
Taille de la page demandée. Doit être compris entre |
pageToken |
Jeton identifiant une page de résultats que le serveur doit renvoyer. Il s'agit généralement de la valeur de |
Champ d'union search_terms . Requêtes avec lesquelles rechercher des options de ciblage. Vous ne pouvez renseigner qu'un seul champ dans search_terms , et celui-ci doit correspondre à targeting_type . search_terms ne peut être que l'un des éléments suivants: |
|
poiSearchTerms |
Termes de recherche pour les options de ciblage des POI. Ne peut être utilisé que lorsque |
businessChainSearchTerms |
Termes de recherche pour les options de ciblage de la chaîne d'établissements. Ne peut être utilisé que lorsque |
geoRegionSearchTerms |
Termes de recherche pour les options de ciblage par zone géographique. Ne peut être utilisé que lorsque |
Corps de la réponse
Message de réponse pour targetingOptions.search
.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"targetingOptions": [
{
object ( |
Champs | |
---|---|
targetingOptions[] |
Liste des options de ciblage qui correspondent aux critères de recherche. Si cette liste est vide, elle sera absente. |
nextPageToken |
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ |
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.
PoiSearchTerms
Termes de recherche pour les options de ciblage des POI.
Représentation JSON |
---|
{ "poiQuery": string } |
Champs | |
---|---|
poiQuery |
Requête de recherche pour le nom, l'adresse postale ou les coordonnées du POI souhaité. La requête peut être un préfixe, par exemple "Times Square", "40.7505045,-73.99562", "315 W 44th St", etc. |
BusinessChainSearchTerms
Termes de recherche pour les options de ciblage de la chaîne d'établissements.
Au moins l'un des champs doit être renseigné.
Représentation JSON |
---|
{ "businessChainQuery": string, "regionQuery": string } |
Champs | |
---|---|
businessChainQuery |
Requête de recherche pour la chaîne d'établissements souhaitée. La requête doit correspondre au nom complet de l'établissement (par exemple, "KFC" ou "mercedes-benz"). |
regionQuery |
Requête de recherche pour la région géographique souhaitée (par exemple, "Seattle" ou "United State"). |
GeoRegionSearchTerms
Termes de recherche pour les options de ciblage par zone géographique.
Représentation JSON |
---|
{ "geoRegionQuery": string } |
Champs | |
---|---|
geoRegionQuery |
Requête de recherche pour la zone géographique souhaitée. La requête peut être un préfixe, par exemple "New Yor", "Seattle", "USA", etc. |