자산 그룹 및 사용자

비즈니스의 자산 그룹을 관리하고 비즈니스 사용자를 자산 그룹에 연결하는 방법을 알아봅니다. 비즈니스 자산 그룹을 이용하면 대규모 광고주나 대행사가 비즈니스 수행 과정에서 사용자와 자산을 효율적으로 관리하는 데 도움이 됩니다. 실제 운영과 일치하는 방식으로 자산과 사용자를 정리해야 합니다. 예를 들어 비즈니스는 원하는 브랜드, 지역, 클라이언트 또는 조직 원칙에 따라 자산과 사용자를 구조화할 수 있습니다.

비즈니스 자산 그룹은 광고 계정, 페이지, Facebook 픽셀, 오프라인 이벤트 세트, 앱, 카탈로그, 맞춤 전환 및 Instagram 계정을 포함할 수 있습니다. 비즈니스는 자산을 소유하거나, 공유를 통해 대행사에 자산에 대한 액세스 권한을 제공할 수 있습니다.

자산 그룹

그룹 리스트 가져오기

비즈니스와 연결된 자산 그룹의 리스트를 가져오려면 BusinessBusinessAssetGroups 엔드포인트로 GET 요청을 보내세요.

요청 예시

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

응답 예시

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

특정 그룹 가져오기

특정 비즈니스 자산 그룹에 대한 상세 정보를 가져오려면 BusinessAssetGroup 엔드포인트로 GET 요청을 보내세요.

요청 예시

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

응답 예시

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

그룹 이름 변경

특정 자산 그룹의 이름을 변경하려면 BusinessAssetGroup 엔드포인트로 POST 요청을 보내고 name을 새 값으로 설정하세요.

요청 예시

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

응답 예시

"success":  "true"

그룹 삭제

특정 자산 그룹을 삭제하려면 BusinessAssetGroup 엔드포인트로 DELETE 요청을 보내세요.

요청 예시

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

응답 예시

"success":  "true"

사용자

앱의 소유권을 주장한 비즈니스에서 역할이 부여된 사용자에 대한 전체 공개 사용자 필드입니다.

요구 사항

• 비즈니스 자산 사용자 프로필 액세스 기능을 사용하면 비즈니스 앱이 사용자에 대한 일부 전체 공개 필드를 읽을 수 있습니다. 단, 사용자가 앱의 소유권을 주장한 비즈니스가 소유한 자산에 참여했어야 합니다.

읽을 수 있는 사용자 필드의 리스트는 비즈니스 자산 사용자 프로필 액세스 참고 자료를 참조하세요.

그룹에 대한 사용자 액세스 권한 가져오기

비즈니스 범위 사용자가 액세스할 수 있는 모든 비즈니스 자산 그룹의 리스트를 확인하려면 BusinessScopedUser/AssignedBusinessAssetGroups 엔드포인트로 GET 요청을 보내세요.

요청 예시

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

응답 예시

응답에는 자산 유형별로 사용자가 가지고 있는 액세스 수준을 정의하는 역할이 포함됩니다.

{
  "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"]    
    }  
    ],
        ....
}

사용자 권한 가져오기

자산 그룹에 대해 할당된 사용자의 리스트를 읽으려면 BusinessAssetGroupAssignedUsers 엔드포인트에 GET 요청을 보내세요.

요청 예시

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

응답 예시

{
  "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" ]
      }
      ],
   ....
}

사용자를 자산 그룹에 할당

비즈니스 자산 그룹에 사용자를 할당하려면 BusinessAssetGroupAssignedUsers 엔드포인트로 POST 요청을 보내세요.

요청 예시

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

응답 예시

"success":  "true"

자산 그룹에서 사용자 삭제

그룹에서 사용자를 삭제하려면 BusinessAssetGroup 엔드포인트로 POST 요청을 보내세요.

요청 예시

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

응답 예시

"success":  "true"