페이지

비즈니스는 비즈니스에 속한 페이지의 소유권을 요청할 수 있습니다. 이렇게 하면 관리자가 사용자가 액세스해야 할 페이지에 사용자를 간편하게 할당할 수 있습니다.

페이지 소유권 요청

비즈니스는 자신에게 속한 페이지의 소유권을 요청할 수 있습니다. 그러면 액세스 권한이 부여되었던 에이전시나 다른 비즈니스를 제거하는 등의 작업을 비롯하여 페이지의 모든 면을 관리할 수 있습니다. 또는 비즈니스는 페이지에 대한 에이전시 액세스 권한을 요청할 수도 있습니다. 그러면 액세스 권한이 있는 광고 계정을 통해 페이지에 광고를 게재할 수 있게 됩니다.

소유자 자격으로 페이지 소유권 요청

OWNER로서 비즈니스를 위해 페이지 소유권을 요청하려면 페이지 ID와 비즈니스 ID가 필요합니다. 그런 다음 POST 요청을 보내세요.

요청자는 다음을 준비해야 합니다.

  • 페이지에 대한 관리자 권한
  • 소유하는 비즈니스에 대한 권한이 있거나, 소유하는 비즈니스의 소유자가 요청을 승인해야 함

이 요청을 보내려면 비즈니스의 관리자 사용자 또는 관리자 시스템 사용자의 액세스 토큰을 사용해야 합니다. 호출을 한 사용자가 7일이 넘는 기간 동안 페이지의 관리자 또는 MANAGER 역할을 보유한 경우 비즈니스가 즉시 해당 페이지를 소유하게 됩니다. Facebook이 응답에서 access_statusCONFIRMED로 설정하여 반환합니다. 페이지의 관리자 또는 MANAGER 역할을 보유한 기간이 7일 이하인 경우 API 요청이 자동으로 승인되지 않습니다.

OWNER 소유권 요청 호출을 보낸 사용자에게 페이지에 대한 적절한 권한이 없으면 호출에 실패합니다. 광고 계정 소유권 요청과 달리 페이지 관리자에게 아무런 승인 요청도 전송되지 않습니다.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

에이전시 자격으로 페이지 소유권 요청

AGENCY로서 비즈니스를 위해 페이지 소유권을 요청하려면 페이지 ID가 필요합니다. 그런 다음 POST 요청을 보내세요.

요청자가 페이지에 대해 관리자 권한이 있는 경우, 이 요청은 자동으로 승인됩니다. 그렇지 않을 경우, 페이지 관리자가 요청을 승인해야 합니다.

에이전시는 페이지를 다른 비즈니스에 다시 공유할 수 없습니다.

에이전시는 (액세스 권한이 있는 광고 계정을 통해) 페이지에서 바로 광고를 게재할 수 있습니다.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

AGENCY를 사용하는 경우:

  • permitted_tasks를 제공해야 합니다.
  • 비즈니스가 페이지를 소유해야 합니다.
  • 액세스 토큰은 pages_manage_metadatapages_show_list 권한이 있어야 합니다.

AGENCY 소유권 요청 호출을 보냈지만 적절한 페이지 권한이 없는 경우 응답은 PENDING입니다. 해당 페이지의 관리자는 로그인하여 액세스 권한을 부여하거나, 요청을 거부하거나, 해당 요청을 스팸으로 신고할 수 있습니다. 비즈니스에 스팸으로 신고된 페이지 액세스 요청이 너무 많으면 비즈니스 관리자가 잠깁니다.

액세스 권한을 요청했지만 승인 대기 중인 모든 클라이언트 페이지를 보려면 다음 GET 호출을 보내세요. 관리자 시스템 사용자에 대한 액세스 토큰이 필요합니다.

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

비즈니스가 소유한 페이지 또는 비즈니스의 클라이언트에 속한 페이지 보기

비즈니스가 소유한 모든 페이지를 조회하려면 다음 GET 호출을 사용하세요.

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

비즈니스가 에이전시로 있는 모든 페이지를 조회하려면 다음 GET 호출을 사용하세요.

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

이렇게 하면 비즈니스 관리자의 클라이언트에 속한 페이지의 리스트가 반환됩니다.

페이지 일괄 추가

비즈니스 관리자 UI를 사용하여 비즈니스 관리자에 단일 페이지를 추가할 수 있습니다. 비즈니스 관리자에 페이지를 일괄 추가하려면 다음 POST 호출을 보내세요.

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

여기에서:

  • <ACCESS_TOKEN>business_management 권한이 있는 액세스 토큰입니다.
  • <BUSINESS_ID>는 페이지의 소유권을 요청해야 하는 비즈니스 관리자의 ID입니다.
  • <PAGE_ID_n>은 소유권을 요청할 페이지의 ID입니다.

페이지 삭제하기

비즈니스에서 페이지를 삭제하려면 다음 DELETE 호출을 보내세요.

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

페이지에 사용자 추가

비즈니스에 페이지를 추가한 후에는 사용자에게 페이지에 대한 작업을 할당할 수 있습니다. 여기에는 다음과 같은 작업이 포함됩니다.

이름 API 상수 설명

관리자

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

관리자 역할을 관리하고, 메시지를 보내고, 페이지 이름으로 게시물을 올리고, 광고를 만들고, 보고서를 조회할 수 있습니다.

편집자

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

페이지를 편집하고, 메시지를 보내고, 페이지 이름으로 게시물을 올리고, 광고를 만들고, 보고서를 조회할 수 있습니다.

댓글 관리자

['MODERATE', 'ADVERTISE', 'ANALYZE']

페이지의 댓글에 답글을 남기고, 댓글을 삭제하고, 페이지 이름으로 메시지를 보내고, 광고를 만들고, 보고서를 조회할 수 있습니다.

광고주

['ADVERTISE', 'ANALYZE']

페이지의 광고를 만들고 인사이트를 조회할 수 있습니다.

분석가

['ANALYZE']

보고서를 조회할 수 있습니다.

다음 항목이 필요합니다.

  • page_id — 페이지 ID
  • user_id — 추가할 사용자 ID
  • 할당할 작업

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE'] 작업 권한이 있는 다른 사용자를 추가하려면 다음 POST 호출을 보내세요.

비즈니스 ID는 페이지를 소유하는 비즈니스의 ID여야 합니다.

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

페이지 액세스 권한 변경

작업 권한이 있는 새로운 사용자를 추가하는 경우와 동일한 POST 호출을 사용하여 기존 사용자 작업을 변경할 수 있습니다.

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

페이지 권한 조회

사용자 권한이 있는 페이지를 보려면 다음 GET 호출을 보내세요.

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

페이지에 대한 특정 권한을 보려면 다음 GET 호출을 보내세요.

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

페이지 액세스 권한 삭제

비즈니스 관리자에서 페이지를 삭제하려면 먼저 해당 페이지의 관리자를 비즈니스에서 삭제해야 합니다.

소유한 페이지에서 다른 사람의 액세스 권한을 삭제하려면 다음 항목이 필요합니다.

  • page_id — 페이지 ID
  • user_id — 삭제할 사용자의 ID

DELETE 호출은 다음과 같습니다.

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"