v2.ads.check_create_gms_product_campaign_eligibility
GET/api/v2/ads/check_create_gms_product_campaign_eligibilityGọi qua 360: GET https://partner.quantri360.com/v1/shopee_ads/api/v2/ads/check_create_gms_product_campaign_eligibility
Mô tả API
Kiểm tra gian hàng có tạo được chiến dịch GMS (quảng cáo tối ưu doanh thu toàn shop) hay không, và lý do nếu không. Gọi trước khi hiển thị nút "Tạo chiến dịch GMS".
- Chỉ kiểm tra, không tạo gì. Gian hàng đang có chiến dịch GMS chạy: is_eligible = false, reason = active_campaign.
Request
Địa chỉ
GET https://partner.quantri360.com/v1/shopee_ads/api/v2/ads/check_create_gms_product_campaign_eligibility
Xác thực & gian hàng
| Tên | Vị trí | Kiểu | Mẫu | Mô tả |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 100001 | Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp. |
Tham số request
Không có tham số riêng (ngoài tham số chung).
Ví dụ request
curl -s "https://partner.quantri360.com/v1/shopee_ads/api/v2/ads/check_create_gms_product_campaign_eligibility" \ -H "Authorization: Bearer $KEY"
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.get(
"https://partner.quantri360.com/v1/shopee_ads/api/v2/ads/check_create_gms_product_campaign_eligibility",
params={},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/shopee_ads/api/v2/ads/check_create_gms_product_campaign_eligibility');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'GET',
headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());PHP
<?php $key = 'q360_live_...'; // khóa API của brand $url = 'https://partner.quantri360.com/v1/shopee_ads/api/v2/ads/check_create_gms_product_campaign_eligibility' . '?' . http_build_query([]); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]); $res = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); echo $status, "\n", $res;
Response
Tham số phản hồi (nguyên của Shopee Ads)
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| request_id | string | d52ca43b277a4f9292fb8be658bfd33d | Mã request của Shopee để tra lỗi. |
| error | string | Mã lỗi Shopee; rỗng = thành công. | |
| message | string | Mô tả lỗi. | |
| warning | string | ||
| response | object | ||
| is_eligible | bool | false | true = tạo được. |
| reason | string | active_campaign | Lý do khi không tạo được: `active_campaign` (đã có chiến dịch GMS đang chạy) · `not_whitelisted` (gian hàng chưa được mở tính năng) · `not_have_enough_sku` (không đủ sản phẩm hợp lệ) · `exclusive_with_other_campaign` (gian hàng đang thuộc diện quảng cáo Đẩy tự động — auto boost — loại trừ GMS). |
Mẫu phản hồi
{
"error": "",
"message": "",
"warning": "",
"request_id": "e3e3e7f35ef6cfee…",
"response": {
"is_eligible": false,
"reason": "active_campaign"
}
}
Mã lỗi của Shopee Ads (15)
Bấm để xem
| Mã | Ý nghĩa |
|---|---|
| ads_error_not_whitelisted_for_product_gms | Gian hàng chưa được cho phép sử dụng GMS sản phẩm. |
| error_server | Lỗi hệ thống Shopee — thử lại sau ít phút. |
| ads.ads_account.invalid_status | Trạng thái tài khoản quảng cáo không hợp lệ. |
| ads.rate_limit.campaign_level | Chiến dịch có quá nhiều yêu cầu; thử lại sau. |
| ads.rate_limit.exceed_partner_api | Quá nhiều yêu cầu; giảm tần suất rồi thử lại sau. |
| ads.rate_limit.exceed_shop_api | Gian hàng có quá nhiều yêu cầu; thử lại sau. |
| ads.rate_limit.exceed_api | Quá nhiều yêu cầu; thử lại sau. |
| ads.shop.in_holiday_mode | Gian hàng đang ở chế độ nghỉ. |
| ads.shop.status_not_normal | Trạng thái gian hàng không bình thường. |
| error_auth | Ủy quyền gian hàng cho 360 đã hết hạn hoặc bị thu hồi (360 đã tự làm mới token một lần) — chủ gian hàng kết nối lại Shopee trong Partner. |
| error_param | Tham số sai / thiếu / sai kiểu — xem `message` để biết tham số nào. |
| error_limit | Chạm hạn mức gọi Shopee trong ngày của kết nối — 360 trả kèm thời điểm thử lại; giảm tần suất gọi. |
| error_rate_limit | Gọi quá nhanh — chờ vài giây rồi gọi lại (360 cũng giới hạn theo key: 429 + Retry-After). |
| shop_banned | Gian hàng đang bị Shopee khóa — mọi API tạm ngưng tới khi gỡ khóa. |
| error_kyc_auth | Gian hàng chưa hoàn tất đăng ký người bán trên Kênh Người Bán. |
Bắt đầu dùng
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Quảng cáo (Ads) ở trang nền tảng
- Tạo API key (tick kênh Shopee Ads)
- Gọi theo ví dụ ở trên