A API AJAX de pesquisa do Google é uma API JavaScript implementada nas classes descritas a seguir.
Uma instância de GSearchControlgoogle.search.SearchControl representa um único controle de pesquisa em uma página. Cada controle de pesquisa gerencia a apresentação do objeto de interface de usuário e do mecanismo de pesquisa para um conjunto selecionado de objetos de pesquisa (objetos que implementam a interface GSearch google.search.Search).
| Construtor | Descrição |
|---|---|
|
|
Cria um novo objeto de controle de pesquisa. O objeto de controle de pesquisa é um recipiente para as pesquisas, objetos que implementam a interface
|
| Método | Descrição |
|---|---|
|
|
Este método adiciona um objeto de pesquisa ao controle de pesquisa. Depois de adicionado, o controle de pesquisa coordenará as atividades da pesquisa. Ele coordena a execução de pesquisas, lida com os eventos relacionados de conclusão da pesquisa, fornece uma localização para a apresentação dos resultados e fornece uma IU para "manter" ou "recortar" os resultados de pesquisa.
O método aceita um objeto
|
|
|
Este método é a etapa final necessária para ativar um objeto de controle de pesquisa. Ele pode ser chamado somente depois de todas as pesquisas serem adicionadas ao controle de pesquisa. Quando chamado, este método produz a interface de usuário, recipientes dos resultados de pesquisa para cada pesquisa configurada e define os diversos vínculos necessários para coordenar pesquisas paralelas entre todas as pesquisas.
O método requer que o originador da chamada forneça um elemento html de bloco, normalmente um elemento O estilo padrão da interface de usuário é um estilo linear, onde as entradas de controle estão no alto, seguidas por um conjunto linear de resultados empilhados. Como opção, o originador da chamada pode solicitar uma interface de usuário com guias, que funciona bem quando o uso vertical de espaço for caro.
|
|
|
Quando um aplicativo fornece seu próprio controle de entrada e solicita que o controle de pesquisa o use, o controle usa um temporizador de entrada para determinar quando deverá executar uma pesquisa. Um temporizador é inicializado cada vez que o usuário digita algo na área de entrada de texto dos controles de pesquisa. A pesquisa é solicitada quando o temporizador é executado. Use esta API para programar a espera entre a última tecla digitada e o início de uma pesquisa. Observação: O valor padrão do controle é
|
|
|
Este método faz com que o controle de pesquisa inicie uma sequência de pesquisas paralelas entre todas as pesquisas configuradas no controle. Se o argumento Como efeito colateral dessa chamada, é exibido o conjunto atual de resultados de pesquisa. Além disso, os resultados de pesquisa armazenados dentro de cada um dos objetos pesquisa são limpos.
|
|
|
Este método é usado para informar ao controle de pesquisa que o originador da chamada deseja ser notificado quando um usuário selecionar um dos resultados gerenciados pelo controle de pesquisa para copiá-lo. Se este método não for chamado, o usuário não receberá a oportunidade de copiar os resultados da pesquisa. Se o método for chamado, cada resultado de pesquisa será anotado com um link de texto exibido abaixo do resultado da pesquisa. Clicar neste link faz com que o método especificado do objeto especificado seja chamado, passando um objeto
|
|
|
Este método é chamado para selecionar o número de resultados retornados por cada uma das pesquisas. Observe que este método não utiliza escalas. Ele utiliza uma enumeração que indica um pequeno número de resultados ou um grande número de resultados. No futuro, este método pode ser aprimorado para suportar conjuntos de resultados de porte médio e muito grande. Nos aplicativos de exemplo, você provavelmente viu o controle de ajuste mais/menos no início do controle de pesquisa. Este método é usado por esse controle de ajuste.
|
|
|
Este método é usado para informar ao controle de pesquisa que este deve ignorar todas as conclusões de resultado de pesquisa recebidas. O estado interno usado por este método é reset, para permitir pesquisas novas sempre que uma nova pesquisa for solicitada. Este método tem a finalidade de ajudar os aplicativos a lidar com a intermitência de IU que pode ocorrer quando a entrada lenta dispara pesquisas inadvertidamente. Ao usar este método cada vez que for detectada uma entrada, as pesquisas anteriores baseadas em entradas parciais podem ser ignoradas facilmente.
|
|
|
Este método é usado para remover todos os resultados de pesquisa do controle de pesquisa.
|
|
|
Este método é chamado para definir o destino do link, usado com os links incorporados nos resultados da pesquisa. O valor padrão é
|
|
|
Este método é usado para informar ao controle de pesquisa que o originador da chamada deseja ser notificado quando uma pesquisa for concluída. A granularidade desta chamada está no nível de pesquisa e NÃO no nível do controle de pesquisa. Isso significa que, se seu controle de pesquisa contém 5 pesquisas e você executar uma pesquisa, o retorno de chamada será chamado a cada pesquisa concluída. Além disso, nem todas as pesquisas serão concluídas. Portanto, tenha cuidado para não criar armadilhas de código ao supor que ocorrerá uma única conclusão para cada pesquisa.
|
|
|
Este método é usado para informar ao controle de pesquisa que o originador da chamada deseja ser notificado antes de uma pesquisa ser iniciada. A granularidade desta chamada está no nível de pesquisa e NÃO no nível do controle de pesquisa. Isso significa que, se seu controle de pesquisa contém 5 pesquisas e você executar uma pesquisa, o método será chamado a cada vez que for informado que uma pesquisa deve ser iniciada.
|
|
|
Normalmente, o slot da pesquisa no controle de pesquisa é deixado vazio quando uma pesquisa não produz resultados. Este método permite que o originador da chamada especifique uma string que fornece um "resultado" padrão. O sistema contém o valor
|
| Método estático | Descrição |
|---|---|
|
|
Esta função auxiliar é usada para clonar o estilo calculado atual para o nó html especificado (ou árvore, se opt_deep for especificado) e inserir o estilo atual no nó. Esta função é útil em algumas situações, principalmente em conjunto com um manipulador on keep, onde o aplicativo deseja preservar um conjunto de estilos html enquanto passa um conteúdo html de um aplicativo para outro, onde o aplicativo receptor não possui a folha de estilo associada. O exemplo mais simples deste cenário é o caso de um aplicativo de e-mail usando a API AJAX de pesquisa do Google para permitir que os usuários recortem resultados de pesquisa e os colem em uma janela de composição de mensagem, a partir da qual serão enviados como html para outro usuário. Em alguns casos, o aplicativo de e-mail do destinatário não terá conhecimento da API AJAX de pesquisa do Google e, portanto, normalmente não terá sua folha de estilo. Para resolver isso, fornecemos este método para que o aplicativo originador do e-mail possa inserir os estilos atuais, para que o destinatário possa ler a mensagem com total fidelidade.
Observação: Este método não está implementado no momento no navegador Safari. |
Este objeto não utiliza nenhuma propriedade pública.
Os aplicativos que usam objetos em formato independente, em vez de usarem apenas objetos , frequentemente terão que capturar e processar solicitações de pesquisa geradas pelo usuário.GSearchControlgoogle.search.SearchControl o GSearchFormgoogle.search.SearchForm() () é um objeto leve, cuja finalidade de uso é exatamente este caso. Ele fornece um elemento de entrada de texto, um botão de pesquisa, um botão opcional Limpar e toda a aplicação de marca padrão aos aplicativos.
| Construtor | Descrição |
|---|---|
|
|
Cria um novo objeto de formulário de pesquisa. O objeto de formulário de pesquisa fornece elementos de interface de usuário, métodos, propriedades e retornos de chamada criados para permitir que os aplicativos controlem uma coleção de objetos
O método aceita um argumento
|
| Método | Descrição |
|---|---|
|
|
Este método registra uma combinação objeto/método chamada quando o formulário de pesquisa é "enviado". Este evento ocorre quando o usuário clica no botão Pesquisar ou quando o usuário tecla Enter enquanto o ponteiro está sobre o elemento de entrada de texto. Quando isso ocorre, o objeto especificado torna-se o objeto ativo e o método especificado é chamado. O argumento passado ao método é este formulário de pesquisa. A aparência típica de um método é:
App.prototype.onSubmit = function(form) {
if (form.input.value) {
this.localSearcher.execute(form.input.value);
}
return false;
}
No exemplo acima, o formulário de pesquisa é passado ao método e este retorna false, indicando que processou o evento de envio.
|
|
|
Este método registra uma combinação objeto/método chamada quando o botão Limpar do formulário de pesquisa é pressionado. É um erro chamar este método caso o formulário de pesquisa seja criado sem um botão Limpar. Quando isso ocorre, o objeto especificado torna-se o objeto ativo e o método especificado é chamado. O argumento passado ao método é este formulário de pesquisa. A aparência típica de um método é:
App.prototype.onClear = function(form) {
this.myClearFunction();
return false;
}
No exemplo acima, o formulário de pesquisa é passado ao método e este retorna false, indicando que processou o evento Limpar.
|
|
|
Este método permite que um aplicativo "envie" o formulário. Isso envolve, opcionalmente, configurar o elemento de entrada de texto do formulário e, em seguida, chamar o método de retorno de chamada registrado no envio, estabelecido com o
|
Este objeto não utiliza nenhum método estático.
A coleção de propriedades públicas a seguir é utilizada por google.search.SearchForm.
| Propriedade | Descrição |
|---|---|
|
|
Esta propriedade é o elemento de entrada de texto do formulário. Os aplicativos podem ler e gravar esta propriedade livremente. No uso típico em um manipulador de retorno de chamada no envio, um aplicativo lê e processa a string |
|
|
A estrutura interna do formulário de pesquisa é um par de tabelas HTML. A tabela superior contém o elemento de entrada de texto, o botão de pesquisa localizado e um botão Limpar opcional. A tabela inferior contém uma célula livre específica ao aplicativo, a célula da esquerda na tabela, além de um conjunto de marca do Google, incluindo texto e imagem, alinhado à direita. Esta propriedade, a |
Uma instância da classe GSearchgoogle.search.Search fornece a capacidade de executar pesquisas e receber resultados de um serviço de pesquisa específico. Este objeto não é usado diretamente. É uma classe básica herdada das pesquisas específicas ao serviço. Os métodos e propriedades descritos abaixo se aplicam a todos os objetos herdados desta classe básica. Cada um desses objetos também pode fornecer interfaces adicionais.
O uso esperado deste objeto é em conjunto com o GSearchControlgoogle.search.SearchControl, onde o controle de pesquisa fornece a interface de usuário e a coordenação. Dito isso, é totalmente aceitável usar este objeto de maneira independente. Nesse caso, evite compartilhar a mesma instância de um objeto de pesquisa entre a lógica do seu aplicativo e um objeto de controle de pesquisa.
| Construtor | Descrição |
|---|---|
|
|
Cria um novo de objeto pesquisa. Observação: Como esta é uma classe básica, provavelmente os aplicativos não farão uso direto deste construtor. Em vez disso, eles usarão o construtor como efeito colateral da criação de um objeto pesquisa específico ao serviço (por ex., |
| Método | Descrição |
|---|---|
|
|
Este método é chamado para selecionar o número de resultados retornados por esta pesquisa específica. Observe que este método não utiliza escalas. Ele utiliza uma enumeração que indica um pequeno número de resultados ou um grande número de resultados. No futuro, este método pode ser aprimorado para suportar conjuntos de resultados de porte médio e muito grande.
|
|
|
Este método retorna o tamanho atual do conjunto de resultados, o valor estabelecido pelo método anterior.
|
|
|
Quando uma pesquisa é concluída com sucesso, o objeto de pesquisa retém uma coleção de resultados de pesquisa que descreve a saída de uma pesquisa específica. Este método é usado para restaurar a pesquisa, limpando todos os resultados. Este método é chamado implicitamente antes da execução de uma nova pesquisa.
|
|
|
Este método é chamado para iniciar uma nova pesquisa. O argumento
|
|
|
Este método é usado para registrar um objeto e um método para notificar a conclusão de uma pesquisa. Opcionalmente, os aplicativos podem passar um argumento de contexto através do
|
|
|
Este método é usado para configurar um marcador definido pelo usuário, que deve ser usado quando esta pesquisa for adicionada a um controle de pesquisa. Ao chamar esta função, o marcador definido pelo usuário especificado será usado no cabeçalho ou na guia da seção de resultados em vez dos marcadores padrão integrados. O uso esperado é em conjunto com a pesquisa restrita ao site, onde é apropriado que os aplicativos indiquem que programaram restrições, através da alteração do marcador.
|
|
|
Este método é usado para especificar um sufixo de classe definido pelo usuário para a seção de resultados de pesquisa e para a coleção de resultados de pesquisa produzida por esta pesquisa no controle de pesquisa. A motivação deste método é permitir que os aplicativos definam estilos exclusivos para os resultados e o cabeçalho de um conjunto específico de resultados de pesquisa. Supondo que este método seja chamado com o valor "siteSearch", a classe
|
|
|
Este método é chamado para definir o destino do link, usado com os links incorporados nos resultados da pesquisa. O valor padrão é
|
|
|
Há algumas vezes em que seu aplicativo não usa o controle de pesquisa, mas apenas um pequeno conjunto de propriedades de um resultado de pesquisa que são exibidas em um formato altamente personalizado. Quando esse for o caso, há uma pequena otimização disponível para o seu aplicativo. A pesquisa pode ser programada para NÃO gerar uma propriedade .html, deixando somente as propriedades básicas válidas em um resultado.
|
|
|
Para algumas classes de pesquisa (por ex., GlocalSearchgoogle.search.LocalSearch()), é obrigatório exibir a atribuição ao lado do conjunto de resultados de pesquisa. Ao usar o controle de pesquisa, a atribuição é incluída na lógica do controle de pesquisa "gratuitamente". Se você estiver usando uma pesquisa básica, cabe a você capturar e apresentar a atribuição apropriada. Este método tem a finalidade de fornecer um nó de atribuição (ou nulo, se não for necessária uma atribuição), que você pode exibir apropriadamente. A exibição da atribuição é obrigatória somente com a exibição ativa de um conjunto de resultados imediatamente após uma pesquisa. O snippet a seguir demonstra um uso simples desta API. var attribution = GlocalSearchgoogle.search.LocalSearch.getAttribution(); if (attribution) { var el = document.getElementById("searchwell"); el.appendChild(attribution); }
|
|
|
Este método permite que o originador da chamada defina (ou limpe) um termo de consulta adicional opcional, anexado a todas as consultas que passam pela pesquisa. Os aplicativos normalmente o usam para fornecer resultados alternativos com ligeiras variações em relação ao termo original. Por exemplo, se uma pesquisa for baseada no
|
|
|
Este método permite que o originador da chamada crie ou gere novamente a propriedade
|
|
|
Depois de concluída a pesquisa, a propriedade
|
| Método estático | Descrição |
|---|---|
|
|
Este método é uma função auxiliar estática que pode ser usada para redimensionar uma imagem proporcionalmente. Você passa a largura e a altura da imagem atual, além do objeto imageScaler (contendo as propriedades .width e .height). A função calcula e retorna um objeto imageScaler redimensionado proporcionalmente. Você pode usar as propriedades .height e .width deste objeto para criar um elemento de imagem. Internamente, o objeto GvideoSearchgoogle.search.VideoSearch define um redimensionador de imagem e o utiliza para dimensionar as miniaturas. Ele é designado para manter a proporção 4 x 3 e é definido como mostrado abaixo.
// imageScaling defaults 4x3 100x75 image
this.imageScaler = {width:100,height:75};
Ao criar o elemento // scale the thumbnail image using the searcher's .imageScaler. // By default this is a 4x3 100x75 image, // but its settable using .setVideoResultsTbHeight as well var scaled = GSearchgoogle.search.Search.scaleImage(result.tbWidth, result.tbHeight, this.imageScaler); // scaled.height and scaled.width now contain // the values needed to proportionally scale the thumbnail
|
|
|
Este método é uma função auxiliar estática que retorna um nó HTML DOM da marca "powered by Google" ao aplicativo e, opcionalmente, o conecta ao documento como o único filho do elemento opcional especificado. A finalidade deste método é assegurar ao aplicativo uma maneira simples de atender aos requisitos de marca em situações nas quais o uso do formulário de pesquisa no Por padrão, o nó da marca tem orientação horizontal e funciona bem sob um formulário de pesquisa, acima ou abaixo de uma coleção de resultados etc. Em alguns casos, é necessária uma orientação vertical da marca. Como exemplo, imagine uma Barra de vídeo com orientação vertical. Nesse caso, como as necessidades da marca são muito estreitas, é necessária uma orientação vertical da marca (veja a marca "powered by Google" na parte inferior da Barra de vídeo). Como padrão, esta API fornece orientação horizontal, mas você pode solicitar facilmente a orientação vertical no aplicativo.
|
|
|
Este método é uma função auxiliar estática que registra a função do manipulador especificado a ser chamada quando o documento que contém esta chamada é carregado. A documentação anterior recomendava o uso do atributo onload do elemento body (por ex.,
|
A coleção de propriedades públicas abaixo é utilizada por todos os objetos que implementam esta interface. A menos que indicado em contrário, estas propriedades são somente para leitura.
| Propriedade | Descrição |
|---|---|
|
|
Esta propriedade contém uma matriz de objetos de resultado de pesquisa, um para cada resultado. Esta propriedade é apagada cada vez que uma pesquisa é executada, e a matriz é preenchida cada vez que uma pesquisa é concluída. Se não houver resultados a relatar, a propriedade |
|
|
Esta propriedade opcional está presente quando uma pesquisa é concluída com sucesso. Quando presente, a propriedade especifica como um aplicativo pode solicitar resultados de pesquisa adicionais para o termo de consulta atual, a contagem estimada de resultados, a página atual e o url que pode ser usado para apontar para uma página de resultados de pesquisa hospedada no Google. A propriedade tem a estrutura abaixo:
|
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa na web do Google. Quando a pesquisa é concluída, ele fornece uma coleção de objetos GwebResult.
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa a partir do serviço Pesquisa na web do Google. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para restringir o conjunto de resultados de pesquisa da web retornados por esta pesquisa. Para restringir a pesquisa ao site www.amazon.com, basta chamar este método e passar o valor "www.amazon.com". Para limpar as restrições de site, passe o valor var siteSearch = new GwebSearchgoogle.search.WebSearch(); siteSearch.setSiteRestriction("amazon.com");
Este método também permite que o originador da chamada restrinja as pesquisas a um mecanismo de pesquisa personalizado do Google. Em vez de especificar um caminho de URL para este método, passe o ID do mecanismo de pesquisa personalizado. O snippet abaixo demonstra como configurar uma restrição de site para um mecanismo de pesquisa personalizado cujo id é var siteSearch = new GwebSearchgoogle.search.WebSearch(); siteSearch.setSiteRestriction("000455696194071821846:reviews");
Quando usado desta forma, pode ser fornecido um refinamento do mecanismo de pesquisa personalizado opcional através de var cseId = "017576662512468239146:omuauf_lfve"; var siteSearch = new GwebSearchgoogle.search.WebSearch(); siteSearch.setSiteRestriction(cseId, "Lectures");
Os mecanismos de pesquisa personalizados frequentemente incluem uma página personalizada de resultados de pesquisa. Para suportar esse recurso, você pode fornecer um valor
A última adição aos mecanismos de pesquisa personalizado é o recurso que permite usar Mecanismos de pesquisa personalizados vinculados. Para isso, o argumento
Quando
searcher = new google.search.WebSearch();
searcher.setSiteRestriction(
{
crefUrl : "http://www.google.com/cse/samples/vegetarian.xml"
},
"recipes");
|
|
|
Este método é usado para especificar ou limpar uma restrição do conjunto de resultados retornado por esta pesquisa. Para estabelecer uma restrição, você deve fornecer
|
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa local do Google. Quando a pesquisa é concluída, ele fornece uma coleção de objetos GlocalResult.
Este objeto tem a finalidade de produzir resultados de pesquisa relacionados a uma região geográfica. O objeto fornece uma API que permite que os aplicativos delimitem esta região geográfica, fornecendo uma string de local (cidade/estado, um CEP, um endereço); fornecendo um objeto GLatLnggoogle.maps.LatLng() (consulte o Google Maps), ou fornecendo um objeto GMap2google.maps.Map2() (consulte o Google Maps). A interface recomendável é GLatLnggoogle.maps.LatLng() ou GMap2google.maps.Map2(). Você pode ter percebido nos exemplos a presença de um controle "set location" (definir local) na pilha de resultados da pesquisa local. Esta IU é implementada através da coordenação entre o controle de pesquisa e este objeto. O mapa projetado através do controle de pesquisa abrange todos os resultados de pesquisa e seu valor inicial (ponto central) é estabelecido através da programação deste objeto. O controle de pesquisa não mantém preferências no ponto central. Esta é uma responsabilidade do aplicativo que usa esta API.
Observação: Se não for especificada uma localização, este objeto abrange os resultados da pesquisa da área de São Francisco, Califórnia. Um padrão mais elaborado está sendo considerado, para levar em consideração a região geográfica do usuário.
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa a partir do serviço Pesquisa local do Google. |
| Método | Descrição |
|---|---|
|
|
Este método estabelece um ponto central que é usado para delimitar os resultados de pesquisa. Ele aceita uma única variante, que pode ser uma string, um
|
|
|
O comportamento padrão desta pesquisa é misturar os resultados da pesquisa de endereços (por ex., NY, NY) aos resultados da pesquisa local. Há situações onde esta abordagem misturada não é o comportamento desejado. Por exemplo, suponha que o centro da pesquisa seja em Santa Barbara, CA e o usuário esteja pesquisando o termo "Cava". Com os resultados misturados, o primeiro resultado da pesquisa é um endereço que corresponde a "Cava Close, Aberdeen City, AB15 UK". O segundo resultado é "Cava Restaurant & Bar". Usando este método, os aplicativos podem desativar e ativar a pesquisa de endereços, produzindo resultados estritamente de pesquisa, ou resultados de consulta de endereços misturados aos resultados de pesquisa. Nesse caso, se a consulta de endereço fosse desativada, o primeiro resultado seria "Cava Restaurant & Bar".
|
|
|
Este método é usado para especificar ou limpar uma restrição do conjunto de resultados retornado por esta pesquisa. Para estabelecer uma restrição, você deve fornecer No momento, esta API suporta os tipos de restrição abaixo:
Esse método aceita os seguintes argumentos:
|
| Método estático | Descrição |
|---|---|
|
|
Esta função auxiliar tem a finalidade de redimensionar a imagem associada à propriedade
var img = document.createElement("img");
google.search.LocalSearch.resizeStaticMapUrl(result, 80, 120);
img.src = result.staticMapUrl;
img.title = result.titleNoFormatting;
|
|
|
Esta função auxiliar tem a finalidade de criar uma imagem de mapa estática com a coleção de pontos fornecida pelo originador da chamada. Os pontos podem estar na forma de uma coleção de objetos de resultado de pesquisa, uma coleção de objetos contendo uma
// demonstrate computeStaticMapUrl with simple point array
this.worldPointsUrl = google.search.LocalSearch.computeStaticMapUrl(
worldPoints,350, 400);
document.getElementById("resultsImg").src =
this.worldPointsUrl;
...
var worldPoints = [
{ lat : 48.8565, lng : 2.3509 }, // paris
{ lat : 52.5238, lng : 13.4119}, // berlin
{ lat : 52.3738, lng : 4.8909}, // amsterdam
{ lat : 55.676294, lng : 12.568115}, // copenhagen
{ lat : 60.160791, lng : 24.952548}, // helsinki
{ lat : 59.332725, lng : 18.064454}, // stockholm
{ lat : 59.913820, lng : 10.738741} // oslo
];
|
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa de vídeos do Google. Quando a pesquisa é concluída, ele fornece uma coleção de objetos GvideoResult.
É importante observar que esta pesquisa é desenvolvida para acessar o YouTube e o Google Video. Na maior parte dos casos, as diferenças no formato do resultado e do reprodutor são mínimas. Em alguns casos, os aplicativos, por meio de predicados de consulta especializados, podem acessar diretamente os Canais do YouTube e os Feeds especiais. Os seguintes predicados de consulta apenas para YouTube são suportados
| Predicado | Descrição |
|---|---|
ytchannel:name-of-channel expression?
|
O predicado |
ytfeed:top_rated[.this_week | .this_month | .all_time]
|
O predicado |
ytfeed:{most_viewed, recently_featured}[this_week | .this_month | .all_time]
|
Os predicados |
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa a partir do serviço Pesquisa na web do Google. |
| Método | Descrição |
|---|---|
|
|
O comportamento padrão desta pesquisa é retornar resultados em ordem de relevância. Em alguns casos, é útil ver os resultados ordenados por data. Este método pode ser usado para alterar a ordem dos resultados.
|
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa de blogs do Google. Quando a pesquisa é concluída, ele fornece uma coleção de objetos GblogResultgoogle.search.BlogResult.
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa a partir do serviço Pesquisa de blogs do Google. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para restringir o conjunto de resultados de pesquisa em blogs retornados por esta pesquisa. Para restringir os resultados a todos os resultados de blogs do blogspot.com, basta chamar este método com o valor "blogspot.com". Para restringir os resultados ao blog Nintendo DS no Live Journal, basta chamá-lo com "http://community.livejournal.com/nintendo_ds/". Para limpar as restrições de site, passe o valor
|
|
|
O comportamento padrão desta pesquisa é retornar resultados em ordem de relevância. Em alguns casos, é útil ver os resultados ordenados por data. Este método pode ser usado para alterar a ordem dos resultados.
|
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa de notícias do Google. Quando a pesquisa é concluída, ele fornece uma coleção de objetos GnewsSearchgoogle.search.NewsResult.
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa a partir do serviço Pesquisa de notícias do Google. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para restringir o conjunto de resultados de pesquisa de notícias retornados por esta pesquisa. Para restringir os resultados a todos os resultados do Seattle Times, basta chamar este método com o valor "Seattle Times". Para restringir os resultados a resultados da CNN, basta fazer a chamada com "CNN". O padrão é separar o título da origem das notícias com espaços ou com o caractere de sublinhado (por ex., "_"). Para limpar as restrições de site, passe o valor
|
|
|
O comportamento padrão desta pesquisa é retornar resultados em ordem de relevância. Em alguns casos, é útil ver os resultados ordenados por data. Este método pode ser usado para alterar a ordem dos resultados.
|
|
|
Este método é usado para restringir o conjunto de resultados da pesquisa de notícias retornado por essa pesquisa além das restrições normais do site. O primeiro argumento,
|
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa de Livros do Google. Quando a pesquisa é concluída, ele fornece uma coleção de objetos GbookResult.
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa a partir do serviço Pesquisa de Livros do Google. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para especificar ou limpar uma restrição do conjunto de resultados retornado por esta pesquisa. Para estabelecer uma restrição, você deve fornecer No momento, esta API suporta os tipos de restrição abaixo:
|
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa de imagens do Google. Quando a pesquisa é concluída, ela fornece uma coleção de objetos GimageSearchgoogle.search.ImageSearch. Observação: Os resultados podem ser restringidos ao arquivo de fotos LIFE incluindo source:life como parte da consulta (experimental).
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa a partir do serviço Pesquisa de imagens do Google. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para especificar ou limpar uma restrição do conjunto de resultados retornado por esta pesquisa. Para estabelecer uma restrição, você deve fornecer
No momento, esta API suporta os tipos de restrição abaixo:
var searcher = new google.search.ImageSearch();
searcher.setRestriction(google.search.ImageSearch.RESTRICT_IMAGETYPE,
google.search.ImageSearch.IMAGETYPE_FACES);
searcher.setRestriction(google.search.ImageSearch.RESTRICT_FILETYPE,
google.search.ImageSearch.FILETYPE_JPG);
searcher.setRestriction(google.search.ImageSearch.RESTRICT_COLORIZATION,
google.search.ImageSearch.COLORIZATION_GRAYSCALE);
searcher.execute('Carmen Electra');
|
|
|
Este método é usado para restringir o conjunto de resultados de pesquisa de imagens retornados por esta pesquisa. Para restringir a pesquisa ao site www.photobucket.com, basta chamar este método e passar o valor "www.photobucket.com". Para limpar as restrições de site, passe o valor var siteSearch = new GimageSearchgoogle.search.ImageSearch(); siteSearch.setSiteRestriction("photobucket.com"); |
Este objeto implementa a interface GSearchgoogle.search.Search sobre o serviço Pesquisa de patentes do Google. Quando a pesquisa é concluída, ele fornece uma coleção de objetos GpatentResultgoogle.search.PatentResult.
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de pesquisa para fornecer resultados de pesquisa do serviço Pesquisa de patentes do Google. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para especificar ou limpar uma restrição do conjunto de resultados retornado por esta pesquisa. Para estabelecer uma restrição, você deve fornecer No momento, esta API suporta os tipos de restrição abaixo:
|
|
|
O comportamento padrão desta pesquisa é retornar resultados em ordem de relevância. Em alguns casos, é útil ver os resultados ordenados por data. Este método pode ser usado para alterar a ordem dos resultados.
|
Os objetos de resultado são produzidos usando codificação JSON das solicitações de pesquisa do servidor. Como resultado, escolhemos não implementar objetos Javascript formais. Em vez disso, criamos dinamicamente estes objetos a partir de seu formulário serializado. Embora não haja uma implementação formal dos objetos, estes existem, e nós os documentamos como se houvesse uma implementação Javascript por trás. O impacto de tudo isso é mínimo. Isso significa apenas que não há um construtor nomeado. Para cada resultado, é como se o sistema chamasse new Object() e continuasse a definir propriedades formais nesse objeto. Os resultados são documentados abaixo, com base em suas propriedades.
Para todos os objetos, há duas propriedades comuns:
| 
.GsearchResultClass - especifica o tipo de resultado..html - fornece a raiz de um elemento HTML que pode ser clonado e anexado em algum lugar da hierarquia DOM do aplicativo.
A propriedade .html discutida acima é criada tendo em mente o uso de estilos CSS. Como resultado, cada pedaço de informação semântica é colocado em marcações HTML com um conjunto apropriado de marcadores de classe. Isso permite usar esse HTML em conjunto com suas próprias regras personalizadas de CSS, que definem o estilo do HTML segundo suas necessidades.
Como você verá nas seções abaixo, cada resultado de pesquisa é inserido em um elemento div marcado com uma classe genérica de resultado de pesquisa, a gs-result, e com uma classe específica ao tipo de resultado, por exemplo, gs-webResultgs-localResult etc. Essa estrutura permite definir facilmente regras CSS genéricas aplicadas a todos os resultados, bem como regras específicas a um determinado tipo de resultado.
Além dessa estrutura, quando um resultado é gerenciado pelo GSearchControlgoogle.search.SearchControl, cada resultado é inserido em um elemento div marcado com uma classe genérica de resultado de controle de pesquisa, a gsc-result, e uma classe específica ao tipo de resultado, por ex. gsc-webResultgsc-localResult etc. Cada seção de resultados é inserida em um elemento div marcado com uma classe genérica de resultado de controle de pesquisa (gsc-results) e uma classe específica ao tipo de resultado, por ex., gsc-webResultgsc-localResult etc.
O resultado final dessa estrutura é o esqueleto a seguir:
<!-- A collection of web search results in the search control -->
<div class="gsc-results gsc-webResult">
<!-- A single web result in the search control -->
<div class="gsc-result gsc-webResult">
<!-- A single web result, full structure defined below -->
<div class="gs-result gs-webResult"></div>
</div>
...
</div>
<!-- Similar pattern for local, blog, etc. -->
<div class="gsc-results gsc-localResult"></div>
<div class="gsc-results gsc-blogResult"></div>
| Propriedade comum | Descrição |
|---|---|
|
|
Indica o "tipo" de resultado.
|
|
|
Fornece a raiz de um elemento HTML que pode ser clonado e anexado em algum lugar da hierarquia DOM do aplicativo. Supomos que esta será a principal propriedade com a qual os aplicativos se preocuparão e que a interação típica envolverá a clonagem deste nó e sua colocação em uma hierarquia DOM. Supomos que eles usem css para controlar os estilos em que elementos são exibidos. Por exemplo, supomos que o fragmento abaixo será comum a todos os aplicativos que desejam copiar e colar resultados de pesquisa obtidos pela API AJAX de pesquisa do Google. // clone the .html node from the result var node = result.html.cloneNode(true); // attach the node into my dom container.appendChild(node); |
Este objeto é produzido pelo objeto GwebSearchgoogle.search.WebSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GwebSearchgoogle.search.WebSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o URL básico do resultado. |
|
|
Fornece uma versão do URL descrito acima com códigos de escape. |
|
|
Fornece uma versão mais curta do URL associado ao resultado. Exibido normalmente em verde, com um protocolo e o caminho removidos. |
|
|
Fornece o valor do título do resultado. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece um pequeno snippet de informações da página associada ao resultado da pesquisa. |
|
|
Fornece um URL para a versão em cache no Google da página responsável por produzir este resultado. Esta propriedade pode ser nula, indicando que não há uma versão em cache. Também pode estar desatualizada, nos casos em que o resultado da pesquisa foi salvo e o cache ficou desatualizado desde então. Para obter o melhor resultado, esta propriedade não deve mantida. |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados de uma Pesquisa na web. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar suprimir o "snippet", use uma regra CSS #mycontrol .gs-webResult .gs-snippet { display : none; }#.
<div class="gs-result gs-webResult">
<!-- Note, a.gs-title can have embedded HTML
// so make sure to account for this in your rules.
// For instance, to change the title color to red,
// use a rule like this:
// a.gs-title, a.gs-title * { color : red; }
-->
<div class="gs-title">
<a class="gs-title"></a>
</div>
<div class="gs-snippet"></div>
<!-- The default CSS rule has the -short URL visible and
// the -long URL hidden.
//
// If you want to reverse this, use a rule like:
// #mycontrol .gs-webResult .gs-visibleUrl-short { display:none; }
// #mycontrol .gs-webResult .gs-visibleUrl-long { display:block; }
-->
<div class="gs-visibleUrl gs-visibleUrl-short"></div>
<div class="gs-visibleUrl gs-visibleUrl-long"></div>
</div>
Este objeto é produzido pelo objeto GlocalSearchgoogle.search.LocalSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GlocalSearchgoogle.search.LocalSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o título do resultado. Em alguns casos, o título e o streetAddress são iguais. Isso normalmente ocorre quando o termo da pesquisa é um endereço, como 1231 Lisa Lane, Los Altos, CA. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece um url para uma página de detalhes do Google Maps associada ao resultado da pesquisa. |
|
|
Fornece o valor da latitude do resultado. Pode ser usado para construir um |
|
|
Fornece o valor da longitude do resultado. Pode ser usado para construir um |
|
|
Fornece o endereço completo do resultado especificado. Observação: Em alguns casos, esta propriedade pode ser definida como "" se o resultado não tiver um endereço conhecido. |
|
|
Fornece o nome da cidade do resultado. Observação: Em alguns casos, esta propriedade pode ser definida como "". |
|
|
Fornece um nome de região do resultado (por ex., nos EUA, normalmente é uma abreviação de estado. Em outras regiões pode ser uma província etc.) Observação: Em alguns casos, esta propriedade pode ser definida como "". |
|
|
Fornece o nome do país do resultado. Observação: Em alguns casos, esta propriedade pode ser definida como "". |
|
|
Fornece uma matriz de objetos de número de telefone na qual cada objeto contém uma propriedade |
|
|
Fornece uma matriz com as linhas de endereço de correspondência para este resultado, por exemplo: |
|
|
Fornece um url que pode ser usado para fornecer orientações para motoristas a partir do centro do conjunto de resultados da pesquisa até este resultado da pesquisa. Em alguns casos, esta propriedade pode estar ausente ou nula. Sempre insira o acesso dentro de um teste de |
|
|
Fornece um url que pode ser usado para fornecer orientações para motoristas a partir de uma localização especificada pelo usuário até este resultado da pesquisa. Em alguns casos, esta propriedade pode estar ausente ou nula. Sempre insira o acesso dentro de um teste de |
|
|
Fornece um url que pode ser usado para fornecer orientações para motoristas a partir deste resultado da pesquisa até uma localização especificada pelo usuário. Em alguns casos, esta propriedade pode estar ausente ou nula. Sempre insira o acesso dentro de um teste de |
|
|
Fornece um url para uma representação de imagem estática de mapa do resultado atual. A imagem tem 150px de largura por 100px de altura, com um único marcador representando a localização atual. O uso recomendável é para criar um hiperlink desta imagem usando a propriedade |
|
|
Esta propriedade indica o tipo deste resultado, que pode ser |
|
|
Para resultados "kml", esta propriedade contém um snippet de conteúdo associado ao resultado KML. Para resultados "locais", esta propriedade é a string vazia. |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados de uma Pesquisa local. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar suprimir o "address", use uma regra CSS #mycontrol .gs-localResult .gs-address { display : none; }#.
<div class="gs-result gs-localResult">
<!-- Note, a.gs-title can have embedded HTML
// so make sure to account for this in your rules.
// For instance, to change the title color to red,
// use a rule like this:
// a.gs-title, a.gs-title * { color : red; }
-->
<div class="gs-title">
<a class="gs-title"></a>
</div>
<!-- Note, ONLY present for "kml" results -->
<div class="gs-snippet"></div>
<div class="gs-address">
<div class="gs-street"></div>
<div class="gs-city"></div>
<div class="gs-region"></div>
<div class="gs-country"></div>
</div>
<div class="gs-phone"></div>
<!-- This element provides driving directions from
// the center point location to this result. This
// is the default setting.
-->
<div class="gs-directions">
<a class="gs-directions"></a>
</div>
<!-- This element provides driving directions to/from the search result
// with the user supplying the starting/ending point (based on the link
// they clicked on). This is an alternate link. If you want this behavior
// instead of the default, use a set of rules similar to this:
//
// #mycontrol .gs-directions { display : none; }
// #mycontrol .gs-directions-to-from { display : block; }
//
// Directions here are provided in the form of:
//
// Get directions: To here - From here
-->
<div class="gs-directions-to-from">
<div class="gs-label"></div>
<div class="gs-secondary-link">
<a class="gs-secondary-link"></a>
</div>
<div class="gs-spacer"></div>
<div class="gs-secondary-link">
<a class="gs-secondary-link"></a>
</div>
</div>
</div>
Este objeto é produzido pelo objeto GvideoSearchgoogle.search.VideoSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GvideoSearchgoogle.search.VideoSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o título do resultado de vídeo. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece uma descrição do videoclipe na forma de um snippet. |
|
|
Fornece o url de uma versão do resultado de vídeo para reprodução. |
|
|
Fornece a data de publicação do vídeo (formato rfc-822). |
|
|
Fornece o nome de quem publicou o vídeo, normalmente exibido em verde abaixo da miniatura do vídeo, de forma semelhante ao tratamento usado para o visibleUrl nos outros objetos de resultado de pesquisa. |
|
|
A duração aproximada do vídeo em segundos. |
|
|
Fornece a largura da miniatura do vídeo em pixels. |
|
|
Fornece a altura da miniatura do vídeo em pixels. |
|
|
Fornece o url de uma imagem em miniatura, que representa o vídeo visualmente. |
|
|
Se estiver presente, fornece o url da versão do vídeo em flash, que pode ser reproduzida dentro da sua página. Para reproduzir este vídeo, basta criar um elemento |
|
|
Se estiver presente, esta propriedade fornece o nome de usuário do YouTube do criador do vídeo. |
|
|
Se estiver presente, esta propriedade fornece uma contagem das reproduções deste vídeo. |
|
|
Se estiver presente, esta propriedade fornece a classificação do vídeo em uma escala de 1 a 5. |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados de uma Pesquisa de vídeos. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar suprimir o "snippet", use uma regra CSS #mycontrol .gs-videoResult .gs-snippet { display : none; }#.
<div class="gs-result gs-videoResult">
<table>
<tr>
<!-- The Result's Thumbnail image is sitting in this column -->
<td class="gs-image-box">
<div class="gs-image-box">
<a class="gs-image">
<img class="gs-image"></img>
</a>
</div>
</td>
<!-- The Result's Text based result data is sitting in this column -->
<td class="gs-text-box">
<div class="gs-text-box">
<!-- Note, a.gs-title can have embedded HTML
// so make sure to account for this in your rules.
// For instance, to change the title color to red,
// use a rule like this:
// a.gs-title, a.gs-title * { color : red; }
-->
<div class="gs-title">
<a class="gs-title"></a>
</div>
<div class="gs-snippet"></div>
<div class="gs-publishedDate"></div>
<div class="gs-publisher">
<a class="gs-publisher"></a>
</div>
</div>
</td>
</tr>
</table>
</div>
Este objeto é produzido pelo objeto GblogSearchgoogle.search.BlogSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GblogSearchgoogle.search.BlogSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o título da postagem de blog retornada como resultado da pesquisa. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece o URL da postagem de blog mencionada neste resultado de pesquisa. |
|
|
Fornece um snippet do conteúdo da postagem de blog associado a este resultado de pesquisa. |
|
|
Fornece o nome do autor da postagem de blog. |
|
|
Fornece o URL do blog que contém a postagem. Normalmente, este URL é exibido em verde abaixo do resultado da pesquisa em blogs e apresenta um link para o blog. |
|
|
Fornece a data de publicação (formato rfc-822) da postagem de blog mencionada neste resultado de pesquisa. |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados de uma Pesquisa de blogs. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar suprimir o "snippet", use uma regra CSS #mycontrol .gs-blogResult .gs-snippet { display : none; }#.
<div class="gs-result gs-blogResult">
<!-- Note, a.gs-title can have embedded HTML
// so make sure to account for this in your rules.
// For instance, to change the title color to red,
// use a rule like this:
// a.gs-title, a.gs-title * { color : red; }
-->
<div class="gs-title">
<a class="gs-title"></a>
</div>
<!-- The default CSS rule enables the relative
// published date while a result is sitting in
// a search control, and an absolute published date
// if the result is outside of the control. Using your
// own CSS rule, you can select whichever date form
// works best for your pages.
-->
<div class="gs-publishedDate"></div>
<div class="gs-relativePublishedDate"></div>
<div class="gs-snippet"></div>
<div class="gs-visibleUrl">
<a class="gs-visibleUrl"></a>
</div>
</div>
Este objeto é produzido pelo objeto GnewsSearchgoogle.search.NewsSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GnewsSearchgoogle.search.NewsSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o título da notícia retornada como resultado da pesquisa. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece o URL básico do resultado. |
|
|
Fornece uma versão do URL descrito acima com códigos de escape. |
|
|
Quando um resultado de notícia possui um conjunto de artigos relacionados, este URL fica disponível e não é nulo. Nessa situação, o URL aponta para uma página que aponta para todos os artigos relacionados. |
|
|
Fornece um snippet do conteúdo da notícia associado a este resultado de pesquisa. |
|
|
Fornece o nome do editor da notícia. |
|
|
Contém a localização da notícia. Esta é uma lista de locais em ordem do mais para o menos específico, onde os componentes são separados por ",". Pode haver apenas um elemento na lista. Um valor típico para esta propriedade é "Edinburgh,Scotland,UK" ou talvez "USA". |
|
|
Fornece a data de publicação (formato rfc-822) da notícia mencionada neste resultado de pesquisa. |
|
|
Esta propriedade é opcional. Ela aparece em um resultado somente quando a notícia também tiver um conjunto de artigos relacionados. Nesse caso, a matriz
|
|
|
Esta propriedade é opcional. Aparece em um resultado apenas quando o sistema tiver determinado que há uma boa imagem que representa o cluster de artigos relacionados a esse resultado. É importante observar que a imagem se relaciona ao cluster dos artigos, não apenas ao artigo que age como o artigo principal para este resultado. Por isso, é muito importante que sua interface do usuário relacionada não represente inadequadamente a imagem. Você sempre deve exibir a fonte de notícias dos artigos e da imagem, pois elas são normalmente diferentes. Você perceberá que, no Google Notícias, a imagem é exibida na lateral com a atribuição total para a fonte e com um hiperlink para o artigo associado à imagem, não o artigo associado ao resultado atual.
Esta propriedade é opcional. Nem sempre está presente. É melhor verificar
|
|
|
Esta propriedade é opcional. Quando presente, indica o idioma da notícia. |
Quando sua solicitação de pesquisa de notícias usa o argumento qsid para solicitar citações. O formato de resultado padrão é alterado para incluir propriedades específicas das citações. Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Um valor de |
|
|
Fornece o URL básico do resultado. |
|
|
Fornece uma versão do URL descrito acima com códigos de escape. |
|
|
Fornece o nome da pessoa a qual a citação é atribuída. |
|
|
Fornece um snippet de conteúdo da notícia que inclui as citações. |
|
|
Fornece o nome do editor da notícia. |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados de uma Pesquisa de notícias. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar suprimir o "snippet", use uma regra CSS #mycontrol .gs-newsResult .gs-snippet { display : none; }#.
<div class="gs-result gs-newsResult">
<!-- Note, a.gs-title can have embedded HTML
// so make sure to account for this in your rules.
// For instance, to change the title color to red,
// use a rule like this:
// a.gs-title, a.gs-title * { color : red; }
-->
<div class="gs-title">
<a class="gs-title"></a>
</div>
<div class="gs-publisher"></div>
<!-- The default CSS rule enables the relative
// published date while a result is sitting in
// a search control, and an absolute published date
// if the result is outside of the control. Using your
// own CSS rule, you can select whichever date form
// works best for your pages.
-->
<div class="gs-publishedDate"></div>
<div class="gs-relativePublishedDate"></div>
<div class="gs-snippet"></div>
<!-- If a result is related to other
// articles, this element is present.
-->
<div class="gs-clusterUrl">
<a class="gs-clusterUrl"></a>
</div>
</div>
Este objeto é produzido pelo objeto GbookSearchgoogle.search.BookSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GbookSearchgoogle.search.BookSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o título do livro. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece o URL básico do resultado. |
|
|
Fornece uma versão do URL descrito acima com códigos de escape. |
|
|
Fornece a lista de autores do livro. |
|
|
Fornece o identificador associado ao livro. Normalmente, é o ISBN. |
|
|
Fornece o ano de publicação do livro. |
|
|
Fornece o número de páginas do livro. |
|
|
Fornece um nó DOM HTML que representa uma imagem em miniatura da capa do livro. Observação: Se você desejar usar esta propriedade corretamente, é necessário clonar o nó (por ex., var cover = res.thumbnailHtml.cloneNode(true);). Além disso, se a geração de HTML tiver sido suprimida (usando |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados de uma Pesquisa de Livros. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar usar o estilo negrito para "page count", use uma regra CSS #mycontrol .gs-bookResult .gs-pageCount { font-weight : bold; }#.
<div class="gs-result gs-bookResult">
<table>
<tr>
<!-- The Result's Thumbnail image is sitting in this column -->
<td class="gs-image-box">
<!-- Applying your own styles to gs-row1/* and .gs-row2
// should be avoided. This structure is going to change.
// All you can really count on is a.gs-image/*.
-->
<div class="gs-image-box gs-book-image-box">
<!-- the page components -->
<div class="gs-row1">
<img class="gs-pages"></img>
<img class="gs-page-edge"></img>
</div>
<!-- the hyperlinked thumbnail -->
<div class="gs-row2">
<a class="gs-image">
<img class="gs-image"></img>
</a>
</div>
</div>
</td>
<!-- The Result's Text based result data is sitting in this column -->
<td class="gs-text-box">
<div class="gs-text-box">
<!-- Note, a.gs-title can have embedded HTML
// so make sure to account for this in your rules.
// For instance, to change the title color to red,
// use a rule like this:
// a.gs-title, a.gs-title * { color : red; }
-->
<div class="gs-title">
<a class="gs-title"></a>
</div>
<div class="gs-author"></div>
<div class="gs-publishedDate"></div>
<div class="gs-pageCount"></div>
<div class="gs-visibleUrl">
<a class="gs-visibleUrl"></a>
</div>
</div>
</td>
</tr>
</table>
</div>
Este objeto é produzido pelo objeto GimageSearchgoogle.search.ImageSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GimageSearchgoogle.search.ImageSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o título da imagem, normalmente o nome de arquivo. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece o URL básico da imagem. |
|
|
Fornece uma versão do URL descrito acima com códigos de escape. |
|
|
Fornece uma versão reduzida do URL associado ao resultado, normalmente exibido em verde e sem um protocolo e um caminho. |
|
|
Fornece o URL da página que contém a imagem. |
|
|
Fornece a largura da imagem em pixels. |
|
|
Fornece a altura da imagem em pixels. |
|
|
Fornece a largura da miniatura da imagem em pixels. |
|
|
Fornece a altura da miniatura da imagem em pixels. |
|
|
Fornece o url da imagem em miniatura. |
|
|
Fornece um pequeno snippet de informações da página associada ao resultado da pesquisa. |
|
|
Fornece as mesmas informações que |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados de uma Pesquisa de imagens. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar usar o estilo negrito para "image size as", use uma regra CSS #mycontrol .gs-imageResult .gs-size { font-weight : bold; }#.
<div class="gs-result gs-imageResult">
<div class="gs-image-box">
<!-- img is hyperlinked to the original content url -->
<a class="gs-image">
<!-- Note explicit sizing is set during thumbnail scaling -->
<img class="gs-image"/>
</a>
</div>
<div class="gs-text-box">
<div class="gs-snippet"></div>
<div class="gs-size"></div>
<div class="gs-visibleUrl"></div>
</div>
</div>
Este objeto é produzido pelo objeto GpatentSearchgoogle.search.PatentSearch. Ele está disponível na matriz .results[] do objeto.
Este objeto é indicado por um valor .GsearchResultClass de GpatentSearchgoogle.search.PatentSearch.RESULT_CLASS.
Além das propriedades comuns descritas acima, estão disponíveis as seguintes propriedades específicas ao objeto.
| Propriedade | Descrição |
|---|---|
|
|
Fornece o título do resultado de patente. |
|
|
Fornece o título, mas diferentemente de |
|
|
Fornece uma descrição do estilo do snippet da patente. |
|
|
Fornece o URL básico do resultado. |
|
|
Fornece uma versão do URL descrito acima com códigos de escape. |
|
|
Fornece a data do preenchimento da inscrição da patente (formato rfc-822). |
|
|
Fornece o número de patente das patentes emitidas e o número da inscrição para patentes solicitadas, mas ainda não emitidas. |
|
|
Fornece o status da patente que pode ser |
|
|
Fornece o procurador da patente. |
|
|
Fornece o URL de uma imagem em miniatura, que representa a patente visualmente. |
O fragmento de HTML abaixo ilustra a estrutura de uma propriedade .html dos resultados da Pesquisa de patentes do Google. A finalidade desta estrutura é mostrar os principais componentes estruturais, para que você possa alterar o estilo e a exibição de um resultado. Por exemplo, se desejar suprimir o "snippet", use uma regra CSS #mycontrol .gs-patentResult .gs-snippet { display : none; }#.
<div class="gs-result gs-patentResult">
<table>
<tr>
<!-- The Result's Thumbnail image is sitting in this column -->
<td class="gs-image-box">
<div class="gs-image-box">
<a class="gs-image">
<img class="gs-image"></img>
</a>
</div>
</td>
<!-- The Result's Text based result data is sitting in this column -->
<td class="gs-text-box">
<div class="gs-text-box">
<!-- Note, a.gs-title can have embedded HTML
// so make sure to account for this in your rules.
// For instance, to change the title color to red,
// use a rule like this:
// a.gs-title, a.gs-title * { color : red; }
-->
<div class="gs-title">
<a class="gs-title"></a>
</div>
<div class="gs-patent-info gs-metadata">
<div class="gs-patent-number"></div>
<div class="gs-publishedDate"></div>
<div class="gs-author"></div>
</div>
<div class="gs-snippet"></div>
</div>
</td>
</tr>
</table>
</div>
Para os desenvolvedores de Flash e desenvolvedores que precisam acessar a API AJAX de pesquisa a partir de outros ambientes sem Javascript, a API oferece uma interface RESTful simples. Em todos os casos, GET é o método suportado e o formato de resposta é um conjunto de resultados codificado JSON com códigos de status incorporados. Os aplicativos que usam esta interface devem obedecer a todos os termos de uso existentes. Você deve ter atenção especial quanto a se identificar corretamente em suas solicitações. Os aplicativos sempre DEVEM incluir um cabeçalho de referência http em suas solicitações. Além disso, pedimos que cada solicitação contenha uma chave de API válida, mas isso não é obrigatório. Ao fornecer uma chave, seu aplicativo nos fornece um mecanismo secundário de identificação. Isso é útil para o caso de ser necessário entrar em contato com você para corrigir algum problema. Obtenha mais informações sobre a utilidade de ter uma chave de API
Assim como a interface JavaScript principal, esta interface é oferecida por meio de um URL uniforme que contém uma mistura de argumentos CGI padrão e específicos da pesquisa. Seu aplicativo pode usar uma pilha HTTP de sua própria escolha. Os únicos requisitos são que você deve ser capaz de construir apropriadamente um URL com todos os argumentos CGI necessários, deve enviar um cabeçalho de referência http identificando precisamente seu aplicativo e deve processar a resposta codificada JSON.
Cada extremidade da pesquisa é acessada através de um URL padrão. A tabela a seguir indica o URL usado para acessar cada serviço.
| Pesquisa | URL básico |
|---|---|
| Pesquisa na web | http://ajax.googleapis.com/ajax/services/search/web |
| Pesquisa local | http://ajax.googleapis.com/ajax/services/search/local |
| Pesquisa de vídeos | http://ajax.googleapis.com/ajax/services/search/video |
| Pesquisa de blogs | http://ajax.googleapis.com/ajax/services/search/blogs |
| Pesquisa de notícias | http://ajax.googleapis.com/ajax/services/search/news |
| Pesquisa de Livros | http://ajax.googleapis.com/ajax/services/search/books |
| Pesquisa de imagens | http://ajax.googleapis.com/ajax/services/search/images |
| Pesquisa de patentes | http://ajax.googleapis.com/ajax/services/search/patentNovo! |
Cada solicitação contém uma mistura de argumentos padrão de URL e um conjunto opcional de argumentos específicos à pesquisa. Esta seção descreve os argumentos padrão uniformizados em todas as pesquisas e que transmitem informações semânticas virtualmente idênticas para cada pesquisa. Em alguns casos, o uso de um argumento é opcional. Isso é indicado por um sinal ?a o lado do nome do argumento. Em todos os casos, o valor do argumento CGI deve estar devidamente seguido dos códigos de escape (por ex., através da função equivalente do método JavaScript encodeURIComponent()).
A tabela a seguir lista os argumentos padrão de URL. Há seções adicionais abaixo destacando os argumentos específicos da pesquisa.
| Argumento | Exemplo | Descrição |
|---|---|---|
| q | q=Paris%20Hilton | Este argumento fornece a consulta ou expressão de pesquisa passada à pesquisa. |
| v | v=1.0 |
Este argumento fornece o número da versão do protocolo. O único valor válido no momento é 1.0.
|
| rsz? | rsz=small |
Este argumento opcional fornece o número de resultados que o aplicativo deseja receber. O valor small indica um conjunto de resultados pequeno, ou 4 resultados. O valor large indica um conjunto de resultados grande, ou 8 resultados. Se este argumento não for fornecido, o valor small é assumido.
|
| hl? | hl=fr |
Este argumento opcional fornece o idioma do host do aplicativo que está realizando a solicitação. Se este argumento não estiver presente, o sistema escolhe um valor com base no valor do cabeçalho http Accept-Language. Se este cabeçalho não estiver presente, será usado o valor en.
|
| key? | key=your-key | Este argumento opcional fornece a chave do aplicativo. Se especificado, ele deve ser uma chave válida associada ao site, validada pelo cabeçalho de referência passado. A vantagem de fornecer uma chave é a possibilidade de identificarmos e entrarmos em contato com você, caso ocorra algo de errado com seu aplicativo. Sem uma chave, também tomaremos as mesmas medidas apropriadas, mas não poderemos entrar em contato com você. Definitivamente, é melhor para você informar uma chave. |
| início? | start=4 |
Este argumento opcional fornece o parâmetro start-index do primeiro resultado da pesquisa. Cada resposta bem-sucedida contém um objeto cursor (veja abaixo) que inclui uma matriz de pages. A propriedade start de uma página pode ser usada como valor válido para este argumento. Para referência, veja a amostra de um objeto de cursor descrita abaixo:
"cursor": {
"pages": [
{ "start": "0", "label": 1 },
{ "start": "4", "label": 2 },
{ "start": "8", "label": 3 },
{ "start": "12","label": 4 } ],
"estimatedResultCount": "48758",
"currentPageIndex": 0,
"moreResultsUrl": "http://www.google.com/search..."
}
|
| callback? | callback=foo |
Este argumento opcional altera o formato de resposta padrão. Quando fornecido, em vez de produzir um objeto codificado JSON simples, o sistema produz uma resposta de chamada de função JavaScript onde o valor de callback especifica o nome da função chamada na resposta.
callbackFunction(
{"responseData" : {
"results" : [],
"cursor" : {}
},
"responseDetails" : null | string-on-error,
"responseStatus" : 200 | error-code
});
|
| context? | context=bar |
Este argumento opcional está relacionado ao argumento context. Quando ambos são fornecidos, o valor de context altera o formato de resposta normal associado ao callback. O novo formato é:
callbackFunction(
contextValue, // the context arg value
responseObject, // the collection of results and cursor
responseStatus, // 200 on success, non-200 on failure
errorDetails) // error string for non-200 response
|
Como discutido rapidamente na seção anterior, há duas variações principais do formato de resposta. Quando os argumentos callback e context não são fornecidos, o formato de resposta é um objeto JSON simples:
{
"responseData" : {
"results" : [],
"cursor" : {}
},
"responseDetails" : null | string-on-error,
"responseStatus" : 200 | error-code
}
No fragmento JSON acima, a propriedade responseData contém uma matriz results e um cursor opcional. Eles são semântica e estruturalmente idênticos aos resultados retornados por meio da camada JavaScript Searchers. A propriedade responseStatus contém o valor 200 para sucesso e um código de status de erro http diferente de 200 para falha. Se houver uma falha, a propriedade responseDetails contém uma string de diagnóstico.
Ao usar o argumento callback, os aplicativos podem facilmente solicitar um retorno de chamada do JavaScript:
callback({
"responseData" : {
"results" : [],
"cursor" : {}
},
"responseDetails" : null | string-on-error,
"responseStatus" : 200 | error-code
});
Se o aplicativo fornecer ambos os argumentos callback e context , a resposta é codificada como uma chamada de procedimento JavaScript. Neste modo de operação, o valor de callback torna-se o destino da chamada do procedimento; o valor de context é passado como o primeiro argumento; o valor de responseData acima é passado como o segundo argumento; o status da resposta é passado como o terceiro argumento, e o argumento final é null ou uma string de diagnóstico.
foo('bar',{
"results": [
{
"GsearchResultClass": "GwebSearch",
"unescapedUrl": "http://en.wikipedia.org/wiki/Paris_Hilton",
"url": "http://en.wikipedia.org/wiki/Paris_Hilton",
"visibleUrl": "en.wikipedia.org",
"cacheUrl": "http://www.google.com/search?q\u003dcache:TwrPfhd22hYJ:en.wikipedia.org",
"title": "\u003cb\u003eParis Hilton\u003c/b\u003e - Wikipedia, the free encyclopedia",
"titleNoFormatting": "Paris Hilton - Wikipedia, the free encyclopedia",
"content": "In 2006, she released her debut album \u003cb\u003eParis\u003c/b\u003e..."
},
{
"GsearchResultClass": "GwebSearch",
"unescapedUrl": "http://www.imdb.com/name/nm0385296/",
"url": "http://www.imdb.com/name/nm0385296/",
"visibleUrl": "www.imdb.com",
"cacheUrl": "http://www.google.com/search?q\u003dcache:1i34KkqnsooJ:www.imdb.com",
"title": "\u003cb\u003eParis Hilton\u003c/b\u003e",
"titleNoFormatting": "Paris Hilton",
"content": "Self: Zoolander. Socialite \u003cb\u003eParis Hilton\u003c/b\u003e was..."
},
...
],
"cursor": {
"pages": [
{ "start": "0", "label": 1 },
{ "start": "4", "label": 2 },
{ "start": "8", "label": 3 },
{ "start": "12","label": 4 }
],
"estimatedResultCount": "59600000",
"currentPageIndex": 0,
"moreResultsUrl": "http://www.google.com/search?oe\u003dutf8..."
}
}
, 200, null)
O sistema da Pesquisa na web suporta diversos argumentos opcionais listados abaixo:
| Argumento | Descrição |
|---|---|
| cx? |
Este argumento opcional fornece o ID exclusivo do Mecanismo de pesquisa personalizado, que deve ser usado para esta solicitação (por exemplo, cx=000455696194071821846:reviews).
|
| cref? |
Este argumento opcional fornece o URL de uma especificação vinculada do Mecanismo de pesquisa personalizado, que deve ser usado para atender a esta solicitação (por exemplo, cref=http%3A%2F%2Fwww.google.com%2Fcse%2Fsamples%2Fvegetarian.xml).
|
| safe? |
Este argumento opcional fornece o nível de segurança da pesquisa, que pode ser:
|
| lr? |
Este argumento opcional permite que o originador da chamada restrinja a pesquisa aos documentos escritos em um idioma específico (por exemplo, lr=lang_ja). Esta lista contém o conjunto de valores permitidos.
|
| filter? Novo! |
Esse argumento opcional controla a ativação ou desativação do filtro de conteúdo duplicado:
|
O sistema da Pesquisa local suporta diversos argumentos opcionais listados abaixo:
| Argumento | Descrição |
|---|---|
| sll? |
Este argumento opcional fornece o ponto central de pesquisa para uma pesquisa local. Seu valor é um par de coordenadas latitude/longitude separado por vírgulas, por ex., sll=48.8565,2.3509.
|
| sspn? |
Este argumento opcional fornece uma caixa delimitadora à qual a pesquisa local deve ser relacionada. Ao usar o Google Maps, o valor sspn pode ser calculado usando: myMap.getBounds().toSpan().toUrlValue(); ( por exemplo, sspn=0.065169,0.194149).
|
| mrt? |
Este argumento opcional especifica em qual tipo de lista o usuário está interessado. Os valores válidos incluem:
localonly será usado.
|
O sistema da Pesquisa de vídeos suporta diversos argumentos opcionais listados abaixo:
| Argumento | Descrição |
|---|---|
| scoring? |
Este argumento opcional informa ao sistema da pesquisa de vídeos como ordenar os resultados. Os resultados podem ser ordenados por relevância (padrão) ou por data. Para selecionar a ordem por relevância, não forneça este argumento. Para selecionar a ordenação por data, defina scoring como scoring=d.
|
O sistema da Pesquisa de blogs suporta diversos argumentos opcionais listados abaixo:
| Argumento | Descrição |
|---|---|
| scoring? |
Este argumento opcional informa ao sistema da pesquisa de blogs como ordenar os resultados. Os resultados podem ser ordenados por relevância (padrão) ou por data. Para selecionar a ordem por relevância, não forneça este argumento. Para selecionar a ordenação por data, defina scoring como scoring=d.
|
O sistema da Pesquisa de notícias suporta diversos argumentos opcionais listados abaixo:
| Argumento | Descrição |
|---|---|
| scoring? |
Este argumento opcional informa ao sistema da pesquisa de notícias como ordenar os resultados. Os resultados podem ser ordenados por relevância (padrão) ou por data. Para selecionar a ordem por relevância, não forneça este argumento. Para selecionar a ordenação por data, defina scoring como scoring=d.
|
| geo? |
Este argumento opcional informa ao sistema da pesquisa de notícias que os resultados de pesquisa devem ser limitados a uma localização específica. Com este argumento presente, o argumento da consulta (q) torna-se opcional. Este é um recurso bem novo e a cobertura das consultas com delimitação local é um pouco limitada. Você deve fornecer uma cidade, estado, país ou CEP, como em geo=Santa%20Barbara ou geo=British%20Columbia ou geo=Peru ou geo=93108.
|
| qsid? |
Esse argumento opcional informa ao sistema de pesquisa de notícias para limitar os resultados da pesquisa de modo a incluir apenas resultados do tipo citação (em vez dos resultados com estilo de artigos de notícias clássicos). Com este argumento presente, o argumento da consulta (q) torna-se opcional. O valor deste argumento designa uma pessoa proeminente, cujas as citações foram reconhecidas e classificadas pelo serviço de pesquisa do Google Notícias. Por exemplo, Barack Obama tem um valor qsid de tPjE5CDNzMicmM e John McCain tem um valor de lE61RnznhxvadM. Este é um recurso muito novo e, no momento, ainda não temos um bom mecanismo de pesquisa ou de detecção para esses valores qsid.
|
| topic? |
Este argumento opcional solicita que o sistema de pesquisa de notícias limite os resultados da pesquisa de acordo com um tópico específico. O valor do argumento especifica o tópico na edição atual ou selecionada:
&rsz) e, quando usado com uma consulta, a consulta é analisada com base no tópico especificado.
Os tópicos podem variar um pouco de acordo com a edição. Por exemplo, nas edições africanas como Namíbia ou Zimbábue |
| ned? |
Este argumento opcional informa ao sistema de pesquisa de notícias de qual edição de notícias obter os resultados. Os valores incluem:
&ned na barra de endereços do navegador.
|
O sistema da Pesquisa de Livros suporta diversos argumentos opcionais listados abaixo:
| Argumento | Descrição |
|---|---|
| as_brr? |
Este argumento opcional informa ao sistema da Pesquisa de Livros que a pesquisa de livros deve ser restringida aos livros com visualização completa ou aberta a todos os livros. O valor as_brr=1 restringe a pesquisa a apenas os livros que podem ser visualizados totalmente. O padrão é todos os livros, e isso é indicado pela não especificação deste argumento.
|
| as_list? | Este argumento opcional informa ao sistema da pesquisa de livros que a pesquisa deve ser restringida à biblioteca definida pelo usuário especificada. |
O sistema da Pesquisa de imagens do Google suporta diversos argumentos opcionais listados abaixo. Além disso, os resultados podem ser restringidos ao arquivo de fotos LIFE incluindo source:life como parte da consulta, como em q=source%3Alife+query+terms (experimental).
| Argumento | Descrição |
|---|---|
| safe? |
Este argumento opcional fornece o nível de segurança da pesquisa, que pode ser:
|
| imgsz? |
Este argumento opcional informa ao sistema de pesquisa de imagens que a pesquisa deve ser restringida às imagens com o tamanho especificado, que pode ser:
|
| imgc? |
Este argumento opcional informa ao sistema de pesquisa de imagens que a pesquisa deve ser restringida às imagens com as cores especificadas, que podem ser:
|
|
imgcolor?Novo! (experimental) |
Este argumento opcional informa ao sistema da pesquisa de imagens que a pesquisa deve ser filtrada às imagens da cor especificada:
|
|
imgtype? (experimental) |
Este argumento opcional informa ao sistema da pesquisa de imagens que a pesquisa deve ser restringida às imagens do tipo especificado:
|
| as_filetype? |
Este argumento opcional informa ao sistema de pesquisa de imagens que a pesquisa deve ser restringida às imagens do tipo de arquivo especificado, que pode ser:
|
| as_sitesearch? |
Este argumento opcional informa ao sistema da pesquisa de imagens que a pesquisa deve ser restringida às imagens dentro do domínio especificado, por ex., as_sitesearch=photobucket.com. Observação: Essa restrição pode restringir os resultados às imagens encontradas nas páginas no URL determinado e/ou às imagens com o URL determinado.
|
O sistema da Pesquisa de patentes suporta diversos argumentos opcionais listados abaixo:
| Argumento | Descrição |
|---|---|
| as_psrg? |
Este argumento opcional informa ao sistema da pesquisa de patentes que a pesquisa deve ser restringida APENAS às patentes emitidas, ignorando todas as patentes apenas solicitadas. Quando especificado, esse valor deve ser 1, como em &as_psrg=1
|
| as_psra? |
Este argumento opcional informa ao sistema da pesquisa de patentes que a pesquisa deve ser restringida APENAS às patentes que foram apenas solicitadas, ignorando todas as patentes emitidas. Quando especificado, esse valor deve ser 1, como em &as_psrg=1
|
| scoring? |
Este argumento opcional informa ao sistema da pesquisa de patentes como ordenar os resultados. Os resultados podem ser ordenados por relevância (padrão) ou por data. Para selecionar a ordem por relevância, não forneça este argumento. Para selecionar a ordem de acordo com datas decrescentes, na qual o resultado mais atual é o primeiro, defina o a pontuação como scoring=d. Para selecionar a ordem de acordo com datas crescentes, na qual o resultado mais antigo é o primeiro, defina a pontuação como scoring=ad.
|
Ao adicionar uma pesquisa ao controle de pesquisa, o objeto GsearcherOptionsgoogle.search.SearcherOptions pode ser especificado. Se for especificado, fornecerá diversas opções usadas para controlar determinados aspectos da pesquisa relacionada. Este objeto é implementado principalmente como um pacote de propriedades, conectado a uma determinada classe de pesquisa. Algumas de suas propriedades se aplicam uniformemente a todas as pesquisas, enquanto outras se aplicam apenas a tipos específicos. É o aplicativo que deve usá-lo apropriadamente, definindo as opções corretas e usando-as da maneira apropriada.
Este objeto permite que o originador da chamada controle o modo de expansão padrão (ou seja, como os resultados de pesquisa são exibidos nas seções da pesquisa quando a pesquisa é concluída), no qual os resultados de pesquisa da página web e diversas opções específicas da pesquisa são exibidas. O fragmento a seguir demonstra como usar a classe correspondente para definir as opções da pesquisa.
// create a searcher options object // set up for open expansion mode // load a searcher with these options var options = new GsearcherOptionsgoogle.search.SearcherOptions(); options.setExpandMode(GSearchControlgoogle.search.SearchControl.EXPAND_MODE_OPEN); searchControl.addSearcher(new GwebSearchgoogle.search.WebSearch(), options);
Depois que um objeto de opções de pesquisa é usado em uma chamada .addSearcher(), a alteração de suas propriedades tem efeito indefinido. O uso esperado é que haja a definição de um objeto options, que ele seja utilizado na adição de uma pesquisa e que nunca mais seja alterado.
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto options de pesquisa. Este objeto fornece diversas configurações usadas pelo controle da pesquisa. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para comunicar à pesquisa o modo de expansão desejado para os resultados quando a pesquisa for concluída.
|
|
|
Este método é usado para instruir o controle de pesquisa a desenhar os resultados da pesquisa associada no elemento recipiente fornecido, em vez de desenhar no recipiente padrão alocado durante a execução do método
|
|
|
Este método permite que o originador da chamada especifique um fator de dimensionamento padrão alternativo, aplicado aos resultados de pesquisas de vídeos quando são exibidos pelo controle de pesquisa. A altura fornecida também afeta a largura resultante do vídeo. O sistema mantém uma proporção de 4x3 para vídeos, de modo que a largura resultante do vídeo seja a altura * 1,33. O resultado é um objeto imageScaler (consulte GSearchgoogle.search.Search.scaleImage). O uso desta função afeta a regra CSS
|
|
|
Este método permite que o originador da chamada especifique um fator de dimensionamento padrão alternativo, aplicado a resultados de pesquisa de imagens quando são exibidos pelo controle de pesquisa. A altura fornecida também afeta a largura resultante da imagem. O sistema mantém uma proporção de 4x3 para as imagens. Portanto, a largura resultante da imagem é a altura * 1,33. O resultado é um objeto imageScaler (consulte GSearch.scaleImage). O uso desta função afeta a regra CSS
|
|
|
Normalmente, o slot da pesquisa no controle de pesquisa é deixado vazio quando uma pesquisa não produz resultados. Este método permite que o originador da chamada especifique uma string que fornece um "resultado" padrão. O sistema contém o valor
|
Ao solicitar que um controle de pesquisa realize um desenho, é necessário especificar um recipiente no qual o controle irá desenhar. Além deste parâmetro obrigatório, o método .draw() do controle de pesquisa também aceita um objeto GdrawOptionsgoogle.search.DrawOptions opcional. Este objeto permite que o aplicativo solicite um layout linear ou com guias (linear é o padrão). Além disso, este objeto permite que o aplicativo solicite que o "formulário de pesquisa" (isto é, o elemento de entrada, botão, controles etc.). associado à pesquisa seja desacoplado do conjunto de resultados de pesquisa. Para isso, use o método .setSearchFormRoot() e forneça um recipiente para hospedar o formulário de pesquisa.
Em um modo mais avançado que o descrito acima, este objeto permite que os aplicativos solicitem que o controle de pesquisa não crie um formulário de pesquisa e, em vez disso, use um elemento de entrada de texto fornecido pelo aplicativo. Quando esta opção é especificada, o controle de pesquisa assume o controle do elemento de entrada, capturando eventos onkeyup e onpaste. A lista de eventos capturada pelo controle poderá mudar com o tempo. Ao entregar um elemento de entrada ao controle de pesquisa, o aplicativo simplesmente assume a responsabilidade pelo posicionamento do elemento, bem como pelo estilo. Quando o elemento de entrada tiver sido entregue ao controle, o aplicativo não deve interagir com o elemento de nenhuma outra maneira que não seja para ler seu valor, se necessário.
O fragmento a seguir demonstra como usar este objeto para solicitar que o controle de pesquisa realize seu desenho no modo "com guias".
// create a drawOptions object var drawOptions = new GdrawOptionsgoogle.search.DrawOptions(); drawOptions.setDrawMode(GSearchControlgoogle.search.SearchControl.DRAW_MODE_TABBED); searchControl.draw(element, drawOptions);
O fragmento a seguir demonstra como usar este objeto para solicitar que o formulário de pesquisa seja desacoplado do conjunto de resultados de pesquisa.
...
<div id="searchForm">Loading...</div>
...
var searchFormElement = document.getElementById("searchForm");
var drawOptions = new GdrawOptionsgoogle.search.DrawOptions();
drawOptions.setSearchFormRoot(searchFormElement);
searchControl.draw(element, drawOptions);
| Construtor | Descrição |
|---|---|
|
|
O construtor é usado para criar uma instância de um objeto de opções de desenho. Este objeto fornece diversas configurações usadas pelo controle de pesquisa durante a fase de desenho. Especificamente, ele fornece controle sobre o modo com guias em vez do modo linear, além de fornecer ao aplicativo uma maneira de entregar um elemento de entrada ao controle de pesquisa. O padrão de um objeto de opções de desenho recém-construído é o modo linear, com o elemento de entrada de texto pertencendo/sendo criado pelo controle de pesquisa. |
| Método | Descrição |
|---|---|
|
|
Este método é usado para entregar um elemento de entrada ao controle de pesquisa. Em vez de criar seu próprio elemento de entrada de texto para capturar as consultas da pesquisa, o controle usará este elemento de entrada fornecido pelo aplicativo.
Quando esta opção é especificada, o controle de pesquisa assume o controle do elemento de entrada, captura
|
|
|
Este método é usado para instruir o controle de pesquisa a desenhar os resultados no modo "com guias" ou "linear".
|
|
|
Este método é usado para indicar que você deseja que o formulário de pesquisa seja colocado neste recipiente DOM especificado por "element", em vez de ser colocado em sua localização padrão, isto é, próximo aos resultados de pesquisa. Ver exemplo (searchformroot.html)
|