Cập nhật chiến dịch / nhóm / quảng cáo: status (ACTIVE | PAUSED), daily_budget, lifetime_budget…

Update Object

POST/{version}/{object_id}Via 360: POST https://partner.quantri360.com/v1/facebook/{version}/{object_id}

Coming soon. This API already runs in production through 360 and pricing is being finalised — you can read the docs and prepare your integration now.

Write endpoint — changes data on Facebook. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.

Description

Cập nhật chiến dịch / nhóm / quảng cáo: bật tắt (status), đổi ngân sách (daily_budget, lifetime_budget) — đúng thao tác 360 dùng ở Quản lý Facebook Ads. ENDPOINT GHI.

Body gửi dạng JSON; 360 chuyển sang form như Graph yêu cầu.
Thêm "execution_options": ["validate_only"] để Meta CHỈ KIỂM TRA hợp lệ, không thay đổi (trả {"success": true}) — nên thử trước khi sửa thật.
Ngân sách theo đơn vị nhỏ nhất của tiền tệ tài khoản (VND: số đồng).

Request

Endpoint

POST https://partner.quantri360.com/v1/facebook/{version}/{object_id}

Authentication & shop

Name	In	Type	Sample	Description
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	act_123456789 hoặc 1234567890	Tài sản Facebook brand đã nối với 360: tài khoản quảng cáo (act_<id> hoặc <id>), Page id hoặc Pixel id — lấy ở GET /v1/platforms. Có thể bỏ khi đường dẫn đã chứa act_<id> / page id của brand.

Request parameters

Name	In	Type	Required	Sample	Description
version	path	string	Yes	v25.0
object_id	path	string	Yes	120210000000000000	Id chiến dịch / nhóm / quảng cáo.
status	body	string	No	PAUSED	`ACTIVE` \| `PAUSED` \| `ARCHIVED`.
daily_budget	body	int	No	200000	Ngân sách ngày (đơn vị nhỏ nhất, VND = đồng).
lifetime_budget	body	int	No		Ngân sách trọn đời.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/facebook/v25.0/120210000000000000" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"PAUSED"}'

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/facebook/v25.0/120210000000000000",
    params={},
    json={
        "status": "PAUSED"
    },
    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/facebook/v25.0/120210000000000000');
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({"status":"PAUSED"}),
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/facebook/v25.0/120210000000000000' . '?' . 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, '{"status":"PAUSED"}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by Facebook)

Name	Type	Sample	Description
success	bool	true

Get started

Sign up for Partner
Enable a data type of the Quảng cáo (Marketing API) group on the platform page
Create an API key (tick the Facebook channel)
Call it as in the examples above

Cập nhật chiến dịch / nhóm / quảng cáo: status (ACTIVE | PAUSED), daily_budget, lifetime_budget… — Facebook API