Tổng quan về quản lý tài sản

Một doanh nghiệp có thể truy cập vào nhiều tài sản. Doanh nghiệp của bạn sở hữu tài sản hoặc doanh nghiệp của bạn truy cập vào tài sản với vai trò agency. Bạn có thể sử dụng API Quản lý tài sản doanh nghiệp của Facebook để thêm, gỡ hoặc truy vấn mối quan hệ giữa một doanh nghiệp và tài sản của doanh nghiệp đó, để quản lý tài sản doanh nghiệp và quyền truy cập vào tài sản.

Agency là một loại thực thể kinh doanh có thể quản lý hoặc truy cập vào tài sản của doanh nghiệp khác. Mối quan hệ này giúp agency có thể thực hiện những tác vụ hoặc hành động cụ thể (ví dụ: quản lý tài khoản quảng cáo, trang hay các tài sản số khác) thay mặt cho khách hàng.

Nhóm tài sản doanh nghiệp

Nhóm tài sản doanh nghiệp giúp các nhà quảng cáo hoặc agency lớn quản lý người dùng và tài sản trong doanh nghiệp của họ một cách hiệu quả. Bạn nên sắp xếp tài sản và người dùng theo cách phù hợp với hoạt động trong thực tế. Ví dụ: doanh nghiệp có thể sắp xếp tài sản và người dùng theo thương hiệu, khu vực, khách hàng hoặc nguyên tắc sắp xếp mà họ lựa chọn.

Nhóm tài sản doanh nghiệp có thể chứa tài khoản quảng cáo, Trang, Facebook pixel, nhóm sự kiện offline, ứng dụng, danh mục, chuyển đổi tùy chỉnh và tài khoản Instagram. Những tài sản này có thể thuộc sở hữu của doanh nghiệp hoặc được chia sẻ để cấp quyền truy cập cho agency.

Bạn có thể sử dụng API này để thêm người dùng vào nhóm tài sản doanh nghiệp. Sau khi thêm, bạn có thể cấp cho người dùng quyền truy cập vào các tài sản trong một nhóm tài sản doanh nghiệp. Nhờ vậy, bạn có thể cấp quyền truy cập vào nhiều tài sản cùng một lúc mà không cần tạo quá nhiều quản trị viên ở cấp độ doanh nghiệp.

Với API này, bạn có thể quản lý các nhóm tài sản doanh nghiệp mà ai đó đã tạo thông qua Trình quản lý kinh doanh hoặc bạn có thể quản lý các tài sản trong nhóm tài sản doanh nghiệp đó. Bạn có thể:

Lấy danh sách các nhóm tài sản doanh nghiệp được liên kết với một doanh nghiệp
Xóa hoặc đổi tên nhóm tài sản doanh nghiệp
Xem tất cả tài sản trong một nhóm tài sản doanh nghiệp
Lấy, thêm, chỉnh sửa và xóa quyền của người dùng đối với các tài sản trong một nhóm tài sản doanh nghiệp
Chỉ định người dùng cho nhóm tài sản doanh nghiệp
Lấy, thêm và xóa tài sản khỏi nhóm tài sản doanh nghiệp

Quyền

Để sử dụng API Nhóm tài sản doanh nghiệp, ứng dụng của bạn cần có Cấp độ truy cập API Marketing thích hợp:

Đối với mọi điểm cuối thêm và gỡ: Người dùng mã truy cập cần phải là quản trị viên của doanh nghiệp. Nếu không, quyền truy cập sẽ bị từ chối.
Đối với mọi điểm cuối API, ứng dụng của bạn cần có quyền business_management.

Bạn cần có quyền khác để:

