cid 或 place_id 时为必填字段keyword 字段中最多可指定 700 个字符；keyword 中使用 “%” 字符，请将其指定为 “%25”；有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅这篇 帮助中心文章"
},
"cid": {
"type": "string",
"description": "商家实体的唯一 Google 定义 ID
未指定 keyword 或 place_id 时为必填字段
示例：194604053573767737
可在这篇帮助中心文章中进一步了解此标识符"
},
"place_id": {
"type": "string",
"description": "商家实体在 Google Maps 中的标识符
未指定 keyword 或 cid 时为必填字段
示例：GhIJQWDl0CIeQUARxks3icF8U8A
可在这篇帮助中心文章中进一步了解此标识符"
},
"priority": {
"type": [
"integer",
"null"
],
"description": "任务优先级
可选字段
可取以下值：
1 – 正常执行优先级（默认设置）
2 – 高执行优先级。高执行优先级的任务将额外收费。
费用可在 价格页 计算。"
},
"location_name": {
"type": "string",
"description": "搜索引擎地点全名
未指定 location_code 或 location_coordinate 时为必填字段
如果使用此字段，则无需指定 location_code 或 location_coordinate
可单独向 https://api.dataforseo.com/v3/business_data/google/locations 发起请求，获取带 location_name 的可用地点列表
示例：London,England,United Kingdom"
},
"location_code": {
"type": "integer",
"description": "搜索引擎地点代码
未指定 location_name 或 location_coordinate 时为必填字段
如果使用此字段，则无需指定 location_name 或 location_coordinate
可单独向 https://api.dataforseo.com/v3/business_data/google/locations 发起请求，获取带 location_code 的可用地点列表
示例：2840"
},
"location_coordinate": {
"type": "string",
"description": "地点的 GPS 坐标
未指定 location_name 或 location_code 时为必填字段
如果使用此字段，则无需指定 location_name 或 location_codelocation_coordinate 参数应采用 \"latitude,longitude,radius\" 格式
\"latitude\" 和 \"longitude\" 的最大小数位数：7
\"radius\" 的最小值：199.9
示例：53.476225,-2.243572,200"
},
"language_name": {
"type": "string",
"description": "搜索引擎语言的完整名称
如果未指定 language_code，则为必填字段
如果使用此字段，则无需指定 language_code
可单独向 https://api.dataforseo.com/v3/business_data/google/languages 发起请求，获取带 language_name 的可用语言列表
示例：English"
},
"language_code": {
"type": "string",
"description": "搜索引擎语言代码
未指定 language_name 时为必填字段
如果使用此字段，则无需指定 language_name
可单独向 https://api.dataforseo.com/v3/business_data/google/languages 发起请求，获取可用语言及其 language_code 列表
示例：en"
},
"depth": {
"type": [
"integer",
"null"
],
"description": "解析深度
可选字段
SERP 中的评论数量
强烈建议将解析深度设为 10 的倍数，因为我们的系统每次连续处理 10 条评论
默认值：10
最大值：4490
你的账户将按每个最多包含 10 条结果的 SERP 计费；
如果搜索引擎返回超过 10 条结果，将解析深度设为高于 10 可能产生额外费用；
费用可在 价格页 计算。"
},
"sort_by": {
"type": [
"string",
"null"
],
"description": "结果排序参数
可选字段
可使用此字段对结果排序
可能的排序类型：newest – 按最新优先排序highest_rating – 按最高评分排序lowest_rating – 按最低评分排序relevant – 按相关性排序
默认值：relevant"
},
"tag": {
"type": [
"string",
"null"
],
"description": "用户自定义任务标识符
可选字段
字符数上限为 255
可使用此参数标识任务，并将其与结果对应
可在响应的 data 对象中找到指定的 tag 值"
},
"postback_url": {
"type": [
"string",
"null"
],
"description": "用于发送任务结果的 URL
可选字段
任务完成后，我们会将结果以 gzip 格式压缩，并通过 POST 请求发送到你指定的 postback_url
可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。
示例：http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
注意：postback_url 中的特殊字符会进行 URL 编码；
例如，# 字符会被编码为 %23
详情请参阅我们的帮助中心"
},
"pingback_url": {
"type": [
"string",
"null"
],
"description": "任务完成通知 URL
可选字段
任务完成后，我们会向你指定的 URL 发送 GET 请求进行通知
可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。
示例：http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
注意：pingback_url 中的特殊字符会进行 URL 编码；
例如，# 字符会被编码为 %23
详情请参阅我们的帮助中心"
}
},
"example": [
{
"location_name": "London,England,United Kingdom",
"language_name": "English",
"keyword": "hedonism wines",
"depth": 50,
"sort_by": "highest_rating"
}
]
}
]
},
"example": [
{
"location_name": "London,England,United Kingdom",
"language_name": "English",
"keyword": "hedonism wines",
"depth": 50,
"sort_by": "highest_rating"
}
]
}
```
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostResponseInfo"
}
]
}
```
### 400 — 无法处理该请求。请检查请求参数。
### 401 — 需要有效的 Felo API 密钥。
### 402 — 由于未满足计费要求，请求无法继续。
### 403 — 该账户无权执行此操作。
### 429 — 已达到请求或支出限额。
### 502 — 服务无法完成该请求。
### 503 — API 或计费服务暂时不可用。
### 504 — 服务在处理请求时超时。
### default — 错误响应；上游透传响应可能采用提供方格式
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API 的当前版本"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "通用状态码\n完整响应码列表见此处"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "通用信息性消息\n完整的一般信息性消息列表见此处"
},
"time": {
"type": [
"string",
"null"
],
"description": "总执行时间，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任务总费用，美元",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "tasks 数组中的任务数",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "tasks 数组中返回错误的任务数",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "任务标识符\n我们系统中 UUID 格式的唯一任务标识符"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "任务的状态码\n由 DataForSEO 生成，范围如下：10000-60000\n完整响应码列表见此处"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "任务的信息性消息\n完整的一般信息性消息列表见此处"
},
"time": {
"type": [
"string",
"null"
],
"description": "执行时间，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任务总费用，美元",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "result 数组中的元素数",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "URL 路径"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "包含你在 POST 请求中指定的相同参数"
}
}
}
```
### Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostResponseInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostTaskInfo"
}
]
},
"description": "任务数组"
}
}
}
]
}
```
### Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostTaskInfo
`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleReviewsTaskPostTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"object",
"null"
],
"description": "结果数组
在本例中，该值将为 null"
}
}
}
]
}
```