Users with access to the account — Facebook API

Assigned Users

GET/{version}/act_{account_id}/assigned_usersVia 360: GET https://partner.quantri360.com/v1/facebook/{version}/act_{account_id}/assigned_users

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.

Description

Người (người dùng doanh nghiệp, người dùng hệ thống) được cấp quyền vào tài khoản quảng cáo và quyền cụ thể của từng người. Dùng để rà ai đang có quyền sửa / xem tài khoản.

Đường dẫn có act_<id> → 360 tự chọn token tài khoản.
Thiếu business → lỗi 100 "The parameter business is required".
Có tên người — xử lý như dữ liệu cá nhân.

Request

Endpoint

GET https://partner.quantri360.com/v1/facebook/{version}/act_{account_id}/assigned_users

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
account_id	path	string	Yes	5924809560908319	Id tài khoản quảng cáo (số, không có act_).
business	query	string	Yes	183780650684749	Id doanh nghiệp sở hữu tài khoản (lấy ở `GET /act_{account_id}?fields=business`).
fields	query	string	No	id,name,user_type,tasks	Trường cần lấy. Không gửi = `id`, `tasks`.
limit	query	int	No	25
after	query	string	No		Con trỏ trang kế.

Request examples

curl -s "https://partner.quantri360.com/v1/facebook/v25.0/act_5924809560908319/assigned_users?business=183780650684749&fields=id%2Cname%2Cuser_type%2Ctasks" \
  -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/act_5924809560908319/assigned_users",
    params={
        "business": "183780650684749",
        "fields": "id,name,user_type,tasks"
    },
    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/act_5924809560908319/assigned_users');
for (const [k, v] of Object.entries({"business":"183780650684749","fields":"id,name,user_type,tasks"})) 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/act_5924809560908319/assigned_users' . '?' . http_build_query(['business' => '183780650684749', 'fields' => 'id,name,user_type,tasks']);
$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

Response fields (as returned by Facebook)

Name	Type	Sample	Description
data	object[]		Người được cấp quyền.
id	string		Id người dùng doanh nghiệp / hệ thống.
name	string		Tên — dữ liệu cá nhân.
user_type	string	business_user	`business_user` (người) · `system_user` (người dùng hệ thống / tích hợp).
tasks	string[]	["DRAFT","ANALYZE","ADVERTISE","MANAGE"]	Quyền: `MANAGE` (quản lý) · `ADVERTISE` (tạo, sửa quảng cáo) · `ANALYZE` (xem báo cáo) · `DRAFT` (soạn nháp).
paging	object
summary	object		Khi gửi `summary=total_count`.

Response sample

{
  "data": [
    {
      "id": "122127296673427948",
      "name": "Tích hợp mẫu",
      "user_type": "system_user",
      "tasks": [
        "DRAFT",
        "ANALYZE"
      ]
    },
    {
      "id": "122302801418082794",
      "name": "Nguyễn Văn A",
      "user_type": "business_user",
      "tasks": [
        "DRAFT",
        "ANALYZE",
        "ADVERTISE"
      ]
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIVGROZAWR…",
      "after": "QVFIVEdhb3Fx…"
    }
  }
}

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