Điểm cuối cho nhóm tài sản doanh nghiệp	Quyền bắt buộc
Lấy danh sách Tài khoản quảng cáo	`ads_management`
Lấy danh sách danh mục sản phẩm, thêm danh mục sản phẩm hoặc gỡ danh mục sản phẩm	`ads_management`
Lấy danh sách tài khoản Instagram, thêm tài khoản Instagram hoặc gỡ tài khoản Instagram	`ads_management`. Nếu đang sử dụng API Marketing v4.0, bạn cũng cần có `instagram_basic`.
Lấy danh sách pixel	`ads_read`
Lấy danh sách nhóm sự kiện offline	`ads_management`
Lấy danh sách chuyển đổi tùy chỉnh	`ads_read`
Thêm chuyển đổi tùy chỉnh	`ads_management`

Giới hạn

Bạn sẽ gặp lỗi nếu cố giảm bớt hoặc thu hồi quyền đối với tài sản trong một nhóm tài sản doanh nghiệp thông qua lệnh gọi API sau đây:

yêu cầu DELETE đến /{page_id}/assigned_users
yêu cầu POST đến /{page_id}/assigned_users
yêu cầu DELETE đến /act_{ad_account_id}/assigned_users
yêu cầu POST đến /act_{ad_account_id}/assigned_users.

Để giảm bớt hoặc thu hồi quyền, hãy làm theo các bước sau đây:

Thực hiện lệnh gọi để lấy danh sách các nhóm tài sản được liên kết với một doanh nghiệp. Tìm nhóm tài sản trong đó contained_asset_id bằng {page_id} hoặc {ad_account_id}.
Đối với mỗi ID nhóm tài sản doanh nghiệp được trả về, hãy thực hiện lệnh gọi API để xóa người dùng khỏi nhóm đó.
Sau đó, gửi yêu cầu DELETE hoặc POST nêu trên để thu hồi quyền của người dùng đó đối với Trang hoặc Tài khoản quảng cáo.

Nếu cung cấp tính năng quản lý quyền trong ứng dụng của mình cho các doanh nghiệp khác, bạn cần sử dụng API này để ngăn chặn lỗi cũng như tình trạng không nhất quán giữa API và Trình quản lý kinh doanh.

Bạn không thể thiết lập quyền đối với ứng dụng, danh mục, tài khoản Instagram và chuyển đổi tùy chỉnh thông qua nhóm tài sản doanh nghiệp. Thay vào đó, bạn nên chỉ định quyền ở cấp độ tài sản.

Ví dụ: nếu bạn thêm Roger vào một nhóm tài sản doanh nghiệp trong trình quản lý kinh doanh của Jasper, anh ấy có thể có quyền truy cập vào Trang, tài khoản quảng cáo, pixel và tài sản bất kỳ trong nhóm tài sản doanh nghiệp đó. Tuy nhiên, để thu hồi hay chỉnh sửa quyền của Roger đối với bất kỳ tài sản nào trong nhóm tài sản doanh nghiệp của Jasper, bạn phải thực hiện hành động này trong chính nhóm tài sản doanh nghiệp đó.

Bạn có thể thêm quyền của người dùng ở cấp độ tài sản thông qua API tài sản, chẳng hạn như thay đổi ai đó từ người kiểm duyệt Trang thành quản trị viên. Hãy xem ví dụ về Trang và Tài khoản quảng cáo.

Nhóm tài sản doanh nghiệp đã thay thế API Dự án từ ngày 13/10/2019. Bạn nên di chuyển mọi ứng dụng trong API Dự án sang nhóm tài sản doanh nghiệp.

Vai trò được phép

Khi thêm người dùng vào doanh nghiệp, bạn có thể chỉ định 1 trong 2 vai trò sau đây thông qua API Người dùng doanh nghiệp:

Hằng số API	Tên	Mô tả
`ADMIN`	Quản trị viên doanh nghiệp	Có thể quản lý mọi khía cạnh của phần cài đặt cho doanh nghiệp, bao gồm cả sửa đổi hoặc xóa tài khoản cũng như thêm hoặc xóa người dùng.
`EMPLOYEE`	Nhân viên của doanh nghiệp	Có thể xem tất cả thông tin trong phần cài đặt cho doanh nghiệp nhưng không thể thực hiện thay đổi nào, ngoại trừ thêm Trang hoặc tài khoản quảng cáo mà người dùng này là quản trị viên của doanh nghiệp.

