商店资料
方法适用于模式:FBY, FBS, Express 和 DBS.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
- inventory-and-order-processing — 订单处理和商品核算
- inventory-and-order-processing:read-only — 查看订单信息
- pricing — 价格管理
- pricing:read-only — 查看价格
- offers-and-cards-management — 商品和卡片管理
- offers-and-cards-management:read-only — 查看商品和卡片
- promotion — 商品推广
- promotion:read-only — 查看商品推广信息
- finance-and-accounting — 查看财务信息和报告
- communication — 与买家沟通
- settings-management — 店铺设置
- supplies-management:read-only — 获取有关FBY应用程序的信息
- all-methods — 全面管理账户
- all-methods:read-only — 查看所有数据
返回有关商店的信息。
| ⚙️ 限制: 每小时1,000个请求 |
|---|
Request
GET
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}
Path parameters
|
Name |
Description |
|
campaignId* |
Type: integer<int64> 活动ID。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要发送商店ID,这是在市场上的卖家帐户旁边的商店名称和一些报告。
Min value: |
Responses
200 OK
有关商店的信息。
Body
application/json
{
"campaign": {
"domain": "string",
"id": 0,
"clientId": 0,
"business": {
"id": 0,
"name": "string"
},
"placementType": "FBS",
"apiAvailability": "AVAILABLE"
}
}
|
Name |
Description |
|
campaign |
Type: CampaignDTO 有关商店的信息。 |
CampaignDTO
有关商店的信息。
|
Name |
Description |
|
apiAvailability |
Type: ApiAvailabilityStatusType 使用API的能力:
Enum: |
|
business |
Type: BusinessDTO 柜的信息。 |
|
clientId ⦸
|
Type: integer<int64> 付款人在Yandex中的ID。平衡。 |
|
domain |
Type: string 这家商店的名字。 |
|
id |
Type: integer<int64> 活动ID。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要发送商店ID,这是在市场上的卖家帐户旁边的商店名称和一些报告。 |
|
placementType |
Type: PlacementType 商店使用的模型:
Enum: |
ApiAvailabilityStatusType
使用API的能力:
AVAILABLE— API方法可用于执行请求。DISABLED_BY_INACTIVITY— 由于[商店或橱柜不活动],API方法不可用(*inactivity).
|
Type |
Description |
|
Enum: |
BusinessDTO
柜的信息。
|
Name |
Description |
|
id |
Type: integer<int64> 内阁ID。 |
|
name |
Type: string 企业名称。 |
PlacementType
商店使用的模型:
FBS— FBS 或 Express.FBY— FBY.DBS— DBS.
|
Type |
Description |
|
Enum: |
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
ApiErrorDTO
一般错误格式。
|
Name |
Description |
|
code* |
Type: string 的错误代码。 |
|
message |
Type: string 错误的描述。 |
ApiResponseStatusType
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
|
Type |
Description |
|
Enum: |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
市场的内部错误。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
|
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.
该商店被禁用,因为它没有在展柜中放置产品超过90天。
橱柜里没有一个活跃的商店.