- 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é en fonction des termes de recherche indiqués.
Requête HTTP
POST https://displayvideo.googleapis.com/v1/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. En règle générale, il s'agit de la valeur de |
Champ d'union search_terms . Requêtes via lesquelles rechercher des options de ciblage. Vous ne pouvez renseigner qu'un seul champ dans search_terms . Celui-ci doit correspondre à targeting_type . search_terms ne peut être qu'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
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.search
.
Représentation JSON |
---|
{
"targetingOptions": [
{
object ( |
Champs | |
---|---|
targetingOptions[] |
Liste des options de ciblage qui correspondent aux critères de recherche. Cette liste est absente si elle est vide. |
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 squareuar", "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'entreprise (par exemple, "KFC" ou "mercedes-benz"). |
regionQuery |
Requête de recherche pour la région géographique souhaitée (par exemple, "Seattle" ou "États-Unis"). |
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 région géographique souhaitée. La requête peut être un préfixe, par exemple "New Yor", "Seattle", "USA", etc. |