Danh mục

Bạn có thể chỉ định các vai trò sau đây cho bất kỳ người dùng nào của doanh nghiệp - Quản trị viên hoặc Nhân viên - đối với danh mục mà doanh nghiệp này có thể truy cập thông qua API Danh mục:

Hằng số API	Tên	Mô tả
`['MANAGE', 'ADVERTISE']`	Quản trị viên danh mục	Có thể quản lý mọi khía cạnh của danh mục với quyền đọc và ghi đầy đủ, bao gồm tạo/cập nhật/xóa mặt hàng, quản lý nguồn cấp dữ liệu, đính kèm danh mục vào pixel và ứng dụng, tạo nhóm sản phẩm, chạy quảng cáo danh mục Advantage+ với danh mục, thay đổi cài đặt danh mục, v.v.
`['ADVERTISE']`	Nhà quảng cáo danh mục	Có thể tạo nhóm sản phẩm và chạy quảng cáo danh mục Advantage+ với danh mục. Không thể chỉnh sửa sản phẩm, nguồn cấp dữ liệu hoặc cài đặt danh mục.

Tài khoản quảng cáo

Bạn có thể chỉ định các tác vụ sau đây cho bất kỳ người dùng nào của doanh nghiệp đối với tài khoản quảng cáo mà doanh nghiệp này có thể truy cập thông qua API Tài khoản quảng cáo:

Hằng số API	Tên	Mô tả
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	Quản trị viên tài khoản quảng cáo	Có thể quản lý mọi khía cạnh của chiến dịch, báo cáo, lập hóa đơn và quyền của tài khoản, đồng thời có thể đặt giới hạn chi tiêu cho tài khoản quảng cáo. Quản trị viên tài khoản quảng cáo cũng có thể liên kết các phương thức thanh toán của doanh nghiệp.
`['ADVERTISE', 'ANALYZE']`	Nhà quảng cáo trên tài khoản quảng cáo	Có thể xem và chỉnh sửa quảng cáo cũng như thiết lập quảng cáo bằng phương thức thanh toán được liên kết với tài khoản quảng cáo.
`['ANALYZE']`	Nhà phân tích Tài khoản quảng cáo	Có thể xem hiệu quả quảng cáo.

Trang

Bạn có thể chỉ định các tác vụ sau đây cho bất kỳ người dùng nào của doanh nghiệp đối với Trang mà doanh nghiệp này có thể truy cập thông qua API Trang:

Hằng số API	Tên	Mô tả
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Quản trị viên Trang	Có thể quản lý vai trò trên Trang, gửi tin nhắn và đăng với vai trò Trang, tạo quảng cáo và xem thông tin chi tiết.
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Biên tập viên Trang	Có thể chỉnh sửa Trang, gửi tin nhắn và đăng với vai trò Trang, tạo quảng cáo và xem thông tin chi tiết.
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Người kiểm duyệt Trang	Có thể trả lời và xóa bình luận trên Trang, gửi tin nhắn với vai trò Trang, tạo quảng cáo và xem thông tin chi tiết. Không thể đăng với vai trò Trang.
`['ADVERTISE', 'ANALYZE']`	Nhà quảng cáo Trang	Có thể tạo quảng cáo cho Trang và xem thông tin chi tiết. Không thể đăng với vai trò Trang.
`['ANALYZE']`	Nhà phân tích Trang	Có thể xem thông tin chi tiết. Không thể đăng với vai trò Trang.

Ứng dụng

Không có API quản lý vai trò hay tác vụ nào cho các ứng dụng trong Trình quản lý kinh doanh.

Tài khoản Instagram

Không có tùy chọn quản lý vai trò nào cho tài khoản Instagram trong Trình quản lý kinh doanh. Người dùng có quyền truy cập vào các tài khoản quảng cáo được liên kết với tài khoản Instagram có thể chạy quảng cáo cho những tài khoản Instagram đó.