- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Prova!
Consente di cercare opzioni di targeting di un determinato tipo in base ai termini di ricerca specificati.
Richiesta HTTP
POST https://displayvideo.googleapis.com/v2/targetingTypes/{targetingType}/targetingOptions:search
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
targetingType |
obbligatorio. Il tipo di opzioni di targeting da recuperare. I valori accettati sono:
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
Campi | |
---|---|
advertiserId |
obbligatorio. L'inserzionista nel quale viene fatta questa richiesta. |
pageSize |
Dimensioni della pagina richiesta. Il valore deve essere compreso tra |
pageToken |
Un token che identifica una pagina di risultati che il server dovrebbe restituire. In genere, si tratta del valore di |
Campo di unione search_terms . Query in base alle quali cercare opzioni di targeting. È possibile compilare un solo campo in search_terms e deve corrispondere a targeting_type . search_terms può essere solo uno dei seguenti: |
|
poiSearchTerms |
Termini di ricerca per le opzioni di targeting per PDI. Può essere utilizzato solo quando |
businessChainSearchTerms |
Termini di ricerca per le opzioni di targeting della catena di business. Può essere utilizzato solo quando |
geoRegionSearchTerms |
Termini di ricerca per le opzioni di targeting per area geografica. Può essere utilizzato solo quando |
Corpo della risposta
Messaggio di risposta per targetingOptions.search
.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"targetingOptions": [
{
object ( |
Campi | |
---|---|
targetingOptions[] |
L'elenco di opzioni di targeting che corrispondono ai criteri di ricerca. Questo elenco non sarà presente se vuoto. |
nextPageToken |
Un token per recuperare la pagina dei risultati successiva. Passa questo valore nel campo |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/display-video
Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
PoiSearchTerms
Termini di ricerca per le opzioni di targeting per PDI.
Rappresentazione JSON |
---|
{ "poiQuery": string } |
Campi | |
---|---|
poiQuery |
La query di ricerca per il nome del PDI, la via o la coordinata del PDI desiderato. La query può essere un prefisso, ad esempio "Times squar", "40.7505045,-73.99562", "315 W 44th St" e così via. |
BusinessChainSearchTerms
Termini di ricerca per le opzioni di targeting della catena di business.
Almeno un campo deve essere compilato.
Rappresentazione JSON |
---|
{ "businessChainQuery": string, "regionQuery": string } |
Campi | |
---|---|
businessChainQuery |
La query di ricerca per la catena commerciale desiderata. La query deve contenere il nome completo dell'attività, ad esempio "KFC", "mercedes-benz". |
regionQuery |
La query di ricerca per la regione desiderata, ad esempio "Seattle", "Stati Uniti". |
GeoRegionSearchTerms
Termini di ricerca per le opzioni di targeting per area geografica.
Rappresentazione JSON |
---|
{ "geoRegionQuery": string } |
Campi | |
---|---|
geoRegionQuery |
La query di ricerca per la regione desiderata. La query può essere un prefisso, ad esempio "New Yor", "Seattle", "USA" e così via. |