Tài khoản quảng cáo doanh nghiệp sở hữu — API Facebook

Owned Ad Accounts

GET/{version}/{business_id}/owned_ad_accountsGọi qua 360: GET https://partner.quantri360.com/v1/facebook/{version}/{business_id}/owned_ad_accounts

Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.

Mô tả API

Tài khoản quảng cáo do doanh nghiệp sở hữu.

Danh sách có thể gồm tài khoản QC chưa nối với 360 — muốn gọi API của tài khoản đó, brand phải nối nó ở admin trước.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/facebook/{version}/{business_id}/owned_ad_accounts

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	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.

Tham số request

Tên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
version	path	string	Có	v25.0
business_id	path	string	Có	183780650684749	Id doanh nghiệp (GET /me/businesses hoặc /act_…?fields=business).
platform_shop_id	query	string	Có	act_543733994517908	Tài khoản QC (hoặc Trang) đã nối thuộc doanh nghiệp này — 360 dùng token của tài sản đó.
fields	query	string	Không	id,account_id,name,account_status,currency,timezone_name,amount_spent	Trường cần lấy (mặc định chỉ id, account_id).
limit	query	int	Không	25
after	query	string	Không		`paging.cursors.after` của trang trước.

Phân trang

Lặp khi có paging.next: thêm after = paging.cursors.after.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/183780650684749/owned_ad_accounts?platform_shop_id=act_543733994517908&fields=id%2Cname%2Caccount_status%2Ccurrency%2Camount_spent&limit=25" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/facebook/v25.0/183780650684749/owned_ad_accounts",
    params={
        "platform_shop_id": "act_543733994517908",
        "fields": "id,name,account_status,currency,amount_spent",
        "limit": 25
    },
    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/183780650684749/owned_ad_accounts');
for (const [k, v] of Object.entries({"platform_shop_id":"act_543733994517908","fields":"id,name,account_status,currency,amount_spent","limit":25})) 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/facebook/v25.0/183780650684749/owned_ad_accounts' . '?' . http_build_query(['platform_shop_id' => 'act_543733994517908', 'fields' => 'id,name,account_status,currency,amount_spent', 'limit' => 25]);
$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 Facebook)

Tên	Kiểu	Mẫu	Mô tả
data	object[]		Tài khoản QC.
id	string	act_1347746699292797
account_id	string	1347746699292797	Id không có tiền tố act_.
name	string
account_status	int	1	1 = hoạt động · 2 = bị vô hiệu · 3 = chưa thanh toán · 101 = đã đóng …
currency	string	VND
timezone_name	string	Asia/Ho_Chi_Minh
amount_spent	string	1813279824	Tổng đã chi từ trước tới nay, đơn vị tiền của tài khoản.
paging	object		Chỉ có khi còn trang.

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Doanh nghiệp (Business Manager) ở trang nền tảng
Tạo API key (tick kênh Facebook)
Gọi theo ví dụ ở trên