Facebook — Business và quảng cáo

Xem quyền đã cấp (List granted permissions) — facebook.list_permissions

Lists the permissions the connected Facebook user granted or declined to the app. Use to explain why another Facebook action failed with a permission error.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	—

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].permission		string
data[].status		string
paging	Phân trang	object
paging.cursors		object

Xem danh sách Business (List businesses) — facebook.list_businesses

Lists Business Manager accounts the connected user belongs to (id, name). Use the id with list_owned_pages or list_owned_ad_accounts.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	business_management

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].id		string
data[].name		string
paging	Phân trang	object
paging.cursors		object

Xem Page do Business sở hữu (List business-owned Pages) — facebook.list_owned_pages

Lists Pages owned by a Business Manager account. Requires the business id from list_businesses. Supports paging.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	business_management

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
business_id	Mã Business	string	có	Business Manager id. From facebook.list_businesses.
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].id		string
data[].name		string
data[].category		string
paging	Phân trang	object
paging.cursors		object

Xem Page khách hàng của Business (List business client Pages) — facebook.list_client_pages

Lists Pages that clients shared with a Business Manager account. Requires the business id from list_businesses. Supports paging.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	business_management

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
business_id	Mã Business	string	có	Business Manager id. From facebook.list_businesses.
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].id		string
data[].name		string
data[].category		string
paging	Phân trang	object
paging.cursors		object

Xem tài khoản quảng cáo (List ad accounts) — facebook.list_ad_accounts

Lists ad accounts the connected user can access (id like act_123, name, status, currency). Use the id as parent for list_ads or get_ad_insights.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	ads_read

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].id		string
data[].name		string
data[].account_status		integer
data[].currency		string
paging	Phân trang	object
paging.cursors		object

Xem tài khoản quảng cáo của Business (List business-owned ad accounts) — facebook.list_owned_ad_accounts

Lists ad accounts owned by a Business Manager account. Requires the business id from list_businesses. Supports paging.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	ads_read, business_management

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
business_id	Mã Business	string	có	Business Manager id. From facebook.list_businesses.
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].id		string
data[].name		string
data[].account_status		integer
data[].currency		string
paging	Phân trang	object
paging.cursors		object

Xem danh sách quảng cáo (List ads) — facebook.list_ads

Lists ads under an ad account (act_...), campaign or ad set. effective_status filters, e.g. ["ACTIVE","PAUSED"]. Supports paging.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	ads_read

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
parent_id	Mã tài khoản, chiến dịch hoặc nhóm quảng cáo	string	có	Ad account id (act_<id>), campaign id or ad set id. From facebook.list_ad_accounts.
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
effective_status	Trạng thái hiệu lực	string	không	JSON array string of ad statuses to keep, e.g. ["ACTIVE","PAUSED"].
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].id		string
data[].name		string
data[].status		string
data[].effective_status		string
paging	Phân trang	object
paging.cursors		object

Xem insights quảng cáo (Get ad insights) — facebook.get_ad_insights

Reads ad performance for an ad account, campaign, ad set or ad. Choose fields (impressions,spend,clicks), date_preset, time_range, level, breakdowns. time_range is a JSON string like {"since":"YYYY-MM-DD","until":"YYYY-MM-DD"}.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	ads_read

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
object_id	Mã đối tượng quảng cáo	string	có	Ad account (act_<id>), campaign, ad set or ad id. From facebook.list_ad_accounts.
fields	Các trường cần lấy (fields)	string	không	Comma-separated insight fields, e.g. "impressions,spend,clicks".
date_preset	Khoảng thời gian định sẵn	string	không	Relative date range; default last_30d. Ignored when time_range is set. One of: today, yesterday, this_month, last_month, this_quarter, maximum, data_maximum, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, last_week_mon_sun, last_week_sun_sat, last_quarter, last_year, this_week_mon_today, this_week_sun_today, this_year.
time_range	Khoảng thời gian tùy chọn	string	không	JSON string like
level	Cấp độ	string	không	Level to aggregate results at; defaults to the level of object_id. One of: ad, adset, campaign, account.
breakdowns	Phân tách (breakdowns)	string	không	Comma-separated breakdowns, e.g. "age,gender" or "publisher_platform".
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].impressions		string
data[].clicks		string
data[].spend		string
data[].date_start		string
data[].date_stop		string
paging	Phân trang	object
paging.cursors		object

Tìm vị trí nhắm mục tiêu (Search targeting locations) — facebook.search_geographic_targeting_locations

Searches geographic locations usable in ad targeting by keyword q. location_types limits to country, region, city, etc. Returns keys for targeting specs. location_types is a JSON array string like ["city","region"].

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	ads_read

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
q	Từ khóa tìm kiếm	string	có	Location name to search, e.g. "Hanoi".
location_types	Loại vị trí	string	không	JSON array string of types, e.g. ["city","region"]; country, region, city, zip, geo_market, electoral_district.
limit	Số kết quả tối đa	integer	không	Max items per page (1-100). Min 1. Max 100.
after	Con trỏ trang tiếp theo	string	không	Cursor for the next page, from paging.cursors.after of the previous call.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
data	Danh sách kết quả	array of object
data[].key		string
data[].name		string
data[].type		string
data[].country_code		string
paging	Phân trang	object
paging.cursors		object

Xem tài khoản đang kết nối (Get current user) — facebook.get_current_user

Reads the connected Facebook user profile (id, name). Use to confirm which account is connected. Pass fields to request more.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	—

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
id	Mã người dùng	string
name	Tên	string

Đọc một đối tượng Graph (Get Graph object) — facebook.get_graph_object

Reads any Graph node by id (digits, 123_456, me or act_<id>). Pass fields to choose properties and page_id to use that Page's token.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	—

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
node_id	Mã đối tượng	string	có	Graph node id: digits, "123_456", "me" or "act_<id>".
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
page_id	Mã Page (dùng token của Page)	string	không	Page whose token is used to read; empty uses the user token. From facebook.list_managed_pages.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
id	Mã đối tượng	string

Đọc nhiều đối tượng Graph (Get Graph objects) — facebook.get_graph_objects

Reads 1-50 Graph nodes by id in one call. Returns an objects map keyed by id. Pass page_id to use that Page's token.

Tác động	Rủi ro	Cần duyệt	Idempotent	Scopes
NONE	low	không	có	—

Input

Field	Nhãn	Kiểu	Bắt buộc	Mô tả
ids	Danh sách mã đối tượng	array of string	có	Graph node ids (1-50), e.g. ["123", "123_456"].
fields	Các trường cần lấy (fields)	string	không	Comma-separated Graph fields to return, e.g. "id,name"; empty uses the defaults.
page_id	Mã Page (dùng token của Page)	string	không	Page whose token is used to read; empty uses the user token. From facebook.list_managed_pages.

Field thêm: bỏ qua.

Output

Field	Nhãn	Kiểu	Mô tả
objects	Đối tượng theo mã	object