- 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
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- BusinessChainSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- GeoRegionSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Essayer
Permet de rechercher des options de ciblage d'un type donné en fonction des termes de recherche indiqués.
Requête HTTP
POST https://displayvideo.googleapis.com/v3/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. L'annonceur pour lequel cette demande est effectuée dans le contexte de |
pageSize |
Taille de la page demandée. La valeur doit être comprise entre |
pageToken |
Jeton identifiant une page de résultats que le serveur doit renvoyer. En général, il s'agit de la valeur de |
Champ d'union search_terms . Requêtes par lesquelles rechercher des options de ciblage. Vous ne pouvez renseigner qu'un seul champ dans search_terms , qui 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 par POI. Ne peut être utilisé que lorsque |
businessChainSearchTerms |
Termes de recherche pour les options de ciblage par chaîne d'établissements. Ne peut être utilisé que lorsque |
geoRegionSearchTerms |
Termes de recherche pour les options de ciblage par zones géographiques. 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 correspondant aux critères de recherche. Cette liste sera 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 par 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 (ex. : "Times squareuar", "40.7505045,-73.99562", "315 W 44th St", etc. |
BusinessChainSearchTerms
Termes de recherche pour les options de ciblage par 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 contenir le nom complet de l'entreprise, par exemple "KFC", "mercedes-benz". |
regionQuery |
Requête de recherche pour la région géographique souhaitée, par exemple "Seattle", "États-Unis". |
GeoRegionSearchTerms
Termes de recherche pour les options de ciblage par zones géographiques.
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 (ex. : "New Yor", "Seattle", "USA", etc. |