アクセス許可のリファレンス - Facebookログイン

アクセス許可ごとに要件と使用法は異なります。要件と使用法は、Facebookのプラットフォームポリシーと貴社独自のプライバシーポリシーにより定められています。デフォルトの公開プロフィールフィールドを除くすべてのアクセス許可では、あなたのアプリでFacebookログインクライアントOAuthログインが有効であることを求めます。これは利用者やページがあなたのアプリにこれらのアクセス許可を付与できるようにするためです。

Instagramプラットフォーム

ライブ動画API

Messengerプラットフォーム

ページとビジネスアセット

ユーザーデータ

InstagramグラフAPI

instagram_basic

アクセス許可のあるInstagramアカウントを読み取ることができるようになります。詳しくは、Instagramのスタートガイドをご覧ください。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

Instagram Businessアカウントの基本のメタデータを取得します。

instagram_manage_comments

アクセス許可のあるInstagramアカウントを読み取ることができるようになります。詳しくは、Instagramのスタートガイドをご覧ください。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

Instagram Businessアカウントのコメントを読み取る、アップデートする、削除する。

Instagram Businessアカウントのストーリーなどのメディアオブジェクトを読み取る。

instagram_manage_insights

アクセス許可のあるInstagramアカウントのインサイトを読み取ることができるようになります。詳しくは、Instagramのスタートガイドをご覧ください。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

Instagram Businessアカウントのメタデータを取得します。

Instagram Businessアカウントのデータインサイトを取得します。

Instagram Businessアカウントのストーリーインサイトを取得します。

ライブ動画API

publish_video

アプリレビューが必要。

ライブ動画を利用者のタイムラインに公開するためのアクセス許可をアプリに付与します。

許可されている使用方法

ライブ動画を利用者のタイムラインにストリーミングする。

許可されていない使用方法

Facebookのコンテンツポリシーを満たしていない広告またはコンテンツをストリーミングする。

Messengerプラットフォーム

pages_messaging (送信/受信API)

Facebookページを通じたメッセージの送信および受信が可能になります。このアクセス許可を宣伝コンテンツや広告コンテンツの送信に使うことはできません。このAPIによる会話は利用者が相手からのメッセージを受け取ることを意図した(Messengerプラグインや直接メッセージを通じて)場合にのみ開始できます。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

利用者のやり取りの作成

予約、決済、注文などの確認

顧客へのサポートメッセージの送信

製品やサービスのアップセールやクロスセール

ブランド広告、ニュースレター、告知、スパムの送信

同意のいらないメッセージの送信

pages_messaging_subscriptions

アプリレビューが必要。

利用者と初めてやり取りしたあとはいつでも、Facebookページを使用してメッセージを送信するアプリにアクセス許可を与えることができます。アプリから広告または宣伝のためのコンテンツを送信する場合は、広告メッセージを使用する必要があります。また、利用者とのやり取りから24時間以内に送信する必要があります。

許可されている使用方法

Messengerを使用している人に、サブスクリプションメッセージを送信します。

ページとビジネスアセット

ads_management

所有する広告アカウント、またはこのアクセス許可を介して広告アカウントの所有者からアクセス権限を付与された広告アカウントの広告に対して読み取りと管理の両方を行えるようにします。

デフォルトでは、開発者モードでアプリがアクセスできるのは、アプリの管理者が所有する広告アカウントのみです。

使用方法


許可されている使用方法

プログラミングにより、キャンペーンの作成、広告の管理、指標の取得を行う。

広告主に革新的なソリューションや独自の価値を提供する広告管理ツールを作成する。

許可されていない使用方法

Facebookの配信エンジンのしくみをリバースエンジニアリングしてはなりません。

広告の配信機会を増やすために同じ広告の複製を過度に作成しようとしてはなりません。

ads_read

所有する広告アカウント、またはこのアクセス許可を介して広告アカウントの所有者からアクセス権限を付与された広告アカウントの広告レポート情報を取り出すための広告インサイトAPIにアクセスできるようにします。

このアクセス許可が付与されても、購入の更新、広告の更新や変更を行うことはできません。

使用方法


許可されている使用方法

