Descarga laravel google custom search engine - laravel google custom search engine Descarga del código fuente

laravel google custom search engine

Otro código fuente

1.0.3

Descargar

#Laravel Paquete Laravel del motor de búsqueda personalizado de Google para obtener resultados de la búsqueda personalizada de Google desde la API del motor de búsqueda personalizado de Google, tanto para la versión gratuita como de pago.

Breve historia

Cuando Swiftype cerró los planes gratuitos, comencé a buscar alguna alternativa sin demasiada codificación, pero no tuve éxito. Lo mejor que encontré fue el paquete de búsqueda de Google de Spatie para la versión paga de Google CSE, así que investigué un poco y desarrollé un paquete de manera similar, pero independiente de la versión de Google CSE.

Café para desarrolladores

Si te gusta este proyecto, puedes invitarme a un café para ayudarme a refrescarme. :) https://ko-fi.com/A067ES5

Instalación

1/ Instalar con Composer

composer require jan-drda/laravel-google-custom-search-engine

2/ Agregue el proveedor de servicios a config/app.php

 ' providers ' => [
    ' ... ' ,
    ' JanDrdaLaravelGoogleCustomSearchEngineLaravelGoogleCustomSearchEngineProvider '
];

3/ Agregue alias para Fachada a config/app.php

 ' aliases ' => [
	...
	' GoogleCseSearch ' => ' JanDrdaLaravelGoogleCustomSearchEngineFacadesLaravelGoogleCustomSearchEngineProvider ' ,
	...
]

4/ Publicar el archivo de configuración

php artisan vendor:publish --provider= " JanDrdaLaravelGoogleCustomSearchEngineLaravelGoogleCustomSearchEngineProvider "

Configuración

Creando tu motor de búsqueda personalizado

Si crea su motor en https://cse.google.com/cse/ encontrará el ID después de hacer clic en Configuración
Simplemente verifique la URL que tiene como https://cse.google.com/cse/setup/basic?cx=search_engine_id y la cadena después de cx= es su ID de motor de búsqueda.

!! Atención !! Si cambia el estilo de su motor de búsqueda personalizado, se puede cambiar el ID

Obtenga su clave API

vaya a https://console.developers.google.com, luego
haga clic en el menú en el lado derecho del logotipo de GoogleAPI y haga clic en 'Crear proyecto'
ingresa el nombre del nuevo proyecto; depende de ti, puedes usar 'Google CSE'
espere hasta que se cree el proyecto: el indicador es un círculo de color en la esquina superior derecha alrededor del ícono de campana
Se muestra la lista de API: busque 'API de búsqueda personalizada de Google' y haga clic en ella.
Haga clic en el ícono 'Habilitar' en el lado derecho del título de la API de búsqueda personalizada.
haga clic en 'Credenciales' en el menú de la izquierda en la sección 'Biblioteca'
Haga clic en 'Crear credenciales' y elija 'Clave API'
Se muestra su clave API, así que cópiela y péguela aquí.

Guarde los valores de configuración.

Guarde el ID del motor de búsqueda y el ID de la API en su configuración/laravelGoogleCustomSearchEngine.php

Uso

Uso sencillo

Cree un objeto y llame a la función getResults para obtener los primeros 10 resultados

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'

No olvide asignar el espacio de nombres, por lo que el controlador de muestra se verá así (en forma mínima)

Es solo un ejemplo de nombre de controlador, puedes usar el que quieras, este es un aviso principalmente para principiantes en Laravel.

 namespace App  Http  Controllers ;

use App  Http  Controllers  Controller ;
use JanDrda  LaravelGoogleCustomSearchEngine  LaravelGoogleCustomSearchEngine ;

class GoogleSearchController extends Controller
{

  public function index (){
    $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
    $ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase' 
  }
}

También puede obtener información sobre la búsqueda, como registros totales y tiempo de búsqueda.

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase' 
$ info = $ fulltext -> getSearchInformation (); // get search information

Uso avanzado

Puede utilizar cualquier parámetro admitido por Google. La lista de parámetros está aquí: https://developers.google.com/custom-search/json-api/v1/reference/cse/list#parameters

Por ejemplo, desea obtener los siguientes 10 resultados.

 $ parameters = array (
    ' start ' => 10 // start from the 10 th results,
    ' num ' => 10 // number of results to get, 10 is maximum and also default value
)

$ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' , $ parameters ); // get second 10 results for query 'some phrase'

También puede obtener el resultado sin procesar de Google, incluida otra información. La lista completa de variables de respuesta está disponible aquí: https://developers.google.com/custom-search/json-api/v1/reference/cse/list#response

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results = $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'
$ rawResults = $ fulltext -> getRawResults (); // get complete response from Google

Para obtener el número de resultados utilice únicamente

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize
$ results =  $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'
$ noOfResults = $ fulltext -> getTotalNumberOfResults (); // get total number of results (it can be less than 10)

Si tiene más motores/más claves de API, puede anular las variables de configuración con las siguientes funciones

 $ fulltext = new LaravelGoogleCustomSearchEngine (); // initialize

$ fulltext -> setEngineId ( ' someEngineId ' ); // sets the engine ID
$ fulltext -> setApiKey ( ' someApiId ' ); // sets the API key

$ results =  $ fulltext -> getResults ( ' some phrase ' ); // get first 10 results for query 'some phrase'