ページ

ビジネスは、所有しているページを取得できます。これにより管理者は、アクセス権を所有する必要のあるページに利用者を簡単に割り当てることができます。

ページを取得する

ビジネスは所有するページの所有権を主張することができ、アクセス権が与えられている代理店やその他のビジネスを削除するなど、ページのあらゆる面を管理することができます。または、代理店によるページへのアクセスをリクエストすることもできます。これにより、アクセス権を持つ広告アカウントを通じてページに広告を掲載することができます。

ページを所有者として取得する

OWNERとしてビジネスのページを取得するには、ページIDとビジネスIDが必要です。その上で、POSTリクエストを送信します。

リクエストする側には、次のものが必要です。

• ページへの管理者アクセス許可
• 所有側ビジネスへのアクセス許可(または所有側ビジネスの所有者がリクエストを承認)

このリクエストを発行するには、ビジネスの管理者ユーザーまたは管理者システムユーザーのアクセストークンを使用する必要があります。呼び出しを実行するユーザーが、7日を超える期間にわたってページのページ管理者またはMANAGERである場合、ビジネスは直ちにページを所有します。Facebookから返される応答では、access_statusがCONFIRMEDに設定されます。ページのページ管理者または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_metadataとpages_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"

ページに利用者を追加する

ビジネスにページが追加されたら、そのページに対するタスクを利用者に割り当てることができます。次のようなタスクがあります。

以下が必要です。

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