AssetGroupListingGroupFilterService.MutateAssetGroupListingGroupFilters
POST/{version}/customers/{customer_id}/assetGroupListingGroupFilters:mutateGọi qua 360: POST https://partner.quantri360.com/v1/google/{version}/customers/{customer_id}/assetGroupListingGroupFilters:mutate
Endpoint ghi — thay đổi dữ liệu trên Google Ads. Key phải được tạo với tick "Cho phép gọi API ghi", nếu không sẽ nhận 403 write_not_allowed. Mỗi lần gọi được ghi nhật ký.
Mô tả API
Bộ lọc nhóm sản phẩm của nhóm tài sản Performance Max (sản phẩm Merchant Center nào được quảng cáo). ENDPOINT GHI.
- resourceName dạng
customers/{customer_id}/<loại>/<id>; tên trường theo camelCase. - Chỉ dùng được khi chiến dịch có gắn Merchant Center (không có → LISTING_SOURCE_NOT_ALLOWED).
Request
Địa chỉ
POST https://partner.quantri360.com/v1/google/{version}/customers/{customer_id}/assetGroupListingGroupFilters:mutate
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 | 1234567890 | Customer ID Google Ads (chỉ số) brand đã nối với 360 — lấy ở GET /v1/platforms; phải trùng customers/{customer_id} trong đường dẫn. |
Tham số request
| Tên | Vị trí | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|---|
| version | path | string | Có | v23 | Phiên bản Google Ads API — dùng bản đang hỗ trợ (v23 trở lên tại 10/2026). Google gỡ bản cũ định kỳ: bản đã gỡ trả trang lỗi HTML 404, bản sắp gỡ trả UNSUPPORTED_VERSION. |
| customer_id | path | string | Có | 1234567890 | Customer ID (chỉ số, không gạch) đã nối với 360. |
| operations | body | object[] | Có | [{"create":{"assetGroup":"customers/1234567890/assetGroups/777","type":"UNIT_INCLUDED","listingSource":"SHOPPING"}}] | Danh sách thao tác: create / update (kèm updateMask) / remove (resourceName). |
| partialFailure | body | bool | Không | false | true = thao tác hợp lệ vẫn chạy khi có thao tác lỗi. |
| validateOnly | body | bool | Không | false | true = Google chỉ kiểm tra hợp lệ, KHÔNG thay đổi (phản hồi {}) — nên thử trước. |
Ví dụ request
curl -s -X POST "https://partner.quantri360.com/v1/google/v23/customers/1234567890/assetGroupListingGroupFilters:mutate" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"operations":[{"create":{"assetGroup":"customers/1234567890/assetGroups/777","type":"UNIT_INCLUDED","listingSource":"SHOPPING"}}]}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/google/v23/customers/1234567890/assetGroupListingGroupFilters:mutate",
params={},
json={
"operations": [
{
"create": {
"assetGroup": "customers/1234567890/assetGroups/777",
"type": "UNIT_INCLUDED",
"listingSource": "SHOPPING"
}
}
]
},
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/google/v23/customers/1234567890/assetGroupListingGroupFilters:mutate');
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: 'POST',
headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({"operations":[{"create":{"assetGroup":"customers/1234567890/assetGroups/777","type":"UNIT_INCLUDED","listingSource":"SHOPPING"}}]}),
});
console.log(r.status, await r.json());PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/google/v23/customers/1234567890/assetGroupListingGroupFilters:mutate' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"operations":[{"create":{"assetGroup":"customers/1234567890/assetGroups/777","type":"UNIT_INCLUDED","listingSource":"SHOPPING"}}]}');
$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 Google Ads)
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| results | object[] | [{resourceName}] — đối tượng vừa tạo / sửa / xóa. |
Bắt đầu dùng
- Đăng ký tài khoản Partner
- Mở loại dữ liệu thuộc nhóm Google Ads ở trang nền tảng
- Tạo API key (tick kênh Google Ads)
- Gọi theo ví dụ ở trên