DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
设置 Google Shopping 评价任务
排队获取一个 Google Shopping 商品的评价,返回任务 id。使用 product_id 以及商品结果中的 gid 或 data_docid 标识商品。本系列全程异步:提交后在 tasks[0].id 中返回任务 id,获取工具会在结果就绪后返回。使用 get_dataforseo_merchant_google_reviews_fetch 获取结果。
计费参考
- 计量方式:按上报的响应成本计量。
- 参考请求估算:0.012 美元。
- 参考客户倍率:1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据,不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: array object[]
- 类型: object
- gid类型: string必填
Google Shopping 上的全局商品标识符 必填字段 为获得最佳结果,建议将 gid 与 data_docid 和 product_id 一起指定; 可单独向 Google Shopping Products 端点发起请求,获取某个商品的此值 示例:4702526954592161872 有关此参数的更多信息,请参阅这篇帮助中心指南
- data类型: string
_docid SERP 数据元素的唯一标识符 可选字段 为获得最佳结果,建议将 data_docid 与 product_id 和 gid 一起指定; 可单独向 Google Shopping Products 端点发起请求,获取某个元素的此值 示例:13071766526042404278
- depth类型: integer
解析深度 可选字段 SERP 中的评论数量;我们强烈建议将解析深度设置为 10 的倍数,因为系统会连续处理 10 条评论;最大值:8000 默认值:10 你的账户将按每个最多包含 10 条结果的 SERP 计费; 如果将深度设置为 10 以上,且搜索引擎返回超过 10 条结果,可能会产生额外费用; 费用可在价格页计算。
- language类型: string
_code 搜索引擎语言代码 未指定 language_name 时为必填字段 如果使用此字段,则无需指定 language_name 可单独向 https://api.dataforseo.com/v3/merchant/google/languages 发起请求,获取可用的语言及其 language_code 参数 示例:en_GB
- language类型: string
_name 搜索引擎语言全名 未指定 language_code 时为必填字段 如果使用此字段,则无需指定 language_code 可单独向 https://api.dataforseo.com/v3/merchant/google/languages 发起请求,获取可用的语言及其 language_name 参数 示例:English (United Kingdom)
- location类型: integer
_code 搜索引擎地点代码 未指定 location_name 或 location_coordinate 时为必填字段 如果使用此字段,则无需指定 location_name 或 location_coordinate 可单独向 https://api.dataforseo.com/v3/merchant/google/locations 发起请求,获取可用地点及其 location_code 参数 示例:9045969
- location类型: string
_coordinate 地点的 GPS 坐标 未指定 location_name 或 location_code 时为必填字段 如果使用此字段,则无需指定 location_name 或 location_code location_coordinate 参数应采用 “latitude,longitude,radius” 格式 “latitude” 和 “longitude” 的最大小数位数:7 “radius” 的最小值:199.9 示例:53.476225,-2.243572,200
- location类型: string
_name 搜索引擎地点全名 未指定 location_code 或 location_coordinate 时为必填字段 如果使用此字段,则无需指定 location_code 或 location_coordinate 可单独向 https://api.dataforseo.com/v3/merchant/google/locations 发起请求,获取可用地点及其 location_name 参数 示例:HA1,England,United Kingdom
- pingback类型: string
_url 已完成任务的通知 URL。可选字段。任务完成后,我们会通过向你指定的 URL 发送 GET 请求来通知你。你可以将 ‘$id’ 字符串用作 $id 变量,将 ‘$tag’ 用作 URL 编码的 $tag 变量。发送请求前,我们会设置必要的值。示例:http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag 注意:pingback_url 中的特殊字符会被 URL 编码;例如 # 字符会被编码为 %23。更多信息请参阅我们的帮助中心。
- postback类型: string
_data postback_url 数据类型。可选字段。对应将发送到你服务器的数据类型。可选值:advanced。
- postback类型: string
_url 用于发送任务结果的 URL。可选字段。任务完成后,我们会向你指定的 postback_url 发送 POST 请求,其结果以 gzip 格式压缩。你可以将 ‘$id’ 字符串用作 $id 变量,将 ‘$tag’ 用作 URL 编码的 $tag 变量。发送请求前,我们会设置必要的值。示例:http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag 注意:postback_url 中的特殊字符会被 URL 编码;例如 # 字符会被编码为 %23。更多信息请参阅我们的帮助中心。
- priority类型: integer
任务优先级。可选字段。可取值如下:1 – 正常执行优先级(默认设置);2 – 高执行优先级。高执行优先级的任务将额外收费。费用可在价格页计算。
- product类型: string
_id Google Shopping 上的唯一商品标识符。可选字段。建议将 product_id 与 data_docid 和 gid 一起指定,以获得最佳结果;你可以单独请求 Google Shopping Products 端点,获取某个商品的该值。示例:4485466949985702538 有关此参数的更多信息,请参阅此帮助中心指南。
- se类型: string
_domain 搜索引擎域名。可选字段。我们会根据你指定的地点和语言自动选择相关的搜索引擎域名;不过,你也可以在此字段中设置自定义的搜索引擎域名。示例:google.co.uk、google.com.au、google.de 等。
- tag类型: string
用户自定义任务标识符 可选字段 字符数上限为 255 可使用此参数标识任务,并将其与结果对应 可在响应的 data 对象中找到指定的 tag 值
空对象空对象
- 类型: object200
成功响应
- 类型: numbercost
任务总费用,美元
- 类型: integerstatus
_code 通用状态码 完整响应码列表见此处 注意:我们强烈建议设计必要的系统来处理相关的异常或错误情况
- 类型: stringstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array string[]tasks
任务数组
- 类型: integertasks
_count tasks 数组中的任务数量
- 类型: integertasks
_error tasks 数组中返回错误的任务数
- 类型: numbertasks
.cost 任务费用,美元
- 类型: objecttasks
.data 包含你在 POST 请求中指定的相同参数
- 类型: stringtasks
.id 我们系统中任务的唯一标识符,采用通用唯一标识符(UUID)格式
- 类型: array string[]tasks
.path URL 路径
- 类型: array string[]tasks
.result 结果数组 此处该值将为 null
- 类型: integertasks
.result _count result 数组中的元素数
- 类型: integertasks
.status _code 由 DataForSEO 生成的任务状态码;取值范围为 10000-60000
- 类型: stringtasks
.status _message 任务的信息性消息
- 类型: stringtasks
.time 执行时间,秒
- 类型: stringtime
执行时间,秒
- 类型: stringversion
API 的当前版本
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求,请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应;上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{},
{}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks.id": "string",
"tasks.status_code": 1,
"tasks.status_message": "string",
"tasks.time": "string",
"tasks.cost": 1,
"tasks.result_count": 1,
"tasks.path": [
"string"
],
"tasks.data": {},
"tasks.result": [
"string"
]
}