跳转到主要内容
GET
Get location details

请求规范

  • 方法与路径: GET /apis/v1/social/accounts/{accountId}/gmb-location-details
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/accounts/{accountId}/gmb-location-details
  • accountId: path; 必填
  • locationId: query; 可选
  • readMask: query; 可选
  • Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

当前未提供请求参考价格;请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

accountId
string
必填

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$

查询参数

locationId
string

Override which location to query. If omitted, uses the account's selected location. Use GET /gmb-locations to list valid IDs.

readMask
string

Comma-separated fields to return. Available: name, title, phoneNumbers, categories, storefrontAddress, websiteUri, regularHours, specialHours, serviceArea, serviceItems, profile, openInfo, metadata, moreHours.

title and metadata are always included in the response so the location summary block can be populated, even if you omit them here.

location is a derived response field, not a Google readMask value: passing it returns 400.

响应

Location details fetched successfully

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
categories
object

Business categories (returned when readMask includes 'categories')

location
object | null

Compact public-facing summary derived from Google's metadata. Useful for surfacing the "leave a review" URL (e.g. behind a QR code) without parsing the raw block. Always populated regardless of readMask. For unverified or new locations Google omits placeId/reviewUrl/mapsUri, so those return as null and isVerified is false.

locationId
string
phoneNumbers
object
profile
object
regularHours
object
serviceItems
object[]

Services offered (returned when readMask includes 'serviceItems')

specialHours
object
success
boolean
title
string

Business name

websiteUri
string