- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- PoiSearchTerms
- BusinessChainSearchTerms
- GeoRegionSearchTerms
- Pruébala
Busca opciones de segmentación de un tipo determinado en función de 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. 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. Es el anunciante al que se realiza esta solicitud en el contexto. |
pageSize |
Indica el tamaño de la página solicitada. Debe ser un valor entre |
pageToken |
Un token que identifica una página de resultados que el servidor debe mostrar. Por lo general, es el valor de |
Campo de unión search_terms . Consultas para buscar opciones de segmentación. Solo se puede completar un campo en search_terms , que debe corresponder a targeting_type . search_terms puede ser 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 opciones de segmentación de 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 estará disponible si está vacía. |
nextPageToken |
Un token para recuperar los resultados de la página siguiente. Pasa este valor en el campo |
Permisos 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 del lugar de interés, la dirección o la coordenada del lugar de interés deseado. La consulta puede ser un prefijo; p.ej., “Times squar”, “40.7505045,-73.99562”, “315 W 44th St”, etcétera. |
BusinessChainSearchTerms
Términos de búsqueda para opciones de segmentación de 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 comercial deseada. La consulta debe ser el nombre completo de la empresa, p.ej., "KFC", "mercedes-benz". |
regionQuery |
La búsqueda para la región geográfica deseada, p.ej., "Seattle", "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”, “EE.UU.”, etcétera. |