Nhóm tài sản và người dùng

Quản lý nhóm tài sản của doanh nghiệp bạn và tìm hiểu cách kết nối người dùng doanh nghiệp với các nhóm tài sản. 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.

Nhóm tài sản

Lấy danh sách nhóm

Để 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, hãy gửi yêu cầu GET đến điểm cuối BusinessBusinessAssetGroups.

Yêu cầu mẫu

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_asset_groups
    ?access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Northern Region"
    },
    {
      "id": "BUSINESS-ID",
      "name": "Western Region"
    }
  ],
....
}

Lấy một nhóm cụ thể

Để lấy thông tin chi tiết về nhóm tài sản doanh nghiệp cụ thể, hãy gửi yêu cầu GET đến điểm cuối BusinessAssetGroup.

Yêu cầu mẫu

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

{
  "id": "BUSINESS-ASSET-GROUP-ID", "name": "BUSINESS-ASSET-GROUP-NAME"
}

Đổi tên nhóm

Để đổi tên một nhóm tài sản cụ thể, hãy gửi yêu cầu POST đến điểm cuối BusinessAssetGroup và đặt name thành giá trị mới.

Yêu cầu mẫu

curl -i -X POST 
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
   ?name=BUSINESS-ASSET-GROUP-NAME
   &access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

"success":  "true"

Xóa nhóm

Để xóa một nhóm tài sản cụ thể, hãy gửi yêu cầu DELETE đến điểm cuối BusinessAssetGroup.

Yêu cầu mẫu

curl -i -X DELETE 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

"success":  "true"

Người dùng

Những trường Người dùng công khai cho một Người dùng có vai trò trong doanh nghiệp đã xác nhận quyền sở hữu ứng dụng.

Yêu cầu

• Với tính năng Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp, ứng dụng dành cho Doanh nghiệp có thể đọc một nhóm nhỏ các Trường công khai về một Người dùng, miễn là Người dùng này đã tương tác với tài sản của Doanh nghiệp đã xác nhận quyền sở hữu ứng dụng.

Hãy xem tài liệu tham khảo về Quyền truy cập vào trang cá nhân của người dùng trong tài sản doanh nghiệp để biết danh sách các Trường có thể đọc của Người dùng.

Lấy quyền truy cập của người dùng vào nhóm

Để xem danh sách tất cả những nhóm tài sản doanh nghiệp mà một người dùng trong doanh nghiệp có thể truy cập, hãy gửi yêu cầu GET đến điểm cuối BusinessScopedUser/AssignedBusinessAssetGroups.

Yêu cầu mẫu

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_business_asset_groups
    ?limit=1
    &access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

Phản hồi này bao gồm các vai trò xác định cấp độ truy cập của người dùng cho mỗi loại tài sản:

{
  "data": [
    {
      "id": "BUSINESS-ID" 
      "name": "USER NAME",      
      "page_roles": [ "ANALYZE", "ADVERTISE" ],
      "offline_conversion_data_set_roles": ["UPLOAD"],
      "adaccount_roles": ["ANALYZE", "ADVERTISE"],      
      "pixel_roles": ["ANALYZE", "EDIT"]    
    }  
    ],
        ....
}

Lấy quyền của người dùng

Để đọc danh sách những người dùng được chỉ định cho một nhóm tài sản, hãy gửi yêu cầu GET đến điểm cuối BusinessAssetGroupAssignedUsers.

Yêu cầu mẫu

curl -i -X GET
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?limit=2
    &business=<BUSINESS_ID>
    &access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Dabney Donigan",
      "page_roles": [ "ANALYZE" ],  
      "offline_conversion_data_set_roles": [ "ADVERTISE", "UPLOAD", "MANAGE" ],
      "adaccount_roles": [ "ANALYZE" ],
      "pixel_roles": [ "ANALYZE", "EDIT" ]
      }
      ],
   ....
}

Chỉ định người dùng cho nhóm tài sản

Để chỉ định người dùng cho một nhóm tài sản doanh nghiệp, hãy gửi yêu cầu POST đến điểm cuối BusinessAssetGroupAssignedUsers.

Yêu cầu mẫu

curl -i -X POST 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=USER-ID 
    &page_roles=LIST-OF-PAGE-ROLES
    &adaccount_roles=LIST-OF-AD-ACCOUNT-ROLES
    &pixel_roles=LIST-OF-PIXEL-ROLES
    &offline_conversion_data_set_roles=LIST-OF-OFFLINE-CONVERSION-ROLES
    &access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

"success":  "true"

Xóa người dùng khỏi nhóm tài sản

Để xóa người dùng khỏi nhóm, hãy gửi yêu cầu POST đến điểm cuối BusinessAssetGroup.

Yêu cầu mẫu

curl -i -X DELETE \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=<USER_ID>
    &access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

"success":  "true"