获取搜索可见性观测任务

获取搜索可见性观测任务。新购额度包按全部关键词与来源组合相加：Google/Bing 的 Top10/20/50 各消耗 1/2/5 额度，Baidu 各消耗 10/20/50；Google 高级操作符乘以 5。年付含120,000 credits，月付含10,000 credits；读取免费。旧调用包创建报告或任务各计1次。

当前接口契约

接口详情：https://www.gugudata.com/api/details/search-visibility

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	咕咕数据开发者中心分配的 APPKEY。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
runId	string	是	无	观测任务 ID。

正常响应

HTTP 200，application/json。

字段	类型	说明
name	string
runId	string
reportId	string
state	string
forceRefresh	boolean
creditCost	integer	处理中为预占额度，终态为成功组合实际额度。新购额度包及订阅按此结算，失败组合释放；旧调用包按原创建次数计费。
tasksTotal	integer
tasksSucceeded	integer
tasksFailed	integer
metrics	见响应定义
errorSummary	object[]
createdAt	string
updatedAt	string
completedAt	string / null

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

搜索观测资源。

Bodyapplication/json

示例

{
    "name": "string",
    "runId": "string",
    "reportId": "string",
    "state": "PENDING",
    "forceRefresh": true,
    "creditCost": 0,
    "tasksTotal": 0,
    "tasksSucceeded": 0,
    "tasksFailed": 0,
    "metrics": {},
    "errorSummary": [
        {
            "message": "string",
            "taskKey": "string",
            "query": "string",
            "source": "string",
            "occurredAt": "2019-08-24T14:15:22.123Z"
        }
    ],
    "createdAt": "2019-08-24T14:15:22.123Z",
    "updatedAt": "2019-08-24T14:15:22.123Z",
    "completedAt": "2019-08-24T14:15:22.123Z"
}

🟠400INVALID_ARGUMENT

🟠401UNAUTHENTICATED

🟠403PERMISSION_DENIED

🟠404NOT_FOUND

🟠429RESOURCE_EXHAUSTED

🔴500INTERNAL

🔴503UNAVAILABLE

当前接口契约#

请求参数#

正常响应#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应