Method: targetingTypes.targetingOptions.search

Procura opções de segmentação de um determinado tipo com base nos termos de pesquisa.

Solicitação HTTP

POST https://displayvideo.googleapis.com/v4/targetingTypes/{targetingType}/targetingOptions:search

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
targetingType

enum (TargetingType)

Obrigatório. O tipo de opções de segmentação a serem recuperadas.

Os valores aceitos são:

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "advertiserId": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field search_terms can be only one of the following:
  "poiSearchTerms": {
    object (PoiSearchTerms)
  },
  "businessChainSearchTerms": {
    object (BusinessChainSearchTerms)
  },
  "geoRegionSearchTerms": {
    object (GeoRegionSearchTerms)
  }
  // End of list of possible types for union field search_terms.
}
Campos
advertiserId

string (int64 format)

Obrigatório. O anunciante para quem essa solicitação está sendo feita.
pageSize

integer

Tamanho da página solicitada. O valor precisa estar entre 1 e 200. Se não for especificado, 100 será usado como padrão. Retorna o código de erro INVALID_ARGUMENT se um valor inválido for especificado.
pageToken

string

Um token que identifica a página de resultados que o servidor retornará. Normalmente, esse é o valor de nextPageToken retornado da chamada anterior para o método targetingOptions.search. Se não for especificado, a primeira página de resultados será retornada.
Campo de união search_terms. Consultas para pesquisar opções de segmentação. Apenas um campo em search_terms pode ser preenchido e precisa corresponder a targeting_type. search_terms pode ser apenas um dos seguintes:
poiSearchTerms

object (PoiSearchTerms)

Termos de pesquisa para opções de segmentação de PDIs. Só pode ser usado quando targetingType é TARGETING_TYPE_POI.
businessChainSearchTerms

object (BusinessChainSearchTerms)

Termos de pesquisa para opções de segmentação de rede de negócios. Só pode ser usado quando targetingType é TARGETING_TYPE_BUSINESS_CHAIN.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

Pesquise termos para encontrar opções de segmentação por região geográfica. Só pode ser usado quando targetingType é TARGETING_TYPE_GEO_REGION.

Corpo da resposta

Mensagem de resposta para targetingOptions.search.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
Campos
targetingOptions[]

object (TargetingOption)

A lista de opções de segmentação que correspondem aos critérios de pesquisa.

Essa lista não será exibida se estiver vazia.
nextPageToken

string

Um token para recuperar a próxima página de resultados. Transmita esse valor no campo pageToken na chamada subsequente para o método targetingOptions.search para recuperar a próxima página de resultados.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/display-video

Para mais informações, consulte OAuth 2.0 Overview.

PoiSearchTerms

Termos de pesquisa para opções de segmentação de PDIs.

Representação JSON 
{
  "poiQuery": string
}
Campos
poiQuery

string

A consulta de pesquisa para o nome, o endereço ou a coordenada do PDI desejado. A consulta pode ser um prefixo, por exemplo, "Times squar", "40.7505045,-73.99562", "315 W 44th St" etc.

BusinessChainSearchTerms

Termos de pesquisa para opções de segmentação de rede de negócios.

Preencha pelo menos um dos campos.

Representação JSON 
{
  "businessChainQuery": string,
  "regionQuery": string
}
Campos
businessChainQuery

string

A consulta de pesquisa da rede de empresas desejada. A consulta precisa ser o nome completo da empresa, por exemplo, "KFC" ou "mercedes-benz".
regionQuery

string

A consulta de pesquisa para a região geográfica desejada, por exemplo, "Seattle", "Estados Unidos".

GeoRegionSearchTerms

Pesquise termos para encontrar opções de segmentação por região geográfica.

Representação JSON 
{
  "geoRegionQuery": string
}
Campos
geoRegionQuery

string

A consulta de pesquisa para a região geográfica desejada. A consulta pode ser um prefixo, por exemplo, "New Yor", "Seattle", "EUA" etc.