자산 관리 개요

비즈니스는 여러 자산에 액세스할 수 있습니다. 비즈니스는 자산을 소유하거나 대행사로서 자산에 액세스합니다. Facebook의 Business Management Asset API를 사용하면 비즈니스와 자산 사이에 관계를 추가, 삭제 또는 쿼리할 수 있으며 비즈니스 자산을 관리하고 자산에 액세스할 수 있습니다.

대행사는 다른 비즈니스가 소유한 자산을 관리하거나 이에 액세스할 수 있는 비즈니스 유형을 의미합니다. 이 관계를 통해 대행사는 고객을 대신해 특정한 작업이나 행동을 수행할 수 있습니다(예: 광고 계정, 페이지 또는 기타 디지털 자산 관리).

비즈니스 자산 그룹

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

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

이 API를 사용하여 비즈니스 자산 그룹에 사용자를 추가할 수 있습니다. 사용자를 추가한 후에는 이들 사용자에게 비즈니스 자산 그룹에 속한 자산에 대한 권한을 부여할 수 있습니다. 이렇게 하면 비즈니스 수준에서 지나치게 많은 관리자를 만들지 않고 여러 자산에 대한 액세스 권한을 한 번에 부여하는 데 도움이 됩니다.

이 API를 사용하면 누군가 이미 비즈니스 관리자를 통해 만든 비즈니스 자산 그룹을 관리하거나 비즈니스 자산 그룹 내의 자산을 관리할 수 있습니다. 다음과 같은 작업을 수행할 수 있습니다.

비즈니스와 연결된 비즈니스 자산 그룹의 리스트 가져오기
비즈니스 자산 그룹 삭제 또는 이름 변경
비즈니스 자산 그룹에 있는 모든 자산 보기
비즈니스 자산 그룹에 있는 자산에 대한 사용자 권한 가져오기, 추가, 수정 및 삭제
사용자를 비즈니스 자산 그룹에 할당
비즈니스 자산 그룹에서 자산 가져오기, 추가 및 삭제

권한

비즈니스 자산 그룹 API를 사용하려면 앱에 적절한 마케팅 API 액세스 수준이 필요합니다.

모든 추가 및 삭제 엔드포인트의 경우: 액세스 토큰의 사용자가 비즈니스의 관리자여야 합니다. 그러지 않으면 액세스가 거부됩니다.
모든 API 엔드포인트에 대해 앱에 business_management 권한이 필요합니다.

다음에 대한 추가 권한이 필요합니다.

비즈니스 자산 그룹 엔드포인트	필요한 권한
광고 계정의 리스트 가져오기	`ads_management`
제품 카탈로그 리스트를 가져오거나, 제품 카탈로그를 추가하거나 삭제	`ads_management`
Instagram 계정의 리스트를 가져오거나 Instagram 계정을 추가하거나 삭제	`ads_management`. 마케팅 API v4.0을 사용 중인 경우 `instagram_basic`도 필요합니다.
픽셀 리스트 가져오기	`ads_read`
오프라인 이벤트 세트의 리스트 가져오기	`ads_management`
맞춤 전환의 리스트 가져오기	`ads_read`
맞춤 전환 추가	`ads_management`

제한 사항

다음 API를 호출하여 비즈니스 자산 그룹에 포함된 자산에 대한 권한을 낮추거나 삭제하려고 하면 오류가 발생합니다.

/{page_id}/assigned_users에 대한 DELETE 요청
/{page_id}/assigned_users에 대한 POST 요청
/act_{ad_account_id}/assigned_users에 대한 DELETE 요청
/act_{ad_account_id}/assigned_users에 대한 POST 요청

권한을 줄이거나 삭제하려면 다음 단계를 따르세요.

비즈니스와 연결된 자산 그룹의 리스트를 가져오기 위한 호출을 보냅니다. contained_asset_id가 {page_id} 또는 {ad_account_id}와 동일한 자산 그룹을 찾습니다.
각각의 반환된 비즈니스 자산 그룹 ID에 대해 해당 그룹에서 사용자를 삭제하기 위한 API 호출을 보냅니다.
그런 다음 위의 DELETE 또는 POST 요청을 보내어 페이지 또는 광고 계정에서 해당 사용자에 대한 권한을 삭제합니다.

다른 비즈니스에 내 앱의 권한 관리 기능을 제공하는 경우 이 API를 사용하여 API와 비즈니스 관리자 사이의 비일관성과 오류를 방지해야 합니다.

비즈니스 자산 그룹을 통해 앱, 카탈로그, Instagram 계정 및 맞춤 전환에 대한 권한을 설정할 수 없습니다. 대신 자산 수준에서 권한을 할당해야 합니다.

