dhbxSrSSKJrJrJrJr SSKJr SSKJ r SSK J r J r J r \"SSSS 9"S S \ 55rg ) zUtil that calls Google Search.)AnyDictListOptional) deprecated)get_from_dict_or_env) BaseModel ConfigDictmodel_validatorz0.0.33z1.0z1langchain_google_community.GoogleSearchAPIWrapper)sinceremovalalternative_importc \rSrSr%SrSr\\S'Sr\ \ \S'Sr \ \ \S'Sr \ \S'Sr\\S '\"S S 9rS \ S \S\\4Sjr\"SS9\S\S\4Sj55rS\ S\ 4SjrSS\ S\ S\ \\ \ 4S\\4SjjrSrg)GoogleSearchAPIWrapper uWrapper for Google Search API. Adapted from: Instructions adapted from https://stackoverflow.com/questions/ 37083058/ programmatically-searching-google-in-python-using-custom-search TODO: DOCS for using it 1. Install google-api-python-client - If you don't already have a Google account, sign up. - If you have never created a Google APIs Console project, read the Managing Projects page and create a project in the Google API Console. - Install the library using pip install google-api-python-client 2. Enable the Custom Search API - Navigate to the APIs & Services→Dashboard panel in Cloud Console. - Click Enable APIs and Services. - Search for Custom Search API and click on it. - Click Enable. URL for it: https://console.cloud.google.com/apis/library/customsearch.googleapis .com 3. To create an API key: - Navigate to the APIs & Services → Credentials panel in Cloud Console. - Select Create credentials, then select API key from the drop-down menu. - The API key created dialog box displays your newly created key. - You now have an API_KEY Alternatively, you can just generate an API key here: https://developers.google.com/custom-search/docs/paid_element#api_key 4. Setup Custom Search Engine so you can search the entire web - Create a custom search engine here: https://programmablesearchengine.google.com/. - In `What to search` to search, pick the `Search the entire Web` option. After search engine is created, you can click on it and find `Search engine ID` on the Overview page. N search_enginegoogle_api_key google_cse_idkF siterestrictforbid)extra search_termkwargsreturnc URR5nUR(aUR5nUR"SXRS.UD6R 5nUR S/5$)N)qcxitems)rcserlistrexecuteget)selfrrr!ress c/var/www/html/shao/venv/lib/python3.13/site-packages/langchain_community/utilities/google_search.py_google_search_results-GoogleSearchAPIWrapper._google_search_results@sc  $$&   ""$ChhF););FvFNNPwww##before)modevaluesc[USS5nX!S'[USS5nX1S'SSKJn U"SS US 9nXQS 'U$![a [S5ef=f) z?Validate that api key and python package exists in environment.rGOOGLE_API_KEYr GOOGLE_CSE_IDr)buildzqgoogle-api-python-client is not installed. Please install it with `pip install google-api-python-client>=2.100.0` customsearchv1) developerKeyr)rgoogleapiclient.discoveryr1 ImportError)clsr-rrr1services r'validate_environment+GoogleSearchAPIWrapper.validate_environmentGs. $&6 $2 ,V_oV "/  7>J")    s 8Aqueryc/nURXRS9n[U5S:XagUHnSU;dM URUS5 M! SR U5$)z0Run query through GoogleSearch and parse result.)numr&No good Google Search Result was foundsnippet )r(rlenappendjoin)r%r;snippetsresultsresults r'runGoogleSearchAPIWrapper.runbsa--e-@ w<1 ;FF"y 12xx!!r* num_results search_paramsc/nUR"U4SU0U=(d 0D6n[U5S:XaSS0/$UH-nUSUSS.nSU;aUSUS'URU5 M/ U$) aRun query through GoogleSearch and return metadata. Args: query: The query to search for. num_results: The number of results to return. search_params: Parameters to be passed on search Returns: A list of dictionaries with the following keys: snippet - The description of the result. title - The title of the result. link - The link to the result. r=rResultr>titlelink)rMrNr?)r(rArB)r%r;rIrJmetadata_resultsrErFmetadata_results r'rEGoogleSearchAPIWrapper.resultsns&--  " '4':  w<1 GHI IFvOF"-3I-> *  # #O 4 r*r )N)__name__ __module__ __qualname____firstlineno____doc__rr__annotations__rrstrrrintrboolr model_configrdictr(r classmethodrr9rGrE__static_attributes__r r*r'rr s $LM3$(NHSM(#'M8C=' AsKL$L$#$$d$(#$3$2 " " " 37 " " "  S#X/ " d " " r*rN)rVtypingrrrrlangchain_core._api.deprecationrlangchain_core.utilsrpydanticr r r rr r*r'rcsF$,,65;;  J A YA  A r*