- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Pruébalo
Busca opciones de segmentación de un tipo determinado según los términos de búsqueda especificados.
Solicitud HTTP
POST https://displayvideo.googleapis.com/v3/targetingTypes/{targetingType}/targetingOptions:search
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
targetingType |
Obligatorio. Es el tipo de opciones de segmentación que se recuperarán. Valores aceptados:
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
Campos | |
---|---|
advertiserId |
Obligatorio. El anunciante para el que se realiza esta solicitud. |
pageSize |
Indica el tamaño de la página solicitada. El valor debe estar comprendido entre |
pageToken |
Un token que identifica una página de resultados que el servidor debe mostrar. Por lo general, este es el valor de |
Campo de unión search_terms . Consultas mediante las cuales se pueden buscar opciones de segmentación. Solo se puede completar un campo en search_terms , que debe corresponder a targeting_type . search_terms puede ser solo una de las siguientes opciones: |
|
poiSearchTerms |
Términos de búsqueda para las opciones de segmentación de lugares de interés Solo se puede usar cuando |
businessChainSearchTerms |
Términos de búsqueda para las opciones de segmentación de la cadena comercial. Solo se puede usar cuando |
geoRegionSearchTerms |
Términos de búsqueda para las opciones de segmentación por región geográfica. Solo se puede usar cuando |
Cuerpo de la respuesta
Mensaje de respuesta para targetingOptions.search
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"targetingOptions": [
{
object ( |
Campos | |
---|---|
targetingOptions[] |
Es la lista de opciones de segmentación que coinciden con los criterios de búsqueda. Esta lista no se mostrará si está vacía. |
nextPageToken |
Un token para recuperar los resultados de la página siguiente. Pasa este valor en el campo |
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/display-video
Para obtener más información, consulta la descripción general de OAuth 2.0.
PoiSearchTerms
Términos de búsqueda para las opciones de segmentación de lugares de interés
Representación JSON |
---|
{ "poiQuery": string } |
Campos | |
---|---|
poiQuery |
Es la búsqueda del nombre o la dirección del lugar de interés deseado, o la coordenada del lugar de interés deseado. La consulta puede ser un prefijo, p.ej., "Timesquar", "40.7505045,-73.99562", "315 W 44th St", etc. |
BusinessChainSearchTerms
Términos de búsqueda para las opciones de segmentación de la cadena comercial.
Se debe propagar al menos uno de los campos.
Representación JSON |
---|
{ "businessChainQuery": string, "regionQuery": string } |
Campos | |
---|---|
businessChainQuery |
La búsqueda de la cadena de negocios deseada La consulta debe ser el nombre completo de la empresa, p.ej., “KFC” o “mercedes-benz”. |
regionQuery |
La búsqueda para la región geográfica deseada, p.ej., “Seattle” y “Estados Unidos”. |
GeoRegionSearchTerms
Términos de búsqueda para las opciones de segmentación por región geográfica.
Representación JSON |
---|
{ "geoRegionQuery": string } |
Campos | |
---|---|
geoRegionQuery |
Es la búsqueda de la región geográfica deseada. La consulta puede ser un prefijo, p.ej., "New Yor", "Seattle", "USA", etcétera |