예를 들어 Jasper의 비즈니스 관리자에서 Roger를 비즈니스 자산 그룹에 추가하는 경우 Roger는 해당 비즈니스 자산 그룹에서 페이지, 광고 계정, 픽셀 등에 대한 권한을 얻을 수 있습니다. 그러나 Jasper의 비즈니스 자산 그룹에서 자산에 대한 Roger의 권한을 삭제하거나 수정하려면 비즈니스 자산 그룹 자체에서 이 작업을 수행해야 합니다.

자산 API를 사용하여 자산 수준에서 사용자 권한을 추가할 수 있습니다(예: 누군가를 페이지 중재자에서 관리자로 변경). 페이지 및 광고 계정에 대한 예시를 참조하세요.

2019년 10월 13일에 비즈니스 자산 그룹이 프로젝트 API를 대체했습니다. 프로젝트 API에 있는 모든 앱을 비즈니스 자산 그룹으로 마이그레이션해야 합니다.

허용된 역할

사용자가 비즈니스에 추가되면 비즈니스 사용자 API를 통해 다음 두 가지 역할 중 하나를 할당할 수 있습니다.

API 상수	이름	설명
`ADMIN`	비즈니스 관리자	계정 수정 또는 삭제, 사람 추가 또는 삭제 등 비즈니스 설정의 모든 측면을 관리할 수 있습니다.
`EMPLOYEE`	비즈니스 직원	비즈니스 설정의 모든 정보를 보고 자신이 관리자인 페이지나 광고 계정을 비즈니스에 추가할 수 있지만 그 외에 다른 항목에 대한 변경 권한은 없습니다.

카탈로그

다음 역할은 이 비즈니스가 카탈로그 API를 사용하여 액세스할 수 있는 카탈로그에서 비즈니스 관리자 또는 직원 사용자 중 누구에게나 할당할 수 있습니다.

API 상수	이름	설명
`['MANAGE', 'ADVERTISE']`	카탈로그 관리자	전체 읽기 및 쓰기 액세스 권한으로 품목의 생성/업데이트/삭제, 피드 관리, 픽셀 및 앱에 카탈로그 첨부, 제품 세트 생성, 카탈로그가 포함된 어드밴티지+ 카탈로그 광고 실행, 카탈로그 설정 변경 등을 포함해 카탈로그의 모든 측면을 관리할 수 있습니다.
`['ADVERTISE']`	카탈로그 광고주	제품 세트를 만들고 카탈로그가 포함된 어드밴티지+ 광고를 실행할 수 있습니다. 제품, 피드 또는 카탈로그 설정을 편집할 수 없습니다.

광고 계정

다음 작업은 이 비즈니스가 광고 계정 API를 사용하여 액세스할 수 있는 광고 계정에 대해 비즈니스 사용자 중 누구에게나 할당할 수 있습니다.

API 상수	이름	설명
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	광고 계정 관리자	캠페인의 모든 측면과 보고, 청구 및 계정 권한을 관리할 수 있으며 광고 계정의 지출 한도를 설정할 수 있습니다. 광고 계정 관리자는 또한 비즈니스 결제 수단을 연결할 수도 있습니다.
`['ADVERTISE', 'ANALYZE']`	광고 계정의 광고주	광고를 보고 수정하며 해당 광고 계정에 연결된 결제 수단을 사용하여 광고를 설정할 수 있습니다.
`['ANALYZE']`	광고 계정 분석자	광고 성과를 확인할 수 있습니다.

페이지

다음 작업은 이 비즈니스가 페이지 API를 사용하여 액세스할 수 있는 페이지에서 비즈니스 사용자 중 누구에게나 할당할 수 있습니다.

API 상수	이름	설명
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	페이지 관리자	페이지 역할을 관리하고, 메시지를 보내고, 페이지 이름으로 게시물을 올리고, 광고를 만들고, 인사이트를 조회할 수 있습니다.
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	페이지 편집자	페이지를 편집하고, 메시지를 보내고, 페이지 이름으로 게시물을 올리고, 광고를 만들고 인사이트를 조회할 수 있습니다.
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	페이지 중재자	페이지의 댓글에 답글을 남기고, 댓글을 삭제하고, 페이지 이름으로 메시지를 보내고, 광고를 만들고, 인사이트를 조회할 수 있습니다. 페이지 이름으로 게시물을 올릴 수 없습니다.
`['ADVERTISE', 'ANALYZE']`	페이지 광고주	페이지 광고를 만들고 인사이트를 조회할 수 있습니다. 페이지 이름으로 게시물을 올릴 수 없습니다.
`['ANALYZE']`	페이지 분석자	인사이트를 조회할 수 있습니다. 페이지 이름으로 게시물을 올릴 수 없습니다.

앱

비즈니스 관리자에는 앱을 위한 역할 또는 작업 관리 API가 없습니다.

Instagram 계정

비즈니스 관리자에는 Instagram 계정을 위한 역할 관리 기능이 없습니다. Instagram 계정에 연결된 광고 계정에 대한 액세스 권한이 있는 사용자는 해당 Instagram 계정에 대해 광고를 실행할 수 있습니다.