设置实时 Google My Business Info 任务
Business Data API 提供包含 Google 上特定商业实体信息的结果。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
keyword 必填字段 你指定的关键词应表示本地商家的名称,最多可指定 700 个字符。在 keyword 字段中,所有 %## 都会被解码(加号字符“+”会被解码为空格字符)。如果需要在 keyword 中使用“%”字符,请将其指定为“%25”;此字段还可用于传递以下参数:cid——由 Google 定义的唯一商家实体 ID;place_id——Google Maps 中商家实体的标识符;spp——Google SERP 的 local_pack 元素中所展示本地服务的唯一标识符。示例:cid:194604053573767737 place_id:GhIJQWDl0CIeQUARxks3icF8U8A spp:CgsvZy8xdGN4cWRraBoUChIJPZDrEzLsZIgRoNrpodC5P30。有关 cid 和 place_id 标识符的更多信息,请参阅此帮助中心文章。有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制,请参阅此帮助中心文章
搜索引擎位置的完整名称 如果未指定 location_code 或 location_coordinate,则为必填字段;如果使用此字段,则无需指定 location_code 或 location_coordinate。您可以单独向 https://api.dataforseo.com/v3/business_data/google/locations 发出请求,以获取带有 location_name 的可用位置列表。示例:London,England,United Kingdom
搜索引擎位置代码 如果未指定 location_name 或 location_coordinate,则为必填字段;如果使用此字段,则无需指定 location_name 或 location_coordinate。您可以通过向 https://api.dataforseo.com/v3/business_data/google/locations 单独发送请求,获取包含 location_code 的可用位置列表。示例:2840
位置的 GPS 坐标 如果未指定 location_name 或 location_code ,则为必填字段 如果使用此字段,则无需指定 location_name 或 location_code location_coordinate 参数应以 “latitude,longitude,radius” 格式指定 “latitude” 和 “longitude” 的最大小数位数:7 “radius” 的最小值:199.9 (mm) “radius” 的最大值:199999 (mm) 示例:53.476225,-2.243572,200
搜索引擎语言的完整名称 未指定 language_code 时为必填字段;如果使用此字段,则无需指定 language_code;您可以通过向 https://api.dataforseo.com/v3/business_data/google/languages 单独发送请求,获取包含 language_name 的可用语言列表;示例:English
搜索引擎语言代码 如果未指定 language_name ,则为必填字段;如果使用此字段,则无需指定 language_name;您可以通过向 https://api.dataforseo.com/v3/business_data/google/languages 单独发送请求,获取可用语言及其 language_code 的列表;示例:en
用户定义的任务标识符,可选字段,字符数上限为 255。你可以使用此参数标识任务并将其与结果匹配;你可以在响应的 data 对象中找到指定的 tag 值
响应
成功响应
API 的当前版本
执行时间(秒)
所有任务的总成本(美元)
tasks 数组中的任务数量
tasks 数组中返回错误的任务数量
任务数组
执行时间(秒)
任务成本(美元)
result 数组中的元素数量
URL 路径
包含与您在 POST 请求中指定的参数相同的参数
结果数组
POST 数组中指定的搜索引擎域名
POST 数组中的位置代码
POST 数组中的语言代码
搜索引擎结果的直接 URL,你可以使用它确认我们提供的结果是否准确
收到结果的日期和时间,采用 UTC 格式:“yyyy-mm-dd hh-mm-ss +00:00”;示例:2019-11-15 12:57:46 +00:00
项目类型 items 数组中出现的搜索引擎结果类型;可能的项目类型:google_business_info
项目类型 items 数组中的项目数量
遇到的项目类型 items 数组中出现的搜索引擎结果类型;可能的项目类型:google_business_info
元素类型 = ‘google_business_info’
在具有相同 type 值的一组元素中的位置 具有不同 type 值的元素的位置不计入 rank_group
在所有元素中的绝对排名
SERP 中的对齐方式
SERP 中元素的标题 收集结果所针对的商业实体名称
元素的原标题 未经 Google 翻译的原标题
SERP 中元素的描述 收集结果所针对的商业实体的描述
商家类别 最能描述该商业实体所提供服务的 Google My Business 常规类别
全局类别 ID 不随所选国家/地区变化的通用类别 ID
其他业务类别 其他 Google My Business 类别,用于更详细地描述该商业实体提供的服务
企业实体的街道地址
包含企业实体地址组成部分的对象
企业实体所在地所属的行政单位或区域
企业实体所在城市的名称
商业实体的邮政编码
商业实体所在地的 DMA 区域
企业实体所在地的 ISO 国家代码
商业实体的电话号码
业务实体的绝对 URL
首选联系页面的 URL
用户或实体的本地向导个人资料 URL(如有)
元素的“在线预订”按钮中的 URL 将用户引导至该商业实体的在线预订或下单页面的 URL
商业实体的域名
Google My Business 资料中展示的徽标 URL
Google My Business 资料中展示的主图片 URL
Google My Business 资料中展示的图片总数
有关企业实体的其他信息
Google 地图中本地商家的纬度坐标 示例:"latitude": 51.584091
Google 地图中本地商家的经度坐标 示例:"longitude": -0.31365919999999997
指示该实体是否已由其所有者在 Google Maps 上验证
以用户审核项形式呈现的服务详情; 以审核项形式显示的商业实体服务详情,基于用户反馈和商家 category
可用属性表示企业实体可提供的属性
不可用属性表示企业实体无法提供的属性
客户评论中提及的关键词 包含企业实体的客户评论中与产品/服务相关的最热门关键词,以及提及每个关键词的评论数量 示例:"place_topics": {"egg roll": 48,"birthday": 33}
元素评分 基于评论得出并显示在 SERP 中的热门程度
评分类型 此处可能包含以下元素:Max5、Percents、CustomMax
评分值
反馈数量
rating_type 的最大值
商业实体的评分分布,该对象显示用户评价的一星至五星评分数量
1 星评分的数量
2 星评分的数量
3 星评分数量
4 星评分的数量
5 星评分数量
相关业务实体
工作时间详情 与企业实体营业时间相关的信息
本地场所工作时间的营业时间信息
工作时间表
周日工作时间
开盘时间
采用 24 小时制的小时数
分钟
关闭时间
星期一的工作时间
周二的工作时间
周三的工作时间
周四的工作时间
周五的工作时间
星期六的工作时间
场所的当前状态 可能的值:opened、closed、temporarily_closed、closed_forever
与企业实体繁忙时段相关的热门时段信息
热门时段:本地商家在一周中每天繁忙时段的信息
星期日的繁忙时段 可采用对应星期日期的值
繁忙时段
24 小时制的小时数
分钟
热门程度指数 在 0 到 100 范围内衡量的相对时段热门程度指数;值越高表示一天中的该时段越繁忙
可与商家进行的交互 可直接从搜索结果中与商家进行交互的选项列表
元素类型 = ‘menu’
元素标题 在线菜单系统的域名
查看菜单的 URL
列出可用的配送服务
商家是否属于目录的一部分 表示该商家是否属于目录的一部分;如果为 true,则该项目属于由地址相同的商家组成的更大目录(例如商场或商务中心);注意:如果该商家是目录中的父项目,则值为 null
目录中的项目包含位于目标商业场所内且地址相同的商家信息
SERP 中元素的标题,即商业实体的名称
目录项数组
元素类型 = ‘maps_search’
在具有相同 type 值的一组元素中的位置 具有不同 type 值的元素的位置不计入 rank_group
在所有元素中的绝对排名
商业实体的域名
业务实体的绝对 URL
元素评分 基于评论得出并显示在 SERP 中的热门程度
评分类型 此处可能包含以下元素:Max5、Percents、CustomMax
评分值
反馈数量
rating_type 的最大值
商业实体的评分分布,该对象显示用户评价的一星至五星评分数量
1 星评分的数量
2 星评分的数量
3 星评分数量
4 星评分的数量
5 星评分数量
有关该企业实体的其他信息
企业实体的街道地址
包含企业实体地址组成部分的对象
企业实体所在地所属的行政单位或区域
企业实体所在城市的名称
商业实体的邮政编码
商业实体所在地的 DMA 区域
企业实体所在地的 ISO 国家代码
商业实体的电话号码
Google My Business 资料中展示的主图片 URL
Google My Business 资料中展示的图片总数
商家类别 最能描述该商业实体所提供服务的 Google My Business 常规类别
全局类别 ID 不随所选国家/地区变化的通用类别 ID
工作时间 本地商家的工作时间信息
Google 定义的客户端 ID 本地商家的唯一 ID;可与 Google Reviews API 配合使用,以获取完整的评论列表。有关此标识符的更多信息,请参阅此帮助中心文章
Google 地图中本地商家的纬度坐标 示例:"latitude": 51.584091
Google 地图中本地商家的经度坐标 示例:"longitude": -0.31365919999999997
指示该实体是否已由其所有者在 Google Maps 上验证
Google 本地结果依据 用于“说明”该商家为何会出现在搜索查询结果中的文本片段
商家是否属于目录的一部分 表示该商家是否属于目录的一部分;如果为 true,则该项目属于由地址相同的商家组成的更大目录(例如商场或商务中心);注意:如果该商家是目录中的父项目,则值为 null
property price level 可取以下值:inexpensive、moderate、expensive、very_expensive;如果没有价格等级信息,则该值为 null