カスタムダッシュボードやデータアナリティクスで使用するために広告パフォーマンスデータにAPIを使用してアクセスできるようにする。

許可されていない使用方法

個人を特定し、その個人を特定の広告のターゲットにしてはなりません。

共通の製品を扱う他のビジネスとターゲットを共有しないでください。

共通の製品を扱う他のビジネスとインサイトを共有しないでください。

business_management

Business Management APIを使用して読み取りと書き込みを実行する

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

広告アカウントなどのビジネスアセットを管理する。広告アカウントを取得します。

一般的なページの管理のみを実行する。

leads_retrieval

Requires App Review.

Grants your app permission to retrieve all the information captured within a lead.

Allowed Usage

Leads are generally submitted by users in response to specific kinds of CTA (Sign ups, Get Quotes, etc.) shown on the ad. The information within the lead is used to reach out to the users to follow up on those CTA. For example, a dealer reaches out to a potential customer (lead) with quotes for a car.

By advertiser authorized CRM platforms to pull the lead data on behalf of the advertisers. The advertisers then use the lead information to reach out to the user.

Disallowed Usage

Share the lead data with anyone outside of the advertiser who ran the ads for capturing the leads.

Store additional information of the user outside of what was submitted on the lead form.

manage_pages

利用者が管理するページやアプリのページアクセストークンをアプリが取得できるようにします。

ページとして公開するには、manage_pagespublish_pagesの両方がアプリには必要です。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。Facebookによるレビューを受けることなく、アプリダッシュボードの[役割]セクションに一覧表示されている利用者の代わりに、このアクセス許可を付与できます。

レビュー用に申請する場合、Facebookのレビューチームが手順を簡単に再現できるようにしてください。たとえば、ページ管理ツールで独自の認証システムが使用されている場合、有効なログイン情報(ユーザーネームやパスワードなど)を提供し、レビューチームがツールを使用してこの機能をテストできるようにしてください。

一般的な使用方法

アプリの利用者が所有するページでコンテンツを公開する。公開する場合、publish_pagesアクセス許可も必要です。

利用者のページに公開された投稿やコメント、「いいね!」を、利用者が管理するのを支援する。

pages_manage_cta

アプリレビューが必要。

ページのコールトゥアクションボタンを管理するために使用されるエンドポイントで、POSTDELETEの操作を実行できるようにします。

許可されている使用方法

管理しているページのコールトゥアクションを管理するAPIアクセスを提供します。

pages_manage_instant_articles

アプリの利用者が管理するFacebookページに代わって、アプリでインスタント記事を管理できます。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。Facebookによるレビューを受けることなく、アプリのダッシュボードの[役割]セクションに一覧表示されている利用者の代わりに、このアクセス許可を付与できます。

WordPress (または類似のツール)用インスタント記事プラグインを使用してブログ投稿をFacebookページに公開する場合、公開を委託するすべての人がアプリのダッシュボードの[役割]セクションに一覧表示されていれば、アプリをレビュー用に申請する必要はありません。

レビュー用に申請する場合、Facebookのレビューチームが手順を簡単に再現できるようにしてください。たとえば、アプリで独自の認証システムが使用されている場合、有効なログイン情報(ユーザーネームやパスワードなど)を提供し、レビューチームがツールを使用してこの機能をテストできるようにしてください。

一般的な使用方法

アプリの利用者が所有するページのインスタント記事を作成、更新する。

pages_show_list

管理しているページのリストの表示機能にアクセスできるようにします。

一般的な使用方法

管理しているページのリストを表示するために、アカウントへのAPIアクセスを実現する。

publish_pages

manage_pagesアクセス許可も付与されている場合、アプリの利用者が管理するあらゆるページとして、アプリは投稿やコメント、「いいね!」を公開できます。

ページとして公開するには、manage_pagespublish_pagesの両方がアプリには必要です。

このアクセス許可が付与されても、個別の個人アカウントとして公開することはできません。

審査

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

このアクセス許可のリクエストをアプリレビューの対象にする場合、Facebookのレビューチームが手順を簡単に再現できるようにしてください。

一般的な使用方法

