- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Prova!
Cerca opzioni di targeting di un determinato tipo in base ai termini di ricerca specificati.
Richiesta HTTP
POST https://displayvideo.googleapis.com/v1/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 contesto di 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 deve restituire. In genere, si tratta del valore di |
Campo unione search_terms . Query in base alle quali cercare le opzioni di targeting. È possibile compilare un solo campo in search_terms che 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 commerciale. Può essere utilizzato solo quando |
geoRegionSearchTerms |
Termini di ricerca per le opzioni di targeting per regione. Può essere utilizzato solo quando |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Messaggio di risposta per targetingOptions.search
.
Rappresentazione JSON |
---|
{
"targetingOptions": [
{
object ( |
Campi | |
---|---|
targetingOptions[] |
L'elenco di opzioni di targeting che corrispondono ai criteri di ricerca. Se vuoto, questo elenco non sarà presente. |
nextPageToken |
Un token per recuperare la pagina successiva di risultati. 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 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, l'indirizzo o le coordinate del PDI desiderato. La query può essere un prefisso, ad esempio "Timesquar", "40.7505045,-73.99562", "315 W 44th St", ecc. |
BusinessChainSearchTerms
Termini di ricerca per le opzioni di targeting della catena commerciale.
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 essere il nome completo dell'attività, ad esempio "KFC", "mercedes-benz". |
regionQuery |
La query di ricerca per l'area geografica desiderata, ad esempio "Seattle", "Stato unito". |
GeoRegionSearchTerms
Termini di ricerca per le opzioni di targeting per regione.
Rappresentazione JSON |
---|
{ "geoRegionQuery": string } |
Campi | |
---|---|
geoRegionQuery |
La query di ricerca per la regione geografica desiderata. La query può essere un prefisso, ad esempio "New Yor", "Seattle", "USA", ecc. |