> For the complete documentation index, see [llms.txt](https://bothub.gitbook.io/project/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bothub.gitbook.io/project/advanced-tool/plugin/google-search.md).
# Google搜索插件
## Google搜索，用好世上最强大的搜索引擎
很多时候，我们没有办法预先知道用户想要什么东西，那么，提供一个由用户输入的搜索词，通过搜索引擎进行搜索不失为一个好主意。BotHub通过Google搜索组件，通过搜索引擎Google为您达成任意关键词的搜索功能。
{% hint style="success" %}
在内容块的编辑页面中，点击 "高级插件" - "Google搜索"，创建一个Google搜索的高级组件。
{% endhint %}
创建成功后的Google搜索组件，类似于RSS Feed组件，可以输入一些参数，以及定制最终展示给用户的橱窗卡片的样式。
Google搜索组件中，有几个重要的输入参数，第一个就是 API KEY。
这个API KEY，是Google Custom Search的API KEY，您创建的 Google搜索 的组件，使用的是有我们提供的BotHub的API KEY，我们每天为所有客户提供一定次数的免费搜索作为测试，因此，搜索功能可能因为次数用完失效。 我们建议您通过 自行申请一个 API KEY，Google每天提供100次免费搜索请求，在您付费的情况下，最多每天提供10000次搜索请求，BotHub会对相同的搜索结果进行缓存，以减少您每天使用的搜索次数。
Google搜索组件中，第二个重要的参数，就是您限制搜索所在的网址，所有的搜索结果都会限制在您所设置的网址之内。
Google搜索组件中，第三个重要的参数，就是用户的搜索词，我们在 "用户输入" 组件的文档中，已经告诉您，可以通过将用户的输入，记录在特定的参数中，在Google搜索中引用，并在参数名外带上两层花括号
```
```
如果您想直接引用用户最后输入的文本，您可以使用。
**搜索结果在用户端的显示效果如下 ：**
Google搜索的其它参数，和RSS Feed的参数类似，主要用户提供返回的橱窗卡片和订阅卡片的样式。
Google搜索的订阅卡片和RSS Feed的卡片略有不同，不能设置图片，而是由系统自动生成一张用户所使用的搜索词的图片，用户可以订阅这个关键词的动态搜索结果，这个对于订阅特定主题的新闻非常有用。
## 如何更改 Google 搜索时的搜索来源网站？
很简单，跟着我的步骤试一下👇
首先我们创建 Google 搜索插件后，在插件界面找到 “搜索引擎 ID“,后面所填充的一串数字就是搜索引擎ID 号码了。只需通过 Google 的自定义搜索网站上的新增搜索引擎功能， 用需要替换的来源网站 URL 重新创建新的 搜索引擎ID 并替换 Google 搜索插件中的“搜索引擎 ID“,就完成了内容搜索来源的更新。
#### 1.选择需要替换的 Google 搜索来源地址，进入搜索来源网站（这里我们用 China Daily 的官方网站举例，之后将通过 Google 的搜索引擎在 China Daily 的网站上搜索关键词相关的新闻内容），复制网站上方的 URL 地址。
#### 2. 进入Google 自定义搜索的设置网站：[https://cse.google.com/](https://cse.google.com/cse/all)，点击“新增搜索引擎“进入创建页面。
#### 3. 将 China Daily 官网的 URL 地址填充在“要搜索的网站“地址栏中。
#### 4. 点击页面下方的“创建“按钮（语言可以自定义选择），那么我们需要创建的 搜索引擎ID就创建完成了，那么“ID“ 在哪里呢？下面我们来告诉大家如何提取👇
#### 5. 点击创建按钮后就进入了创建自定义搜索引擎页面，点击页面中“获取代码“按钮，生成搜索引擎ID 的代码。
### 现在，让我们来提取搜索引擎 ID。提取 ID 有两种方法，我们来看下:
**第一种方法：**点击“获取代码“按钮后进入获取代码页面，您会看到有一大窜的代码显示，但这些代码并非全都是搜索引擎 ID,我们只需选取 " **var cx ="** 字段后面的代码字段，这就是搜索引擎 ID。
**第二种方法：**点击代码页面左侧的“设置“按钮，进入基本设置页面，知道页面中的搜索引擎ID按钮，点击后会显示弹窗提示，这里就是"搜索引擎ID" （与刚才获取代码页中的“搜索引擎ID “一致）。
### 现在，提取新创建的 China Daily 的搜索引擎ID,就可以回到我们的 Bot 后台的 Google 搜索插件中去做替换了。
完成"搜索引擎ID"替换后，记得要点击保存按钮，这样通过 Google 搜索引擎 在 China Daily 的网站中进行新闻搜素的功能就生效了！
#### 完成了Google 搜素插件中的设置后，您可以根据推送的新闻消息订阅多个关键词，接下来，我们就为您介绍您如何创建订阅管理插件。