Method: googleAdsFields.search

Retorna todos os campos que correspondem à consulta de pesquisa.

Lista de erros gerados: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

Solicitação HTTP

POST https://googleads.googleapis.com/v14/googleAdsFields:search

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

Corpo da solicitação

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

Representação JSON
{
  "query": string,
  "pageToken": string,
  "pageSize": integer
}
Campos
query

string

Obrigatório. A string de consulta.

pageToken

string

Token da página a ser recuperada. Se não for especificado, a primeira página de resultados será retornada. Use o valor extraído de nextPageToken na resposta anterior para solicitar a próxima página de resultados.

pageSize

integer

Número de elementos a serem recuperados em uma única página. Quando uma página muito grande é solicitada, o servidor pode decidir limitar ainda mais o número de recursos retornados.

Corpo da resposta

Mensagem de resposta para GoogleAdsFieldService.SearchGoogleAdsFields.

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

Representação JSON
{
  "results": [
    {
      object (GoogleAdsField)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string
}
Campos
results[]

object (GoogleAdsField)

A lista de campos que correspondem à consulta.

nextPageToken

string

Token de paginação usado para recuperar a próxima página de resultados. Transmita o conteúdo dessa string como o atributo pageToken da próxima solicitação. nextPageToken não é retornado para a última página.

totalResultsCount

string (int64 format)

Número total de resultados que correspondem à consulta, ignorando a cláusula LIMIT.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/adwords

Para mais informações, consulte a Visão geral do OAuth 2.0.