Google Merchant 支持语言列表

GET /v3/merchant/google/languages

接口说明

通过调用以下接口，可以获取 Google Shopping Merchant API 支持的语言列表。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/merchant/google/languages
• 计费：****
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

该接口返回 JSON 格式数据，顶层 tasks 数组，每个任务中本次请求的执行信息与结果数据。

请求地址

GET /v3/merchant/google/languages

返回字段说明

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	接口整体状态码
status_message	string	接口整体状态说明
time	string	执行耗时，单位：秒
cost	float	本次请求总费用，单位：USD；本接口通常为 0
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务数组

状态码与通用消息可参考：/v3/appendix/errors

tasks[] 字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000
status_message	string	任务状态说明
time	string	任务执行耗时，单位：秒
cost	float	当前任务费用，单位：USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	GET 请求 URL 中传递的参数信息
result	array	结果数组

result[] 字段

字段名	类型	说明
language_name	string	语言名称
language_code	string	语言代码，遵循 ISO 639-1 标准

请求示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/merchant/google/languages" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

url = "https://api.seermartech.cn/v3/merchant/google/languages"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json)

TypeScript

import axios from "axios";

axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/merchant/google/languages",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
}).then((response) => {
 // 输出返回结果
 console.log(response.data);
}).catch((error) => {
 console.error(error);
});

响应示例

{
 "version": "3.20191128",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1773 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0000 sec.",
 "cost": 0,
 "result_count": 1,
 "path": [
 "v3",
 "merchant",
 "google",
 "languages"
 ],
 "data": {
 "api": "merchant",
 "function": "languages",
 "se": "google"
 },
 "result": [
 {
 "language_name": "English",
 "language_code": "en"
 }
 ]
 }
 ]
}

响应说明

成功时，result 中会返回 Google Shopping Merchant 支持的语言列表。每条语言数据至少：

• language_name：语言名称
• language_code：语言代码，例如 en、fr、de

这些语言代码可用于后续商品数据采集、投放或多语言数据处理逻辑。

错误处理

• 顶层 status_code 表示整次请求的处理状态
• tasks[].status_code 表示任务的处理状态
• 当 tasks_error 大于 0 时，表示部分或任务执行失败
• 详细错误码与说明可参考：/v3/appendix/errors

使用建议

• 在调用依赖语言参数的 Merchant 接口前，调用本接口获取可用语言列表
• 建议将返回结果缓存在本地中，重复请求
• 构建多语言商品分析流程时，可将 language_code 作为标准参来源，降低参数错误率

实用场景

• 获取可用语言单：在创建 Merchant 数据采集任务前拉取支持语言，传无效语言代码导致任务失败
• 校验用户：在商品投放后台或 SEO 工中校验语言参数，减少错误并提升任务提交成功率
• 构建多语言商品分析：基于返回的语言代码批量发起不同语种的数据请求，支持跨市场商品可见性分析
• 同步平台项：将支持语言列表同步到下拉菜单或表单中，提升运营效率
• 维护标准化参数体系：将 ISO 639-1 语言代码作为统一标准，便于与商品库、广告系统和报表系统联动