カスタム投稿ツールを通じて、利用者が管理するあらゆるFacebookページに、利用者がアプリから明示的にコンテンツを公開できるようにする。

利用者が管理するページに代わり、「いいね!」やコメントをシームレスに公開する。

利用者に認識されることも制御されることもなく、自動的に記事を公開する。

利用者が作成していないコンテンツを使用して、投稿のメッセージパラメーターを事前入力する。これは、コンテンツがシェアされる前に、利用者が編集したり削除したりできる場合であっても同様です。

read_audience_network_insights

利用者が所有しているアプリ用のAudience Networkインサイトデータに読み取り専用アクセスできるようにします。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

FacebookのアプリAudience Networkインサイトを独自のアナリティクスツールに統合する。

インサイトデータを第三者に転送したり販売したりする。

インサイトを非表示形式で使用できるようにする。

read_insights

利用者が所有しているページやアプリ、ウェブドメインのインサイトデータに読み取り専用アクセスできるようにします。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

Facebookのアプリやページ、ドメインのインサイトを独自のアナリティクスツールに統合する。

インサイトデータを第三者に転送したり販売したりする。

インサイトを非表示形式で使用できるようにする。

read_page_mailboxes

利用者が管理しているページのページ受信箱から読み取りを行えるようにします。このアクセス許可は、多くの場合、manage_pagesアクセス許可と一緒に使用されます。

このアクセス許可を付与されても、アプリはページ所有者の受信箱を読み取ることはできません。ページの受信箱に対してのみ適用されます。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

利用者がアプリを使用して、ページの受信箱を管理できるようにする。

ユーザーデータ

デフォルトフィールド

デフォルトフィールドは、利用者の公開プロフィールの部分のサブセットです。これらのフィールドは、Userオブジェクトにある次のプロパティです。

  • id
  • first_name
  • last_name
  • middle_name
  • name
  • name_format
  • picture
  • short_name

ベストプラクティスはpublic_profileを使用してデフォルトフィールドを宣言することですが、ウェブではリクエストごとに暗黙的に示されているため、宣言する必要はありません。 iOSやAndroidではログインフローの一環として、public_profileを用いて、手動でこれらのフィールドをリクエストする必要があります。

idフィールドはapp-scoped IDです。

レビュー

これらのフィールドは、Facebookのレビューを受けることなくアプリで使用できます。

email

userオブジェクトのemailプロパティを介して、利用者のプライマリメールアドレスにアクセスできるようにします。

利用者にスパムを送らないでください。 メールを使用する際には、Facebookのポリシースパム規制法(CAN-SPAM Act)の両方に準拠している必要があります。

注: emailアクセス許可をリクエストしても、メールアドレスを取得できるとは限りません。たとえば、利用者がメールアドレスの代わりに電話番号を使用してFacebookにサインアップしている場合、メールフィールドは空になっていることがあります。

レビュー

このアクセス許可は、Facebookのレビューを受けることなくアプリで使用できます。

groups_access_member_info

公開されているグループメンバー情報がAPIの応答に含まれるようにアプリを設定できます。含まれるのは、自身の情報をグループアプリと共有することを選択したグループメンバーのデフォルトのUserフィールドのみです。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

このアクセス許可のリクエストをアプリレビューの対象にする場合、Facebookのレビューチームが手順を簡単に再現できるようにしてください。

一般的な使用方法

アプリに、グループに投稿された、利用者の詳細情報を含むコンテンツの取得を許可する。

グループで実行されたアクティビティに関する集計インサイトを、管理者が取得するのを支援する。

管理する複数のビジネスでデータを共有する。

サードパーティから取得したデータを転送または販売する。

ユーザープロフィールを構築または増分する。

行動でリターゲティングする。

利用者のエンゲージメントをグループ全体にマッピングする。

publish_to_groups

アプリにこのアクセス許可を付与したユーザーに代わって、アプリがグループにコンテンツを投稿することを許可する。

審査

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

このアクセス許可のリクエストをアプリレビューの対象にする場合、Facebookのレビューチームが手順を簡単に再現できるようにしてください。

一般的な使用方法

利用者がアプリからFacebookグループにコンテンツを公開するのを許可する。

