Google 商家资料 Google 商家资料 · 64 个端点
列出你的商家资料账户 列出你管理的 Google Business Profile 账户 google-business-profile.accounts 按账户 ID 查询商家资料账户详情 accounts.get — 获取指定账户。账户不存在或调用方无访问权限时返回 `NOT_FOUND`。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-get 列出商家条目上的地点操作链接 placeActionLinks.list — 列出指定位置的地点操作链接。 google-business-profile.x.placeactions-mybusinessplaceactions-locations-placeactionlinks-list 商家条目上设置的属性 locations.getAttributes — 获取商家最后自行设置的某个位置属性。它可能不包含 Google 或用户生成内容在 Google 地图上的实时更新。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-locations-getattributes 按类别和国家查询可用的条目属性 attributes.list — 返回在给定主要类别和国家下，某个位置可用的属性列表。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-attributes-list 按 GConcept ID 查询商家资料类别 categories.batchGet — 按指定语言和 GConcept ID 返回商家类别列表。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-categories-batchget 按名称搜索商家资料类别 categories.list — 返回商家类别列表。搜索匹配类别名称，不匹配类别 ID。搜索只匹配类别名称的开头（例如 'food' 可能返回 'Food Court'，但不会返回 'Fast Food Restaurant'）。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-categories-list 按连锁 ID 查询连锁商家详情 chains.get — 获取指定的连锁。连锁不存在时返回 `NOT_FOUND`。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-chains-get 按名称搜索连锁商家 chains.search — 根据连锁名称搜索连锁。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-chains-search 商家条目的每日指标时间序列 locations.fetchMultiDailyMetricsTimeSeries — 返回给定时间范围内每个日期上特定每日指标对应的数值。注：仅提供按日数据，不支持按小时指标。请求示例：`GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICK` google-business-profile.x.businessprofileperformance-businessprofileperformance-locations-fetchmultidailymetricstimeseries 商家条目单项指标的每日时间序列 locations.getDailyMetricsTimeSeries — 返回给定时间范围内每个日期上特定每日指标对应的数值。注：仅提供按日数据，不支持按小时指标。请求示例：`GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022` google-business-profile.x.businessprofileperformance-businessprofileperformance-locations-getdailymetricstimeseries 商家条目的月度搜索关键词与展示次数 monthly.list — 返回在搜索或地图上找到该商家时使用的搜索关键词。每个搜索关键词都附带按月汇总的展示次数。请求示例：`GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1` google-business-profile.x.businessprofileperformance-businessprofileperformance-locations-searchkeywords-impressions-monthly-list 列出你的商家条目 — 地址、营业时间、类别 列出你商家的各条商家信息，含地址、营业时间与类别 google-business-profile.locations 商家最后自行设置的条目信息 locations.get — 返回商家最后自行设置的指定位置信息。它可能不包含 Google 或用户生成内容在 Google 地图上的实时更新。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-locations-get 商家条目在 Google 上的实时显示信息 locations.getGoogleUpdated — 返回指定位置在 Google 地图和搜索上实时显示的信息。这一面向消费者的视图可能已被 Google 或用户生成内容更新，与商家的版本不一致。返回的 GoogleUpdatedLocation 包含掩码，标明哪些字段与商家信息不同。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-locations-getgoogleupdated 将你的商家与 Google 位置记录匹配 googleLocations.search — 搜索与指定请求匹配的所有可能位置。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-googlelocations-search 列出商家条目上的照片和视频 media.list — 列出你某个商家条目上的照片和视频 google-business-profile.x.v4-media-list 向商家条目添加照片或视频 media.create — 向你的某个商家条目添加照片或视频 google-business-profile.x.v4-media-create 列出商家条目上的本地动态 localPosts.list — 列出你某个商家条目上的本地动态（优惠、更新、活动） google-business-profile.x.v4-localposts-list 在商家条目上发布本地动态 localPosts.create — 向你的某个商家条目发布本地动态（优惠、更新或活动） google-business-profile.x.v4-localposts-create 列出商家条目上的客户问题 questions.list — 返回指定位置的分页问题列表及其部分回答。仅当指定位置已完成验证时，该操作才有效。 google-business-profile.x.qanda-mybusinessqanda-locations-questions-list 发布或更新你对条目问题的回答 answers.upsert — 为指定问题创建回答，或更新该用户已有的回答。每个用户对每个问题只能创建一条回答。 google-business-profile.x.qanda-mybusinessqanda-locations-questions-answers-upsert 以商家身份回复客户评价 以商家身份公开回复客户的评价 google-business-profile.review.reply 列出商家条目上的客户评价 读取客户在 Google Business Profile 条目上留下的评价 google-business-profile.reviews 一次读取多个商家条目的客户评价 reviews.batchGetReviews — 一次调用读取你多个商家条目上的评价 google-business-profile.x.v4-reviews-batchget 按评价 ID 读取一条客户评价 reviews.get — 读取你某个商家条目上的一条评价 google-business-profile.x.v4-reviews-get 商家条目的商家之声状态 locations.getVoiceOfMerchantState — 获取 VoiceOfMerchant 状态。 google-business-profile.x.verifications-mybusinessverifications-locations-getvoiceofmerchantstate 账号与工具类端点 接受商家资料管理员邀请 invitations.accept — 接受指定邀请。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-invitations-accept 修改管理员在商家资料账户中的角色 admins.patch — 更新指定账户管理员对应的 Admin。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-admins-patch 修改管理员在商家条目中的角色 admins.patch — 更新指定位置对应的 Admin。只能更新 Admin 的 AdminRole。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-locations-admins-patch 完成待处理的商家条目验证 verifications.complete — 完成一个 `PENDING` 状态的验证。只有非 `AUTO` 的验证方式才需要此操作。`AUTO` 验证请求在创建时即变为 `VERIFIED`。 google-business-profile.x.verifications-mybusinessverifications-locations-verifications-complete 创建商家资料账户 accounts.create — 在指定父级下按给定名称和类型创建账户。 - 无法创建个人账户和组织账户。 - 无法以个人账户为主所有人创建用户组。 - 若个人账户属于某个组织，则无法以该个人账户为主所有人创建位置组。 - 位置组不能拥有位置组。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-create 在商家资料中创建商家条目 locations.create — 创建一个归当前登录用户所有的新 Location。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-accounts-locations-create 在商家条目上创建地点操作链接 placeActionLinks.create — 创建与指定位置关联的地点操作链接并返回。如果 `parent`、`place_action_link.uri` 与 `place_action_link.place_action_type` 与之前的请求相同，则视为重复请求。 google-business-profile.x.placeactions-mybusinessplaceactions-locations-placeactionlinks-create 拒绝商家资料管理员邀请 invitations.decline — 拒绝指定邀请。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-invitations-decline 从商家资料中删除条目 locations.delete — 删除某个位置。如果该位置无法通过 API 删除，并且在 `google.mybusiness.businessinformation.v1.LocationState` 中标记为如此，请使用 [Google Business Profile](https://business.google.com/manage/) 网站。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-locations-delete 从商家条目删除地点操作链接 placeActionLinks.delete — 从指定位置删除一条地点操作链接。 google-business-profile.x.placeactions-mybusinessplaceactions-locations-placeactionlinks-delete 删除你对商家条目问题的回答 answers.delete — 删除当前用户对某个问题写下的回答。 google-business-profile.x.qanda-mybusinessqanda-locations-questions-answers-delete 删除你对客户评价的公开回复 reviews.deleteReply — 删除商家对某条评价的公开回复 google-business-profile.x.v4-reviews-deletereply 删除你在商家条目上的问题 questions.delete — 删除当前用户写下的某个问题。 google-business-profile.x.qanda-mybusinessqanda-locations-questions-delete 编辑你在商家条目上的问题 questions.patch — 更新当前用户写下的某个问题。 google-business-profile.x.qanda-mybusinessqanda-locations-questions-patch 商家条目可用的验证方式 locations.fetchVerificationOptions — 报告某个位置在指定语言下所有可用的验证方式。 google-business-profile.x.verifications-mybusinessverifications-locations-fetchverificationoptions 为商家条目生成验证令牌 verificationTokens.generate — 为给定的位置数据生成用于验证该位置的令牌。 google-business-profile.x.verifications-mybusinessverifications-verificationtokens-generate 商家条目在 Google 上更新的属性 attributes.getGoogleUpdated — 获取某个位置在 Google 地图和搜索上实时显示的属性。这一面向消费者的视图可能已被 Google 或用户生成内容更新，与商家自己设置的版本不一致。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-locations-attributes-getgoogleupdated 邀请管理员加入你的商家资料账户 admins.create — 邀请指定用户成为指定账户的管理员。被邀请者必须接受邀请才能获得该账户的访问权限。如需以编程方式接受邀请，请参见 AcceptInvitation。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-admins-create 邀请管理员加入你的商家条目 admins.create — 邀请指定用户成为指定位置的管理员。被邀请者必须接受邀请才能获得该位置的访问权限。如需以编程方式接受邀请，请参见 AcceptInvitation。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-locations-admins-create 列出商家资料账户的管理员 admins.list — 列出指定账户的管理员。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-admins-list 列出商家条目的管理员 admins.list — 列出指定位置的全部管理员。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-locations-admins-list 列出商家条目问题的回答 answers.list — 返回指定问题的分页回答列表。 google-business-profile.x.qanda-mybusinessqanda-locations-questions-answers-list 列出可用的地点操作类型 placeActionTypeMetadata.list — 返回某个位置或国家可用的地点操作类型列表。 google-business-profile.x.placeactions-mybusinessplaceactions-placeactiontypemetadata-list 列出商家资料的待处理邀请 invitations.list — 列出指定账户的待处理邀请。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-invitations-list 列出商家条目的验证尝试 verifications.list — 按创建时间列出某个位置的验证记录。 google-business-profile.x.verifications-mybusinessverifications-locations-verifications-list 按链接 ID 查询地点操作链接详情 placeActionLinks.get — 获取指定的地点操作链接。 google-business-profile.x.placeactions-mybusinessplaceactions-locations-placeactionlinks-get 在商家条目上发布问题 questions.create — 为指定位置添加一个问题。 google-business-profile.x.qanda-mybusinessqanda-locations-questions-create 从商家资料账户移除管理员 admins.delete — 从指定账户移除指定管理员。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-admins-delete 从商家条目移除管理员 admins.delete — 撤销指定管理员对指定位置的管理权限。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-locations-admins-delete 开始验证商家条目 locations.verify — 为某个位置启动验证流程。 google-business-profile.x.verifications-mybusinessverifications-locations-verify 将商家条目转移到另一个账户 locations.transfer — 将某个位置从用户拥有的账户转移到同一用户管理的另一个账户。用户必须是该位置当前所属账户的所有者，同时至少是目标账户的管理员。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-locations-transfer 更新商家资料账户 accounts.patch — 更新指定的商家账户。个人账户不能用此方法更新。 google-business-profile.x.accountmanagement-mybusinessaccountmanagement-accounts-patch 更新商家条目上的地点操作链接 placeActionLinks.patch — 更新指定的地点操作链接并返回。 google-business-profile.x.placeactions-mybusinessplaceactions-locations-placeactionlinks-patch 更新商家条目上的属性 locations.updateAttributes — 更新指定位置的属性。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-locations-updateattributes 更新商家资料的 Pub/Sub 通知 accounts.updateNotificationSetting — 设置该账户的 Pub/Sub 通知，告知 Google 向哪个主题发送 Pub/Sub 通知。用 notification_setting 中的 notification_types 字段控制账户想订阅的事件。每个账户只有一个通知设置资源，且只能设置一个 Pub/Sub 主题。要删除该设置，请将其更新为停用状态。 google-business-profile.x.notifications-mybusinessnotifications-accounts-updatenotificationsetting 更新商家条目详情 locations.patch — 更新指定的位置。 google-business-profile.x.businessinformation-mybusinessbusinessinformation-locations-patch 商家资料的 Pub/Sub 通知设置 accounts.getNotificationSetting — 返回该账户的 Pub/Sub 通知设置。 google-business-profile.x.notifications-mybusinessnotifications-accounts-getnotificationsetting 这些端点可以调用，但不在目录的浏览面上。