利用者がグループに公開されたコンテンツを管理するのを支援する。

利用者に認識されることも制御されることもなく、自動的にコンテンツを公開する。

user_age_range

利用者の年齢層にアクセスできるようにします。

審査

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについて審査します。

一般的な使用方法

アプリに、ギャンブル、ゲーム、アルコール関連など、法的に年齢制限が必要なコンテンツが含まれている。

アプリに、出会い関連、成人向け、過激または暴力的なコンテンツなど、一般的なFacebookのターゲット層には適していないコンテンツが含まれている。

アプリに、子供や青少年を対象としたコンテンツが含まれている。

年齢層に基づいて、ユーザー体験に目に見える影響が出ることはありません。

user_birthday

利用者の誕生日の月と日の情報にアクセスできるようにします。この情報に利用者の誕生年情報が含まれるかどうかは、利用者のプライバシー設定やこのフィールドをクエリするために使用されているアクセストークンによって決まります。

多くの統合に必要なのはage_rangeのみです。

審査

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

レビュー用に申請する場合、アプリの実行環境においてage_rangeでは十分でない理由を明確に示してください。

一般的な使用方法

誕生日情報に基づいて、年齢に関連するコンテンツを利用者に提供する。

利用者の年齢層が満たない場合に、年齢に関連するコンテンツを提供する。

利用者の自称年齢が「18歳未満」、「18歳以上」、または「21歳以上」のいずれであるかを確認する。代わりにage_rangeを使用してください。

user_events

アプリレビューが必要。

利用者が主催するか出欠確認の回答をしたイベントに読み取り専用アクセスできる許可をアプリに付与します。このアクセス許可は一連のパートナーに制限されており、使用する場合は事前にFacebookによる承認を得る必要があります。

許可されている使用方法

カレンダーやイベント情報(デバイスアプリ、予定表アプリ、コンサートアプリなど)を見やすくする。

許可されていない使用方法

イベントを作成する。

アプリを使用してイベントの出欠を返信できるようにする。

user_friends

利用者と同じくアプリを使用している友達のリストにアクセスできるようにします。これらの友達は、利用者オブジェクトの友達エッジで見つかります。このアクセス許可は一連のパートナーに制限されており、使用する場合は事前にFacebookによる承認を得る必要があります。

利用者の友達リストに別の利用者を表示するには、両方の利用者が、アプリで友達のリストをシェアすることに同意しており、ログイン時にそのアクセス許可を無効にしていない必要があります。 また、ログインプロセスで両方の友達にuser_friendsの付与をリクエストする必要があります。

審査

これらのアクセス許可をリクエストするには、アプリのログインレビューを申請する必要があります。

一般的な使用方法

友達のリストを使用して、アプリ内でソーシャルな機能を生む。

user_gender

利用者の性別にアクセスできるようにします。

審査

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについて審査します。

一般的な使用方法

ボットが利用者にメッセージを送るときなど、特定の言語で代名詞を正しく表示するために、アプリが性別を必要とする。

ショッピングやファッションなど、性別に基づいてアプリをパーソナライズする。

出会い関連など、利用者の性別を他の人に表示する。

性別に基づいて、ユーザー体験に目に見える影響が出ることはありません。

登録フォームまたはユーザープロフィールの入力時にこの情報を使用せずに、ユーザー体験を強化します。

user_hometown

ユーザーオブジェクトhometownフィールドを通して、利用者の出身地の情報にアクセスできるようにします。この情報は、利用者がプロフィールに設定します。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

利用者が住んでいる場所または育った場所に基づいて、利用者向けにサービスをパーソナライズする。

利用者が同郷の他の利用者とつながるのを支援する。

user_likes

利用者が「いいね!」したすべてのFacebookページとOpen Graphオブジェクトのリストにアクセスできるようにします。このリストは、ユーザーオブジェクトいいね!エッジを通して利用できます。このアクセス許可は一連のパートナーに制限されており、使用する場合は事前にFacebookによる承認を得る必要があります。

審査

これらのアクセス許可をリクエストするには、アプリのログインレビューを申請する必要があります。

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについて審査します。

一般的な使用方法

利用者のアクティビティに関連するコンテンツを提示することによって、パーソナライズされたサービスを作成する。

共通の趣味・関心のある他の利用者と視覚的につながることができるようにする。

利用者がページを「いいね!」したかどうかに基づいて、アプリまたはアプリ内の一部のコンテンツへのアクセスを制限する。

アプリの他の利用者に、FacebookプロフィールのURLへのアクセスを提供します。

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについて審査します。

出会い関連またはローカルリスティングなど、アプリを使用している人に、アプリを使用しているほかの人のFacebookプロフィールにアクセスする方法を提供する。

その人のFacebookユーザーネームまたは正式なユーザーIDをプログラムで判断しようとします。

user_location

ユーザーオブジェクトlocationフィールドを通して、利用者の居住地の情報にアクセスできるようにします。居住地の情報は、利用者がプロフィールに設定します。

居住地が利用者の出身地であるとは限りません。

レビュー

アプリでこのアクセス許可をリクエストする場合、Facebookは、アプリがこの許可をどのように使用するかについてレビューします。

一般的な使用方法

利用者の居住地の情報に基づいて、利用者向けにサービスをパーソナライズする。

利用者の都市に関連するコンテンツを提示する。

利用者の都市出身の他の利用者とつながるのを支援する。

user_photos

利用者がアップロードしたりタグ付けされたりしている写真にアクセスできるようにします。これは、ユーザーオブジェクト写真エッジを通して利用できます。このアクセス許可は一連のパートナーに制限されており、使用する場合は事前にFacebookによる承認を得る必要があります。

審査

これらのアクセス許可をリクエストするには、アプリのログインレビューを申請する必要があります。

一般的な使用方法

利用者の写真をデジタル写真フレームで表示する。

利用者が自分の写真を印刷用にエクスポートするのを支援する。 このサービスは、利用者の個人使用および非商用利用に対してのみ提供されます。

アプリのサービスを視覚的に向上させることを目的として使用する写真にアクセスする(写真編集、コラージュ、スライドショー、加工アプリなど)。

利用者の以前のプロフィール写真にアクセスする。

利用者に代わってアルバムを作成する。

user_posts

利用者のタイムラインの投稿にアクセスできるようにします。対象になる投稿には、利用者自身の投稿や利用者がタグ付けされている投稿、他の利用者がタイムラインで行った投稿が含まれます。このアクセス許可は一連のパートナーに制限されており、使用する場合は事前にFacebookによる承認を得る必要があります。

審査

これらのアクセス許可をリクエストするには、アプリのログインレビューを申請する必要があります。

一般的な使用方法

タイムラインの投稿から創造的なコンテンツを提供する。

利用者のタイムラインの投稿のコンテンツを視覚的に分析することによって、利用者に価値を提供する。

感情分析やスパムボットに対する保護など、このデータを目に見えない形式で使用する。

user_tagged_places

写真や動画、近況、リンクで利用者がタグ付けされているスポットにアクセスできるようにします。このアクセス許可は一連のパートナーに制限されており、使用する場合は事前にFacebookによる承認を得る必要があります。

審査

これらのアクセス許可をリクエストするには、アプリのログインレビューを申請する必要があります。

一般的な使用方法

利用者が住んでいたり訪れたりした場所に基づいて、カスタマイズされたコンテンツを提供する。

利用者が以前にタグ付けされた場所に基づいて、おすすめのスポットを紹介する。

地図上に利用者のチェックイン履歴を表示する。

user_videos

利用者がアップロードしたりタグ付けされたりしている動画にアクセスできるようにします。このアクセス許可は一連のパートナーに制限されており、使用する場合は事前にFacebookによる承認を得る必要があります。

審査

これらのアクセス許可をリクエストするには、アプリのログインレビューを申請する必要があります。

一般的な使用方法

アプリのサービスを視覚的に向上させることを目的として使用する動画にアクセスできるようにする(編集、コラージュ、ポートフォリオ、スライドショーの各アプリなど)。

セットトップボックスを介して利用者の動画をテレビで表示したり、利用者の動画をデジタル写真フレームで表示したりする。