Facebook への接続を追加

Facebook への接続を追加するには：

1. アプリケーションコンソールで、接続ページに移動します。
2. 接続の追加パネルで、追加したい接続のアイコンを選択します。
3. Facebook アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからFacebook コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

Facebook への接続

Facebook に接続する前に、適切な接続プロパティを取得する必要があります。Facebook はOAuth によるユーザー認証のみをサポートしているため、CData が提供する組み込みOAuth アプリケーションを使用するか、カスタムOAuth アプリケーションの作成 で説明するようにカスタムOAuth アプリケーションを作成する必要があります。

さらに、以下のオプションの接続プロパティを設定することもできます。

• Target：このプロパティは、クエリ結果を指定されたターゲットに合致するレコードに限定することを可能にします。 例えば、動画のコメントを取得するには、ターゲットとして動画のID を指定します。クエリ毎にこの制限をかけるには、テーブルのTarget カラムを使用します。
• AggregateFormat：このプロパティは、集計カラムをJSON（デフォルトのフォーマット）ではなく、XML データとして返すことを可能にします。

Facebook への認証

以下のセクションでは、利用可能な任意のOAuth アクセスフローでのFacebook への認証について詳しく説明します。カスタムOAuth アプリケーションの作成については、カスタムOAuth アプリケーションの作成 を参照してください。

Web アプリケーション

Web アプリケーション経由で接続する場合は、カスタムOAuth アプリケーションの作成 で説明するようにFacebook にカスタムOAuth アプリケーションを作成および登録する必要があります。 それからSync App を使用してOAuth トークンの値を取得および管理します。

OAuth アクセストークンの取得

次の接続プロパティを設定し、OAuthAccessToken を取得します。

• OAuthClientId：アプリケーション設定のクライアントId に設定。
• OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
• Scope（オプション）：ドライバーがリクエストするアクセス権をカスタマイズする必要がある場合のみ設定。
• AuthenticateAsPage（オプション）：リクエストをページとして作成するには、ページ名またはページId に設定。ページは認証されたユーザーにより管理されている必要があります。

ストアドプロシージャを呼び出し、OAuth 交換を完了します。

1. GetOAuthAuthorizationURL ストアドプロシージャを呼び出します。AuthMode インプットをWEB に、CallbackURL インプットをアプリケーション設定で指定したリダイレクトURI に設定します。必要に応じて、"Scope" パラメータを設定してカスタム権限をリクエストします。
2. URL を開き、ログインして、アプリケーションを認可します。コールバックURL にリダイレクトされます。
3. GetOAuthAccessToken ストアドプロシージャを呼び出します。AuthMode インプットをWEB に設定します。Verifier インプットを、コールバックURL のクエリ文字列の"code" パラメータに設定します。必要に応じて、"Scope" パラメータを設定してカスタム権限をリクエストします。

OAuthAccessToken 接続プロパティをストアドプロシージャで返されたアクセストークンに設定し、データに接続します。ExpiresIn 秒後に、アクセストークンの期限が切れたときは、GetOAuthAccessToken を呼び出し、新しいアクセストークンを取得します。

ヘッドレスマシン

ヘッドレスマシンのユーザーアカウントでOAuth を使用するようにドライバーを設定するには、インターネットブラウザに対応した別の端末で認証する必要があります。

ヘッドレスOAuth フローでは、カスタムOAuth アプリの作成は任意です。アプリの作成をスキップしたい場合は、ドライバーの埋め込みOAuth クレデンシャルで接続できます。 しかしながら、カスタムOAuth アプリを作成すると、ユーザーがFacebook にログインしてドライバーにアクセス権を与えるときに表示される情報を変更することもできます。カスタムOAuth アプリケーションの作成については、カスタムOAuth アプリケーションの作成 を参照してください。

1. 以下の2つのオプションから選択します。
   • オプション1：後述の「Verifier code を取得および交換」に従い、OAuthVerifier 値を取得します。
   • オプション2：別のマシンにSync App をインストールし、後述の「OAuth 設定を転送」の説明に従い、通常のブラウザベースのフローで認証後にOAuth 認証値を転送します。
2. ヘッドレスマシンからアクセストークンを自動的にリフレッシュするようにSync App を設定します。

オプション1：Verifier code を取得および交換

Verifier code を取得するには、OAuth Authorization URL で認証する必要があります。インターネットブラウザに対応したマシンから認証してOAuthVerifier 接続プロパティを取得する方法は次のとおりです。

1. 埋め込みOAuth アプリケーションを使用する場合：
   1. GetOAuthAuthorizationURL ストアドプロシージャを呼び出します。
   2. Facebook OAuth endpoint をクリックし、ブラウザでエンドポイントを開きます。
2. カスタムOAuth アプリケーションを使用するには、以下のプロパティを設定し、認証URL を作成します。
   • InitiateOAuth：OFF に設定。
   • OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId に設定。
   • OAuthClientSecret：アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
3. CallbackURI 入力パラメータを、アプリケーション設定で指定した正確なリダイレクトURI に設定してGetOAuthAuthorizationURL ストアドプロシージャを呼び出します。
4. ストアドプロシージャによって返されたURL をブラウザで開きます。
5. ログインして、Sync App にアクセス許可を与えます。すると、verifier code を含むコールバックURL にリダイレクトされます。
6. verifier code の値を保存します。後ほどこれをOAuthVerifier 接続プロパティに設定します。

最後に、ヘッドレスマシンで、次の接続プロパティを設定してOAuth 認証値を取得します。

• OAuthClientId：OAuth 統合設定のクライアントID に設定。
• OAuthClientSecret：OAuth 統合設定のクライアントシークレットに設定。
• OAuthVerifier：verifier code に設定。
• OAuthSettingsLocation：暗号化されたOAuth 認証値を指定された場所に永続化。
• InitiateOAuth：REFRESH に設定。

データへの接続

OAuth 設定ファイルが生成されたら、次のプロパティを設定してデータに接続します。

• OAuthSettingsLocation：暗号化されたOAuth 認証値が保存される場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所がプロバイダーに読み書きのアクセス許可を与えることを確認してください。
• InitiateOAuth：REFRESH に設定。

オプション2：OAuth 設定を転送

別のマシンにSync App をインストールするには、認証してから、結果のOAuth 値を転送します。

1. セカンドマシンに、Sync App をインストールして、次の接続プロパティセットで接続します。
   • OAuthSettingsLocation：書き込み可能な場所に設定。
   • OAuthClientId：アプリケーション設定のクライアントID に設定。
   • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
   • CallbackURL：アプリケーション設定のコールバックURL に設定。
2. 認証する接続をテストします。生成された認証値は、OAuthSettingsLocation で指定されたパスに書き込まれて暗号化されます。接続テストに成功したら、OAuth 設定ファイルをヘッドレスマシンにコピーします。ヘッドレスマシンで、次の接続プロパティを設定し、データに接続します。
   • InitiateOAuth：REFRESH に設定。
   • OAuthSettingsLocation：OAuth 設定ファイルの場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所がSync App に読み書きのアクセス許可を与えることを確認してください。

追加認証のリクエスト

Sync App の使用中に、指定のアクションを行う権限がアプリにありませんというエラーメッセージがFacebook から返されることがあります。 このエラーを解消するには、必要な権限を持つ新しいOAuth アクセストークンを発行する必要があります。認証ステップでScope プロパティを設定します。 利用可能なFacebook アクセス許可のリストはこちらで確認できます。

http://developers.facebook.com/docs/authentication/permissions/

ユースケースに応じて必要な許可は次のとおりです。

user_birthday, user_photos, user_videos, user_likes, user_hometown, user_location, read_insights, pages_manage_metadata, pages_read_engagement, pages_read_user_content, pages_messaging, business_management, instagram_basic, instagram_manage_insights

場合によっては、アクセス許可の制限は、リクエスト可能なFacebook OAuth パーミッションが見つからないことが原因ではなく、Page Public Content Access やPage Public Metadata Access のようなOAuth アプリ機能が見つからないことが原因かもしれないことに注意してください。これらの機能はOAuth アプリ全体に紐づいており、ユーザーが要求した個々のOAuth アクセストークンに対して承認や拒否を行うことはできません。埋め込みOAuth アプリでは利用できないアプリ機能へのアクセスが必要な場合は、カスタムOAuth アプリケーションの作成 を検討してください。

AuthenticateAsPage プロパティ

単一ページとして投稿する場合は、AuthenticateAsPage 接続プロパティを使用します。ページのコレクションをクエリする場合は、AuthenticateAsPage を空のままにします。その場合、CData ツールはどのページトークンを使用するかを自動的に検出します。

次のセクションでは、2つのオプションについて比較します。

ページとして投稿

Facebook に認証した後、あなたのユーザーアカウントで管理するページとして投稿をすることができます。AuthenticateAsPage プロパティを使用するページのID に設定します。Pages ビューをクエリして、あなたのアカウントでアクセスすることが可能なすべてのページのID を見ることができます。

自動ページ

Facebook では、ページが所有するほとんどのリソースに対してページトークンを必要とする多くの変更を最近加えました。これは、複数のページを管理していてすべてのページで同じクエリを実行したい場合（例えばInsights を取得する場合など）に面倒です。CData のツールでこれをシームレスに処理するために、使用するページトークンを自動的に検出する方法を追加しました。これを機能させるには、AuthenticateAsPage を指定しないでください。正しいページトークンは、リクエストでターゲットの一部としてページID が指定されている場合にのみ解決できます。つまり、リクエストによっては手動でAuthenticateAsPage を指定する必要があります。

Facebook Insights enables you to search and analyze data about how users are interacting with your Facebook page. Metrics are displayed in read-ony tables called views.

Views are comprised of columns and pseudo-columns. Like tables, they display data in columns and rows, and you can execute a query against a view to refine its results further. (The query will return another read-only table). However, because views are read-only you cannot interact with the data itself unless there is a stored procedure available to modify the data source.

Available views include:

ビュー名	説明
InsightsByConsumptionType	Retrieves insights sorted by how users consumed your content; for example, playing a video, viewing a photo, or clicking a link.
InsightsByFeedbackType	Retrieves insights sorted by feedback type, such as likes or comments.
InsightsByLikeSourceType	Retrieves insights sorted by source type; for example, ads, news feedk or page suggestions.
InsightsByReactionTotals	Shows reactions to your page sorted by type; for exanple, like, love, wow, haha, sorry, or anger.
InsightsByStoryType	Sorts insights by story type, such as user post, page post, checkin, question, or coupon.
InsightsByTabType	Sorts insights by tab type, such as About, Ads, or Album.
InsightsByUnlikeSourceType	Retrieves insights on actions users take to withdraw a previous "like" of your page.
SimpleInsights	Displays simple insights (insights with a single value, given in response to a question) retrieved by your page.
VideoInsightsByActionType	Returns video insights as the total number of likes, comments, or shares of that video. Valid only for the entire lifetime of the video posting.
VideoInsightsByDistributionType	Displays video insights sorted by distribution type, such as owned, shared, or crossposted.
VideoInsightsByReactionType	Retrieves video insights sorted by reaction type, such as like, love, wow, haha, sorty, and anger.

The sole stored procedure available for manipulating any of the above views is CreateInsightSchema.

For details about Facebook views, including some sample queries, see ビュー.

For a breakdown of insight mapping by category, see インサイトマッピングリファレンス.

最近削除されたインサイト

Facebook では利用可能なインサイトが頻繁に変更されるため、次のテーブルで直近で削除または名称変更されたインサイトを要約します。

ビューまたはストアドプロシージャ	インサイト名	使用可能な期間	ターゲットタイプ
PageAndPostInsights	PAGE_VIEWS_UNIQUE	day, week	page
InsightsByPaidStatus	PAGE_STORYTELLERS_BY_STORY_TYPE	day, week, days_28	page
InsightsByPaidStatus	POST_IMPRESSIONS_BY_PAID_NON_PAID	lifetime	page
InsightsByPaidStatus	PAGE_IMPRESSIONS_BY_PAID_NON_PAID	day, week, days_28	page
InsightsByPaidStatus	PAGE_IMPRESSIONS_BY_PAID_NON_PAID_UNIQUE	day, week, days_28	page
InsightsByPaidStatus	POST_IMPRESSIONS_BY_PAID_NON_PAID_UNIQUE	lifetime	page
InsightsByPaidStatus	PAGE_POSTS_IMPRESSIONS_BY_PAID_NON_PAID	day, week, days_28	page
InsightsByPaidStatus	PAGE_POSTS_IMPRESSIONS_BY_PAID_NON_PAID_UNIQUE	day, week, days_28	page

Facebook インサイトで使用可能な期間、使用できるビュー、使用できるターゲットなどのマッピングを以下に示します。

関連項目： The Meta Developers Guide

インサイトのスキーマの作成

次のインサイトはCreateInsightSchema から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_CONTENT_ACTIVITY_BY_AGE_GENDER_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_AGE_GENDER
PAGE_CONTENT_ACTIVITY_BY_CITY_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_CITY
PAGE_CONTENT_ACTIVITY_BY_COUNTRY_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_COUNTRY
PAGE_CONTENT_ACTIVITY_BY_LOCALE_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_LOCALE
PAGE_IMPRESSIONS_BY_CITY_UNIQUE	day, week, days_28	page	-
PAGE_IMPRESSIONS_BY_COUNTRY_UNIQUE	day, week, days_28	page	-
PAGE_IMPRESSIONS_BY_LOCALE_UNIQUE	day, week, days_28	page	-
PAGE_IMPRESSIONS_BY_AGE_GENDER_UNIQUE	day, week, days_28	page	-
PAGE_PLACES_CHECKINS_BY_AGE_GENDER	day	page	-
PAGE_PLACES_CHECKINS_BY_LOCALE	day	page	-
PAGE_PLACES_CHECKINS_BY_COUNTRY	day	page	-
PAGE_FANS_LOCALE	day	page	-
PAGE_FANS_CITY	day	page	-
PAGE_FANS_COUNTRY	day	page	-
PAGE_FANS_GENDER_AGE	day	page	-
PAGE_VIEWS_EXTERNAL_REFERRALS	day	page	-
POST_STORIES_BY_ACTION_TYPE	lifetime	post	-
POST_STORYTELLERS_BY_ACTION_TYPE	lifetime	post	-
PAGE_POSTS_IMPRESSIONS_FREQUENCY_DISTRIBUTION	day, week, days_28	post	-
POST_VIDEO_RETENTION_GRAPH	lifetime	post	-

ページと投稿のインサイト

次のインサイトはPageAndPostInsights から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_ACTIONS_POST_REACTIONS_ANGER_TOTAL	day	page	-
PAGE_ACTIONS_POST_REACTIONS_HAHA_TOTAL	day	page	-
PAGE_ACTIONS_POST_REACTIONS_LIKE_TOTAL	day	page	-
PAGE_ACTIONS_POST_REACTIONS_LOVE_TOTAL	day	page	-
PAGE_ACTIONS_POST_REACTIONS_SORRY_TOTAL	day	page	-
PAGE_ACTIONS_POST_REACTIONS_WOW_TOTAL	day	page	-
PAGE_CONSUMPTIONS	day, week, days_28	page	-
PAGE_CONSUMPTIONS_UNIQUE	day, week, days_28	page	-
PAGE_ENGAGED_USERS	day, week, days_28	page	-
PAGE_FAN_ADDS	day	page	-
PAGE_FAN_ADDS_UNIQUE	day, week, days_28	page	-
PAGE_FAN_REMOVES	day	page	-
PAGE_FAN_REMOVES_UNIQUE	day	page	-
PAGE_FANS	day	page	-
PAGE_FANS_ONLINE	day	page	-
PAGE_FANS_ONLINE_PER_DAY	day	page	-
PAGE_IMPRESSIONS	day, week, days_28	page	-
PAGE_IMPRESSIONS_FREQUENCY_DISTRIBUTION	day, week, days_28	page	-
PAGE_IMPRESSIONS_ORGANIC	day, week, days_28	page	-
PAGE_IMPRESSIONS_ORGANIC_UNIQUE	day, week, days_28	page	-
PAGE_IMPRESSIONS_PAID	day, week, days_28	page	-
PAGE_IMPRESSIONS_PAID_UNIQUE	day, week, days_28	page	-
PAGE_IMPRESSIONS_UNIQUE	day, week, days_28	page	-
PAGE_IMPRESSIONS_VIRAL	day, week, days_28	page	-
PAGE_IMPRESSIONS_VIRAL_FREQUENCY_DISTRIBUTION	day, week, days_28	page	-
PAGE_IMPRESSIONS_VIRAL_UNIQUE	day, week, days_28	page	-
PAGE_NEGATIVE_FEEDBACK	day, week, days_28	page	-
PAGE_NEGATIVE_FEEDBACK_UNIQUE	day, week, days_28	page	-
PAGE_PLACES_CHECKIN_MOBILE	day, week, days_28	page	-
PAGE_PLACES_CHECKIN_MOBILE_UNIQUE	day, week, days_28	page	-
PAGE_PLACES_CHECKIN_TOTAL	day, week, days_28	page	-
PAGE_PLACES_CHECKIN_TOTAL_UNIQUE	day, week, days_28	page	-
PAGE_POST_ENGAGEMENTS	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS_ORGANIC	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS_ORGANIC_UNIQUE	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS_PAID	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS_PAID_UNIQUE	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS_UNIQUE	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS_VIRAL	day, week, days_28	page	-
PAGE_POSTS_IMPRESSIONS_VIRAL_UNIQUE	day, week, days_28	page	-
PAGE_CONTENT_ACTIVITY	day, week, days_28	page	PAGE_STORIES
PAGE_VIDEO_COMPLETE_VIEWS_30S	day, week, days_28	page	-
PAGE_VIDEO_COMPLETE_VIEWS_30S_AUTOPLAYED	day, week, days_28	page	-
PAGE_VIDEO_COMPLETE_VIEWS_30S_CLICK_TO_PLAY	day, week, days_28	page	-
PAGE_VIDEO_COMPLETE_VIEWS_30S_ORGANIC	day, week, days_28	page	-
PAGE_VIDEO_COMPLETE_VIEWS_30S_PAID	day, week, days_28	page	-
PAGE_VIDEO_COMPLETE_VIEWS_30S_REPEAT_VIEWS	day, week, days_28	page	-
PAGE_VIDEO_COMPLETE_VIEWS_30S_UNIQUE	day, week, days_28	page	-
PAGE_VIDEO_REPEAT_VIEWS	day, week, days_28	page	-
PAGE_VIDEO_VIEWS	day, week, days_28	page	-
PAGE_VIDEO_VIEWS_AUTOPLAYED	day, week, days_28	page	-
PAGE_VIDEO_VIEWS_CLICK_TO_PLAY	day, week, days_28	page	-
PAGE_VIDEO_VIEWS_ORGANIC	day, week, days_28	page	-
PAGE_VIDEO_VIEWS_PAID	day, week, days_28	page	-
PAGE_VIDEO_VIEWS_UNIQUE	day, week, days_28	page	-
PAGE_VIEWS_TOTAL	day, week, days_28	page	PAGE_VIEWS
PAGE_VIEWS_LOGGED_IN_TOTAL	day, week, days_28	page	PAGE_VIEWS_LOGIN
PAGE_VIEWS_LOGGED_IN_UNIQUE	day, week, days_28	page	PAGE_VIEWS_LOGIN_UNIQUE
PAGE_VIEWS_LOGOUT	day	page	-
POST_CLICKS	lifetime	post	POST_CONSUMPTIONS
POST_CLICKS_UNIQUE	lifetime	post	POST_CONSUMPTIONS_UNIQUE
POST_ENGAGED_USERS	lifetime	post	-
POST_IMPRESSIONS	lifetime	post	-
POST_IMPRESSIONS_FAN	lifetime	post	-
POST_IMPRESSIONS_FAN_PAID	lifetime	post	-
POST_IMPRESSIONS_FAN_PAID_UNIQUE	lifetime	post	-
POST_IMPRESSIONS_FAN_UNIQUE	lifetime	post	-
POST_IMPRESSIONS_ORGANIC	lifetime	post	-
POST_IMPRESSIONS_ORGANIC_UNIQUE	lifetime	post	-
POST_IMPRESSIONS_PAID	lifetime	post	-
POST_IMPRESSIONS_PAID_UNIQUE	lifetime	post	-
POST_IMPRESSIONS_UNIQUE	lifetime	post	-
POST_IMPRESSIONS_VIRAL	lifetime	post	-
POST_IMPRESSIONS_VIRAL_UNIQUE	lifetime	post	-
POST_NEGATIVE_FEEDBACK	lifetime	post	-
POST_NEGATIVE_FEEDBACK_UNIQUE	lifetime	post	-
POST_ACTIVITY	lifetime	post	POST_STORIES
POST_ACTIVITY_UNIQUE	lifetime	post	POST_STORYTELLERS
POST_VIDEO_AVG_TIME_WATCHED	lifetime	post	-
POST_VIDEO_COMPLETE_VIEWS_ORGANIC	lifetime	post	-
POST_VIDEO_COMPLETE_VIEWS_ORGANIC_UNIQUE	lifetime	post	-
POST_VIDEO_COMPLETE_VIEWS_PAID	lifetime	post	-
POST_VIDEO_COMPLETE_VIEWS_PAID_UNIQUE	lifetime	post	-
POST_VIDEO_LENGTH	lifetime	post	-
POST_VIDEO_VIEW_TIME	lifetime	post	-
POST_VIDEO_VIEW_TIME_ORGANIC	lifetime	post	-
POST_VIDEO_VIEWS_10S	lifetime	post	-
POST_VIDEO_VIEWS_10S_AUTOPLAYED	lifetime	post	-
POST_VIDEO_VIEWS_10S_CLICKED_TO_PLAY	lifetime	post	-
POST_VIDEO_VIEWS_10S_ORGANIC	lifetime	post	-
POST_VIDEO_VIEWS_10S_PAID	lifetime	post	-
POST_VIDEO_VIEWS_10S_SOUND_ON	lifetime	post	-
POST_VIDEO_VIEWS_10S_UNIQUE	lifetime	post	-
POST_VIDEO_VIEWS_ORGANIC	lifetime	post	-
POST_VIDEO_VIEWS_ORGANIC_UNIQUE	lifetime	post	-
POST_VIDEO_VIEWS_PAID	lifetime	post	-
POST_VIDEO_VIEWS_PAID_UNIQUEPOST_VIDEO_VIEWS_SOUND_ON	lifetime	post	-

消費タイプ別インサイト

次のインサイトはInsightsByConsumptionType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE	day, week, days_28	page	-
PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE_UNIQUE	day, week, days_28	page	-
POST_CLICKS_BY_TYPE	lifetime	post	POST_CONSUMPTIONS_BY_CONSUMPTION_TYPE
POST_CLICKS_BY_TYPE_UNIQUE	lifetime	post	POST_CONSUMPTIONS_BY_CONSUMPTION_TYPE_UNIQUE

フィードバックタイプ別インサイト

次のインサイトはInsightsByFeedbackType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_NEGATIVE_FEEDBACK_BY_TYPE	day, week, days_28	page	-
PAGE_NEGATIVE_FEEDBACK_BY_TYPE_UNIQUE	day, week, days_28	page	-
PAGE_POSITIVE_FEEDBACK_BY_TYPE	day, week, days_28	page	-
PAGE_POSITIVE_FEEDBACK_BY_TYPE_UNIQUE	day, week, days_28	page	-
POST_NEGATIVE_FEEDBACK_BY_TYPE	lifetime	post	-
POST_NEGATIVE_FEEDBACK_BY_TYPE_UNIQUE	lifetime	post	-

いいねソースタイプ別インサイト

次のインサイトはInsightsByLikeSourceType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_FANS_BY_LIKE_SOURCE	day	page	-
PAGE_FANS_BY_LIKE_SOURCE_UNIQUE	day	page	-

いいねソースタイプ別インサイト

次のインサイトはInsightsByUnLikeSourceType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_FANS_BY_UNLIKE_SOURCE	day	page	-
PAGE_FANS_BY_UNLIKE_SOURCE_UNIQUE	day	page	-

リアクション合計別インサイト

次のインサイトはInsightsByReactionTotals から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_ACTIONS_POST_REACTIONS_TOTAL	day	page	-
POST_REACTIONS_BY_TYPE_TOTAL	day	page	-

ストーリータイプ別インサイト

次のインサイトはInsightsByStoryType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_CONTENT_ACTIVITY_BY_ACTION_TYPE	day, week, days_28	page	PAGE_STORIES_BY_STORY_TYPE
PAGE_IMPRESSIONS_BY_STORY_TYPE	day, week, days_28	page	-
PAGE_IMPRESSIONS_BY_STORY_TYPE_UNIQUE	day, week, days_28	page	-
POST_IMPRESSIONS_BY_STORY_TYPE	day, week, days_28	page	-
POST_IMPRESSIONS_BY_STORY_TYPE_UNIQUE	day, week, days_28	page	-

タブタイプ別インサイト

次のインサイトはInsightsByTabType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_TAB_VIEWS_LOGIN_TOP_UNIQUE	day, week	page	-
PAGE_TAB_VIEWS_LOGIN_TOP	day, week	page	-
PAGE_TAB_VIEWS_LOGOUT_TOP	day	page	-

シンプル動画インサイト

次のインサイトはSimpleVideoInsights から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
PAGE_VIDEO_VIEW_TIME	day	page	-
TOTAL_VIDEO_VIEWS	lifetime	video	-
TOTAL_VIDEO_VIEWS_UNIQUE	lifetime	video	-
TOTAL_VIDEO_VIEWS_AUTOPLAYED	lifetime	video	-
TOTAL_VIDEO_VIEWS_CLICKED_TO_PLAY	lifetime	video	-
TOTAL_VIDEO_VIEWS_SOUND_ON	lifetime	video	-
TOTAL_VIDEO_COMPLETE_VIEWS	lifetime	video	-
TOTAL_VIDEO_COMPLETE_VIEWS_UNIQUE	lifetime	video	-
TOTAL_VIDEO_COMPLETE_VIEWS_AUTO_PLAYED	lifetime	video	-
TOTAL_VIDEO_COMPLETE_VIEWS_CLICKED_TO_PLAY	lifetime	video	-
TOTAL_VIDEO_10S_VIEWS	lifetime	video	-
TOTAL_VIDEO_10S_VIEWS_UNIQUE	lifetime	video	-
TOTAL_VIDEO_10S_VIEWS_auto_played	lifetime	video	-
TOTAL_VIDEO_10S_VIEWS_CLICKED_TO_PLAY	lifetime	video	-
TOTAL_VIDEO_10S_VIEWS_SOUND_ON	lifetime	video	-
TOTAL_VIDEO_AVG_TIME_WATCHED	lifetime	video	-
TOTAL_VIDEO_VIEW_TOTAL_TIME	lifetime	video	-
TOTAL_VIDEO_IMPRESSIONS	lifetime	video	-
TOTAL_VIDEO_IMPRESSIONS_UNIQUE	lifetime	video	-
TOTAL_VIDEO_IMPRESSIONS_VIRAL_UNIQUE	lifetime	video	-
TOTAL_VIDEO_IMPRESSIONS_VIRAL	lifetime	video	-
TOTAL_VIDEO_IMPRESSIONS_FAN_UNIQUE	lifetime	video	-
TOTAL_VIDEO_IMPRESSIONS_FAN	lifetime	video	-

アクションタイプ別動画インサイト

次のインサイトはVideoInsightsByActionType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
TOTAL_VIDEO_STORIES_BY_ACTION_TYPE	lifetime	video	-

配信タイプ別動画インサイト

次のインサイトはVideoInsightsByDistributionType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
TOTAL_VIDEO_VIEWS_BY_DISTRIBUTION_TYPE	lifetime	video	-
TOTAL_VIDEO_VIEW_TIME_BY_DISTRIBUTION_TYPE	lifetime	video	-

リアクションタイプ別動画インサイト

次のインサイトはVideoInsightsByReactionType から派生しています：

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
TOTAL_VIDEO_REACTIONS_BY_TYPE_TOTAL	lifetime	video	-

See データモデル for how the Sync App exposes Facebook APIs as different relational tables and views. This page offers a summary of permissions that might be required depending on how you use the Sync App.

Overview

Access and permissions to Facebook APIs broadly depend on whether you are pulling information for:

• a User or things owned by a User
• a Page or things owned by a Page

For information associated with a User or scoped to a User, access and permission are dependent on the set of permissions (scopes) that the user has approved for the OAuth application that accesses the Facebook API. For information associated with a Page, access and permission are controlled not only by the approvals given by a user to the OAuth application, but also by:

• the approvals given by a user to the accessing OAuth application
• the tasks assigned to the user on the Page
• various Features approved for the application regardless of user
• Page status on the Facebook platform

To access information associated with a User, the OAuth application that is used with the Sync App must be able to obtain some or all of the following permissions:

• user_birthday
• user_photos
• user_videos
• user_likes
• user_hometown
• user_location
• user_tagged_places
• public_profile

The user must also approve the OAuth application for these permissions when the user signs into Facebook to approve the application's access to their account.

To access information associated with a Page, the OAuth application that is used with the Sync App must be able to obtain some or all of the following permissions:

• read_insights
• pages_read_engagement
• pages_manage_engagement
• pages_show_list

The user must also approve the OAuth application for these permissions when the user signs into Facebook to approve the application's access to their account.

Additionally, when accessing Page information, depending on what they are trying to access, users might find that they need one of the following Tasks for the Page:

• ANALYZE
• MODERATE
• CREATE_CONTENT
• MANAGE

Alternatively, you can use the following features, if approved for an application, to access certain public Page information when the user does not have the requisite Task on the page:

• Page Public Content Access (PPCA)
• Page Public Metadata Access (PPMA)

Finally, the status of a Page can also factor into determining what sort of information can be obtained for or from it:

• For Unpublished Pages, there are usually no restrictions for the Page data
• For Published, Unrestricted Pages, limited data is available through PPCA or PPMA. More data specific to the Page, or specific to the users, pages, or other Facebook entities that have interacted with the Page, is available to those who have requested requisite permissions for pages, and who also have been assigned the Tasks needed for the Page. Non-public Page data may be further limited by privacy choices of the user, page, or entity that generated the non-public data on the Page.
• For Published, Restricted Pages, data availability is covered by same permissions as for Published, Unrestricted pages, and additional requirements that the user must pass the restrictions, e.g., age or region, enforced for the Page.

Specific Permissions

The following shows the permissions, Tasks, or Features potentially required for each table or view. Whether each column is strictly required depends on your use case. Note that whether Page Permissions, Page Task, and Page Features are required depends on the status of the Page on Facebook and on the ownership relationship of the application user to the Page.

Table or View Name	User or Non-Page Permissions	Page Permissions	Page Task	Page Feature
Comments	permissions for parent entity	permissions for parent entity, pages_read_engagement, or pages_read_user_content	MODERATE	PPCA
Events	N/A	pages_read_engagement, pages_read_user_content, or pages_manage_metadata	N/A	N/A
Groups	conditionally group_access_member_info	N/A	N/A	N/A
InsightsByConsumptionType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
InsightsByFeedbackType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
InsightsByLikeSourceType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
InsightsByReactionTotals	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
InsightsByStoryType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
InsightsByTabType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
InsightsByUnlikeType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
InstagramAccountInsights	instagram_basic and instagram_manage_insights	N/A	N/A	N/A
Likes	permissions for parent entity	N/A	N/A	N/A
PageAndPostInsights	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
Pages	pages_show_list	pages_read_engagement or pages_read_user_content, pages_show_list	MODERATE	PPCA,PPMA
Photos	user_photos	pages_read_engagement or pages_read_user_content	MODERATE	N/A
Places	user_location	N/A	N/A	N/A
Posts	user_posts	pages_read_engagement or pages_read_user_content	MODERATE, CREATE_CONTENT, or MANAGE	PPCA
Ratings	N/A	pages_read_user_content	MODERATE, CREATE_CONTENT, or MANAGE	N/A
SimpleVideoInsights	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
StoryAttachments	permissions for parent entity	permissions for parent entity	N/A	N/A
TaggedBy	N/A	pages_read_user_content, pages_show_list	MODERATE, CREATE_CONTENT, or MANAGE	N/A
Users	public_profile, user_location	N/A	N/A	N/A
VideoInsightsByActionType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
VideoInsightsByDistributionType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
VideoInsightsByReactionType	N/A	read_insights or pages_read_engagement	ANALYZE	N/A
Videos	user_videos or user_posts	pages_read_engagement or pages_read_user_content	MANAGE	PPCA
Wall	user_posts	pages_read_engagement or pages_read_user_content	MODERATE, CREATE_CONTENT, MANAGE	PPCA

このセクションでは、Facebook Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App を使用すると、事前設定されたクエリによって内容が決定されるユーザー定義ビューと呼ばれる仮想テーブルを定義できます。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。

SSL の設定

SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。 詳しくは、接続文字列オプションにあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、Facebook にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくはクエリ処理 を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログ を参照してください。基本的なロギングでは、 次の2つの接続プロパティを設定するだけです。LogModules 接続プロパティを使用してログに記録する情報のサブセットを選択できる、 より洗練されたロギングをサポートする多数の機能があります。

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。

別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。

Firewall またはProxy 経由の接続

HTTP プロキシ

Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。

さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。

その他のプロキシ

次のプロパティを設定します。

• プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
• 接続をトンネルするには、FirewallType をTUNNEL に設定します。
• 認証するには、FirewallUser とFirewallPassword を設定します。
• SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

CData Sync App は、Facebook API をリレーショナルテーブル、ビュー、およびストアドプロシージャにモデル化します。 このセクションでは、API の制限および要件について説明します。既定の SupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。

テーブル

テーブル では、利用可能なテーブルを説明します。

ビュー

ビュー は変更ができないテーブルです。一般的には、Read-only で更新が不可能なデータはビューとして表されます。

ストアドプロシージャ

ストアドプロシージャ は、データソースのファンクションライクなインターフェースです。これらを使用して、データソース内の情報を検索、更新、および変更できます。

Sync App はFacebook のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

Facebook Connector for CData Sync テーブル

Name	Description
Likes	ターゲットのいいね！を作成、削除、およびクエリします。または、指定されたユーザーまたはページがいいね！したページをリストします。このテーブルを使用するには、認証が必要です。
Posts	ターゲット、またはID に基づいてターゲットへの投稿を作成、削除、およびクエリします。ターゲットに基づいてコメントを挿入したり、ID に基づいて削除することもできます。このテーブルには認証が必要です。

ターゲットのいいね！を作成、削除、およびクエリします。または、指定されたユーザーまたはページがいいね！したページをリストします。このテーブルを使用するには、認証が必要です。

テーブル固有の情報

Likes は高度なテーブルで、SQL クエリでTarget 列を設定する必要があります。

Facebook のLikes は、特定のターゲットをいいね！したユーザーを表します。ターゲットには、投稿、写真などのいいね！を関連付けることができる有効なエンティティを指定できます。

Note： 現時点では、Likes テーブルでは、ページに対する「いいね！」などのリアクションを取得することはできません。Facebook から新しいページエクスペリエンスでページのシンプルなインサイトを取得するには、PageAndPostInsights を参照してください。

Select

いいね！を選択する場合は、ターゲットを指定します。ターゲットは、いいね！を獲得したエンティティのユーザー名またはID を表します。次に例を示します。

SELECT Id, Name, Picture FROM Likes WHERE Target = '15526475270_410830705612736'

いいね！のターゲットとしてユーザーまたはページを指定した場合は、そのユーザーまたはページがいいね！したページが返されます。次に例を示します。

SELECT Id, Name, Username, Category FROM Likes WHERE Target = 'facebook'

ターゲットを指定しなかった場合は、現在の認証ユーザーがターゲットとして使用されます。この場合は、認証ユーザーがいいね！したページが返されます。

Insert

いいね！またはいいね！したオブジェクトを挿入するには、いいね！するターゲットを指定してINSERT ステートメントを発行します。ターゲットには、アルバム、チェックイン、コメント、写真、投稿、近況アップデートなど、いいね！できるオブジェクトを指定する必要があります。次に例を示します。

INSERT INTO Likes (Target) VALUES ('123456789_123456789')

Update

Facebook は、いいね！の更新を許可していません。

Delete

Facebook は、いいね！の削除を許可していません。

Columns

Name	Type	ReadOnly	Description
ID [KEY]	String	True	ターゲットをいいね！したユーザーのID。これは、ターゲットID と組み合わせることができます。ユーザーID は、最後の'_'の後の部分です。
Target [KEY]	String	False	いいね！されたターゲットのID またはユーザー名。これには、投稿、ページ、写真など、いいね！された有効なID を指定できます。
Name	String	True	ターゲットをいいね！したユーザーの名前。または、ページの名前を指定できます。
Username	String	True	ページに含まれるリンク先のページを取得する際のページのユーザー名。
Picture	String	True	ターゲットをいいね！したユーザーの写真。または、ページの写真を指定できます。
Category	String	True	ユーザーまたはページのカテゴリ。
CreatedTime	Datetime	True	いいね！された時刻がある場合は、その時刻。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
offset	String	最初に返す結果。結果の手動ページングで使用されます。

ターゲット、またはID に基づいてターゲットへの投稿を作成、削除、およびクエリします。ターゲットに基づいてコメントを挿入したり、ID に基づいて削除することもできます。このテーブルには認証が必要です。

テーブル固有の情報

Facebook のPosts は、ユーザーのプロフィールフィードへの投稿です。投稿は、ユーザー、ページ、アプリケーション、グループ、またはイベントに対して行うことができます。

Note： Facebook API の非推奨仕様により、ユーザープロファイルが定義された、またはデフォルトのターゲットであるComments、Photos、Posts、およびVideos ビューへのクエリは、以下のフィールドのデータを返さなくなりました。

• comments
• message_tags
• reactions
• sharedposts
• story
• story_tags
• to
• via

詳しくは、https://developers.facebook.com/docs/graph-api/changelog/version16.0 を参照してください。

Select

投稿を選択する際にターゲットを指定することができます。ターゲットは、投稿の対象になるページなどの有効なエンティティを表します。ターゲットを指定しなかった場合は、認証ユーザーがターゲットとして使用されます。例えば、ページからの投稿を取得するには、次のステートメントを使用します。

SELECT * FROM Posts WHERE Target = 'PageId'

投稿ID がわかっている場合は、ID を指定するだけで特定の投稿に関する情報を取得できます。次に例を示します。

SELECT * FROM Posts WHERE Id = 'PostId'

投稿をクエリする場合は、CreatedTime またはUpdatedTime のいずれかを指定してエレメントを取得できます。次に例を示します。

SELECT * FROM Posts WHERE Target = 'facebook' AND CreatedTime >= '1/1/2012' AND CreatedTime <= '2/1/2012'

挿入

投稿を挿入するには、投稿のTarget とMessage を指定する必要があります。次に例を示します。

INSERT INTO Posts (Message, Target) VALUES ('My New Post', 'PageId')

Link またはObjectId カラムを使用して写真の投稿を作成します。Link カラムでは、投稿を追加する画像のアクセス可能なURL を指定します。また、動画の投稿も作成できます。

INSERT INTO Posts (Message, Target, Link) VALUES ('My New Post', 'PageId', 'http://imagerepo.net/testimage.png)'

INSERT INTO Posts (Message, Target, Link) VALUES ('My New Post', 'PageId', 'http://samplevideos.net/newmovie.mp4)'

Link カラムにローカルファイルを設定してメディアをアップロードすることもできます。この機能を使用するには、UploadLinkedMedia をtrue に設定してください。

INSERT INTO Posts (Message, Target, Link) VALUES ('From Local', 'PageId', 'file://D://test/sample.mp4')

ObjectId カラムでは、アカウント内の未公開の写真のID を指定します。公開せずに写真をアップロードするには、UploadPhoto ストアドプロシージャを使用します。Video Id はサポートされていません。

INSERT INTO Posts (Message, Target, ObjectId) VALUES ('My New Post', 'PageId', '43572')

更新

Facebook は、投稿の更新を許可していません。

削除

投稿を削除するには、投稿のID を指定してDELETE ステートメントを発行します。Facebook では、アプリによって作成された投稿だけをそのアプリを使用して削除できます。

Columns

Name	Type	ReadOnly	Description
ID [KEY]	String	True	投稿のID。
Target	String	False	投稿を取得するターゲットのID またはユーザー名、または投稿先のターゲットのID またはユーザー名。これには、イベント、グループ、ページ、またはユーザーを指定できます。
FromId	String	True	投稿を行ったユーザーのID。
FromName	String	True	投稿を行ったユーザーの名前。
FromPicture	String	True	投稿を行ったユーザーの写真。
FromCategory	String	True	投稿を行ったユーザーのカテゴリ。FromCategory は、他のFrom* フィールドが選択されていない場合にのみ取得できます。
ToData	String	True	投稿先のユーザーの集計。
Message	String	False	投稿のメッセージ。投稿の挿入時にはメッセージが必要です。
MessageTags	String	True	メッセージ内でタグ付けされたユーザー、ページなどのオブジェクトの集計。
Attachments	String	True	投稿の添付ファイルの集計。
Picture	String	False	投稿に含まれる写真へのリンク。
FullPicture	String	False	投稿に含まれる元の写真へのリンク。Picture にリストされたものは、リサイズされた小さな写真の場合があります。
Icon	String	True	投稿のタイプを表すアイコンへのリンク。
Actions	String	True	投稿に対して実行できるアクション（コメント、いいね！など）の集計。
CommentsCount	Integer	True	投稿に対するコメントの数。
LikesCount	Integer	True	投稿がいいね！された回数。
SharesCount	Integer	True	投稿が共有された回数。
PlaceId	String	False	投稿に関連付けられた場所がある場合は、そのID。
PlaceName	String	True	投稿に関連付けられた場所がある場合は、その名前。
ApplicationId	String	True	この投稿が行われたアプリケーションのID。
ApplicationName	String	True	この投稿が行われたアプリケーションの名前。
ApplicationCanvasName	String	True	エンティティの作成に使用されたアプリケーションに関する情報。
ApplicationNamespace	String	True	エンティティの作成に使用されたアプリケーションに関する情報。
Story	String	True	ユーザーから意図せず生まれた記事。例えば、2人のユーザーが友達になったときに生まれた記事です。このような記事を取得するには、アプリで［最近のニュースフィード記事を含める］移行オプションを有効にする必要があります。read_stream アクセス許可が必要です。
StoryTags	String	True	記事に関連付けられたオブジェクト（ユーザー、ページなど）の集計。
LikesData	String	True	いいね！データの集計。
CommentsData	String	True	この投稿に対するコメントの集計。
CreatedTime	Datetime	True	投稿の作成時刻。
UpdatedTime	Datetime	True	投稿が最後に更新された時刻。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
TaggedUser	String	これをID またはユーザー名に設定すると、指定されたユーザーがタグ付けされている投稿が取得されます。read_stream アクセス許可が必要です。
LocationUser	String	これをID またはユーザー名に設定すると、ユーザーがタグ付けされている場所が取得されます。user_photos およびuser_status アクセス許可が必要です。
Link	String	投稿に添付するリンク。投稿の作成には、Link カラムまたはMessage カラムのいずれかが必要です。

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

Facebook Connector for CData Sync ビュー

Name	Description
Comments	ターゲットに対するコメントを作成、更新、削除、およびクエリします。ターゲットに基づいてコメントを挿入したり、ID に基づいて削除することもできます。
Events	ページID などのターゲットのイベントをクエリします。
Groups	Query the Pages based on the supplied Id.
InsightsByConsumptionType	消費タイプによるインサイトの取得を許容します。
InsightsByFeedbackType	フィードバックタイプによるインサイトの取得を許容します。
InsightsByLikeSourceType	いいねソースのタイプによるインサイトの取得を許容します。
InsightsByReactionTotals	いいねソースのタイプによるインサイトの取得を許容します。
InsightsByStoryType	ストーリーのタイプによるインサイトの取得を許容します。
InsightsByTabType	タブのタイプによるインサイトの取得を許容します。
InsightsByUnLikeSourceType	いいねソースのタイプによるインサイトの取得を許容します。
InstagramAccountInsights	Instagram ビジネスアカウントのインサイトを取得できます。instagram_basic およびinstagram_manage_insights スコープが必須です。
PageAndPostInsights	レスポンス内に1つの値を持つシンプルなインサイトの取得を許容します。
Pages	提供されたID に基づいてページをクエリします。
Permissions	ユーザーが現在のアプリケーションに付与した権限をクエリします。
Photos	ターゲットに関連付けられた写真のクエリ。通常、写真情報へのアクセスには、user_photos アクセス許可が必要です。
Places	提供されたID に基づいてスポットをクエリします。スポットはFacebook のページとして保存されます。
Ratings	Facebook ページの評価のリスト。このビューには認証が必要です。
SimpleVideoInsights	レスポンス内に1つの値を持つシンプルな動画インサイトの取得を許容します。
StoryAttachments	Query attachments from a post or comment.
TaggedBy	ユーザー、またはページにタグ付けされた投稿、ステータス、写真、およびその他のエンティティ情報をクエリします。このビューは、ターゲットユーザーまたはターゲットページにタグ付けしたエントリだけが返される、ウォールコネクションの一部です。一般に、これはページにのみ使用できます。
Users	認証されたユーザーに関する基本情報を返します。
VideoInsightsByActionType	ストーリーアクションタイプごとの動画インサイトの取得を許容します。
VideoInsightsByDistributionType	ディストリビューションタイプごとの動画インサイトの取得を許容します。
VideoInsightsByReactionType	リアクションタイプごとの動画インサイトの取得を許容します。
Videos	ターゲットからの動画をクエリします。通常は、user_videos アクセス許可が必要です。
Wall	ターゲットのウォールからの投稿をクエリします。

ターゲットに対するコメントを作成、更新、削除、およびクエリします。ターゲットに基づいてコメントを挿入したり、ID に基づいて削除することもできます。

テーブル固有の情報

Facebook のComments は、特定の対象に関するコメントです。コメントは常に1つのターゲット（コメント対象の項目）に関連付けられています。ターゲットには、投稿、写真、動画などがあります。このテーブルを使用して、特定のターゲットに対するコメントをリストしたり、ターゲットに関する新しいコメントを挿入することができます。

Note： Facebook API の非推奨仕様により、ユーザープロファイルが定義された、またはデフォルトのターゲットであるComments、Photos、Posts、およびVideos ビューへのクエリは、以下のフィールドのデータを返さなくなりました。

• comments
• message_tags
• reactions
• sharedposts
• story
• story_tags
• to
• via

詳しくは、https://developers.facebook.com/docs/graph-api/changelog/version16.0 を参照してください。

Select

コメントをクエリする場合は、コメントのTarget またはId のいずれかを指定することができます。例えば、特定の投稿に関するすべてのコメントを取得する場合、SELECT ステートメントは次のようになります。

SELECT * FROM Comments WHERE Target = '15526475270_410830705612736'

ID を指定して特定のコメントを取得することもできます。次に例を示します。

SELECT * FROM Comments WHERE Id = '15526475270_410830705612736_5193593'

Target またはId が指定されていない場合、コメントは現在認証されているユーザーまたはページのフィードの投稿からクエリされます。

複数のクエリを組み合わせて、複数のFacebook エンティティにまたがる投稿からコメントを取得することもできます。次に例を示します。

SELECT * FROM Comments WHERE Target IN (SELECT Id FROM Posts WHERE Target IN (SELECT Id FROM Pages))

全ての投稿のコメントを検索したい場合は、Posts テーブルかWall ビューを検討してください。これらには'CommentsData' および'CommentsCount' カラムが含まれます。'CommentsCount' は、コメントがついた投稿（ターゲット）だけをフィルタリングして選択するようにクエリすることができます。

SELECT * FROM Wall WHERE CommentsCount > 0

Columns

Name	Type	Description
ID [KEY]	String	コメントのID。
Target	String	コメントを取得するターゲットのID。これには、アルバム、チェックイン、リンク、ノート、写真、投稿、近況アップデート、または動画を指定できます。
FromId	String	コメントを行ったユーザーのID。
FromName	String	コメントを行ったユーザーの名前。
FromPicture	String	コメントを行ったユーザーの写真。
Message	String	コメントのテキスト。
MessageTags	String	メッセージに含まれるタグの集計。
Likes	Integer	コメントに対するいいね！の数。
CommentsCount	Integer	このコメントへの返信コメントの数。
LikesData	String	コメントのいいね！情報の集計。
UserLikes	Boolean	認証ユーザーがこのコメントにいいね！したかどうかを示すboolean。
CanRemove	Boolean	コメントを削除できるかどうかを示すboolean。
Attachments	String	投稿の添付ファイルの集計。
CreatedTime	Datetime	コメントが作成された時刻。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
offset	String	最初に返す結果。結果の手動ページングで使用されます。

ページID などのターゲットのイベントをクエリします。

テーブル固有の情報

Facebook のイベントは、何かが起きる日をマークするためにユーザーまたはページによって作成されます。イベントは、Target またはId によってクエリできます。

Select

イベントを選択する際にターゲットを指定することができます。ターゲットは、イベントを作成したページを表します。デフォルトでは、これは現在の認証ユーザーまたはページになります。例えば、ページに関連付けられたイベントを取得するには、次のステートメントを使用します。

SELECT * FROM Events WHERE Target = 'PageId'

イベントID がわかっている場合は、ID を指定するだけで特定のイベントに関する情報を取得できます。次に例を示します。

SELECT * FROM Events WHERE Id = 'EventId'

Columns

Name	Type	Description
ID [KEY]	String	イベントのID。
Target	String	イベントを取得するターゲットのID またはユーザー名、またはイベントの投稿先のターゲットのID またはユーザー名。これには、ページまたはユーザーを指定できます。
Name	String	イベントの名前。
StartTime	Datetime	イベントの開始時刻。
EndTime	Datetime	イベントの終了時刻。
Timezone	String	イベントが発生するタイムゾーン。
Description	String	イベントの説明。
Picture	String	イベントの写真のURL。
OwnerId	String	イベントを作成したユーザーのID。
OwnerName	String	イベントを作成したユーザーの名前。
OwnerPicture	String	イベントを作成したユーザーの写真。
OwnerCategory	String	オーナーがある場合は、オーナーのカテゴリ。
Location	String	イベントの場所を指定する場合は、その場所。
LocationId	String	イベントの場所のID。
LocationStreet	String	イベントの番地。
LocationCity	String	イベントの市区町村。
LocationState	String	イベントの都道府県。
LocationCountry	String	イベントの国。
LocationZip	String	イベントの郵便番号。
LocationLatitude	String	イベントの緯度。
LocationLongitude	String	イベントの経度。
TicketUri	String	このイベントのチケットの購入場所のURL。
UpdatedTime	Datetime	イベントが最後に更新された時刻。
AttendingCount	Integer	イベントに参加する人の数。
DeclinedCount	Integer	イベントを辞退した人の数。
InterestedCount	Integer	イベントに興味がある人の数。
MaybeCount	Integer	イベントにたぶん参加する人の数。
NoreplyCount	Integer	イベントに返信しなかった人の数。

Query the Pages based on the supplied Id.

Table Specific Information

Groups are a place to communicate about shared interests with certain people. Groups may be queried by Id.

Select

If you know the groups Id, you may also just specify the Id to obtain information about the specific group. For example:

SELECT * FROM Groups WHERE Id = 'GroupId'

Columns

Name	Type	Description
ID [KEY]	String	The Group ID.
Name	String	The name of the Group.
Description	String	A brief description of the Group.
Email	String	The email address to upload content to the Group. Only current members of the Group can use this.
Icon	String	The URL for the Group's icon.
MemberCount	Integer	The number of members in the Group.
MemberRequestCount	Integer	The number of members in the Group.
CoverId	String	Id of the cover image for the group.
CoverSource	String	The URL to the cover image for the group.
CoverOffsetY	String	The y-axis offset of the cover image for the group.
CoverOffsetX	String	The x-axis offset of the cover image for the group.
Permissions	String	The permissions a User has granted for an app installed in the Group.
Privacy	String	The privacy setting of the Group. Possible values are CLOSED, OPEN, and SECRET. Requires an access token of an Admin of the Group.
UpdatedTime	Datetime	The last time the Group was updated (includes changes Group properties, Posts, and Comments). Requires an access token of an Admin of the Group.

消費タイプによるインサイトの取得を許容します。

テーブル固有の情報

消費タイプによるインサイトは、ページまたは投稿から取得でき、ユーザーがコンテンツをどのように消費したかを知ることが可能です。

Select

インサイトを選択する場合は、Target を指定する必要があります。加えて、InsightName およびPeriod は常に指定される必要があります。次に例を示します。

SELECT * FROM InsightsByConsumptionType WHERE Target = 'mypostid' AND InsightName = 'PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE' AND Period = 'day'

さらに、StartTime およびEndTime を使用して、インサイトデータを取得する範囲を指定できます。

SELECT * FROM InsightsByConsumptionType WHERE Target = 'mypostid' AND InsightName = 'PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE' AND Period = 'day' AND EndTime >= '12/1/2015' AND EndTime <= '12/31/2015'

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Datetime	このインサイトデータの最新の日付。
VideoPlay	Long	指定された消費タイプの合計を示すInsight カラム。
OtherClicks	Long	指定された消費タイプの合計を示すInsight カラム。
PhotoView	Long	指定された消費タイプの合計を示すInsight カラム。
LinkClicks	Long	指定された消費タイプの合計を示すInsight カラム。
ButtonClicks	Long	指定された消費タイプの合計を示すInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE,PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE_UNIQUE,POST_CLICKS_BY_TYPE,POST_CLICKS_BY_TYPE_UNIQUE
Period	String	インサイトの期間。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

フィードバックタイプによるインサイトの取得を許容します。

テーブル固有の情報

フェードバックタイプによるインサイトは、ページまたは投稿から取得でき、どのようなフィードバックがなされたのかを知ることが可能です。

Select

インサイトを選択する場合は、Target を指定する必要があります。加えて、InsightName およびPeriod は常に指定される必要があります。次に例を示します。

SELECT * FROM InsightsByFeedbackType WHERE Target = 'mypostid' AND InsightName = 'PAGE_POSITIVE_FEEDBACK_BY_TYPE' AND Period = 'day'

さらに、StartTime およびEndTime を使用して、インサイトデータを取得する範囲を指定できます。

SELECT * FROM InsightsByFeedbackType WHERE Target = 'mypostid' AND InsightName = 'PAGE_POSITIVE_FEEDBACK_BY_TYPE' AND Period = 'day' AND EndTime >= '12/1/2015' AND EndTime <= '12/31/2015'

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
Like	Long	ポジティブなフィードバックの合計を示すInsight カラム。
Comment	Long	ポジティブなフィードバックの合計を示すInsight カラム。
Link	Long	ポジティブなフィードバックの合計を示すInsight カラム。
Answer	Long	ポジティブなフィードバックの合計を示すInsight カラム。
Claim	Long	ポジティブなフィードバックの合計を示すInsight カラム。
Rsvp	Long	ポジティブなフィードバックの合計を示すInsight カラム。
HideAllClicks	Long	ポジティブなフィードバックの合計を示すInsight カラム。
HideClicks	Long	ポジティブなフィードバックの合計を示すInsight カラム。
UnlikePageClicks	Long	ポジティブなフィードバックの合計を示すInsight カラム。
ReportSpamClicks	Long	ポジティブなフィードバックの合計を示すInsight カラム。
XButtonClicks	Long	ポジティブなフィードバックの合計を示すInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。PAGE_NEGATIVE_FEEDBACK_BY_TYPE,PAGE_NEGATIVE_FEEDBACK_BY_TYPE_UNIQUE,PAGE_POSITIVE_FEEDBACK_BY_TYPE,PAGE_POSITIVE_FEEDBACK_BY_TYPE_UNIQUE,POST_NEGATIVE_FEEDBACK_BY_TYPE,POST_NEGATIVE_FEEDBACK_BY_TYPE_UNIQUE
Period	String	インサイトの期間。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

いいねソースのタイプによるインサイトの取得を許容します。

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
Ads	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
NewsFeed	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
Other	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
PageSuggestions	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
RestoredLikesFromReactivatedAccounts	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
Search	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
YourPage	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。PAGE_FANS_BY_LIKE_SOURCE,PAGE_FANS_BY_LIKE_SOURCE_UNIQUE

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

いいねソースのタイプによるインサイトの取得を許容します。

テーブル固有の情報

リアクション合計タイプからのインサイトは、ページまたは投稿のリアクション合計によります。

Select

インサイトを選択する場合は、Target を指定する必要があります。指定されたInsightName に則り、ページ、もしくは投稿に設定してください。InsightName は以下に設定ができます：'PAGE_ACTIONS_POST_REACTIONS_TOTAL'、'POST_REACTIONS_BY_TYPE_TOTAL'。デフォルトは'PAGE_ACTIONS_POST_REACTIONS_TOTAL' です。次に例を示します。

SELECT * FROM InsightsByReactionTotals WHERE Target = 'mypageid' AND InsightName = 'PAGE_ACTIONS_POST_REACTIONS_TOTAL'

さらに、StartTime およびEndTime を使用して、インサイトデータを取得する範囲を指定できます。

SELECT * FROM InsightsByReactionTotals WHERE Target = 'mypageid' AND InsightName = 'PAGE_ACTIONS_POST_REACTIONS_TOTAL' AND EndTime >= '12/1/2015' AND EndTime <= '12/31/2015'

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
Like	Long	いいねリアクションの合計。
Love	Long	超いいねリアクションの合計。
Wow	Long	すごいねリアクションの合計。
Haha	Long	うけるねリアクションの合計。
Sorry	Long	悲しいねリアクションの合計。
Anger	Long	ひどいねリアクションの合計。
Target	String	インサイトのターゲット。これは常に指定する必要があります。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。
InsightName	String	インサイト名。利用可能な値は次のとおりです。PAGE_ACTIONS_POST_REACTIONS_TOTAL,POST_REACTIONS_BY_TYPE_TOTAL デフォルト値はPAGE_ACTIONS_POST_REACTIONS_TOTALです。

ストーリーのタイプによるインサイトの取得を許容します。

テーブル固有の情報

ストーリータイプによるインサイトは、ページまたは投稿から取得でき、発生したストーリーのタイプを知ることが可能です。

Select

インサイトを選択する場合は、Target を指定する必要があります。加えて、InsightName およびPeriod は常に指定される必要があります。次に例を示します。

SELECT * FROM InsightsByStoryType WHERE Target = 'mypostid' AND InsightName = 'PAGE_STORIES_BY_STORY_TYPE' AND Period = 'day'

さらに、StartTime およびEndTime を使用して、インサイトデータを取得する範囲を指定できます。

SELECT * FROM InsightsByStoryType WHERE Target = 'mypostid' AND InsightName = 'PAGE_STORIES_BY_STORY_TYPE' AND Period = 'day' AND EndTime >= '12/1/2015' AND EndTime <= '12/31/2015'

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
UserPost	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
PagePost	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Checkin	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Fan	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Question	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Coupon	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Event	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Mention	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Other	Long	指定されたストーリーのタイプの合計を示すInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。PAGE_CONTENT_ACTIVITY_BY_ACTION_TYPE,PAGE_IMPRESSIONS_BY_STORY_TYPE,PAGE_IMPRESSIONS_BY_STORY_TYPE_UNIQUE,POST_IMPRESSIONS_BY_STORY_TYPE,POST_IMPRESSIONS_BY_STORY_TYPE_UNIQUE
Period	String	インサイトの期間。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

タブのタイプによるインサイトの取得を許容します。

テーブル固有の情報

タブタイプによるインサイトは、ページまたは投稿から取得でき、コンテンツを見るためにどのタブを使ったかを知ることが可能です。

Select

インサイトを選択する場合は、Target を指定する必要があります。加えて、InsightName およびPeriod は常に指定される必要があります。次に例を示します。

SELECT * FROM InsightsByTabType WHERE Target = 'mypostid' AND InsightName = 'PAGE_TAB_VIEWS_LOGIN_TOP_UNIQUE' AND Period = 'day'

さらに、StartTime およびEndTime を使用して、インサイトデータを取得する範囲を指定できます。

SELECT * FROM InsightsByTabType WHERE Target = 'mypostid' AND InsightName = 'PAGE_TAB_VIEWS_LOGIN_TOP_UNIQUE' AND Period = 'day' AND EndTime >= '12/1/2015' AND EndTime <= '12/31/2015'

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
About	Long	指定されたタブのタイプの合計を示すInsight カラム。
Ads	Long	指定されたタブのタイプの合計を示すInsight カラム。
Album	Long	指定されたタブのタイプの合計を示すInsight カラム。
AllActivity	Long	指定されたタブのタイプの合計を示すInsight カラム。
App	Long	指定されたタブのタイプの合計を示すInsight カラム。
Community	Long	指定されたタブのタイプの合計を示すInsight カラム。
Events	Long	指定されたタブのタイプの合計を示すInsight カラム。
Home	Long	指定されたタブのタイプの合計を示すInsight カラム。
Info	Long	指定されたタブのタイプの合計を示すInsight カラム。
Insights	Long	指定されたタブのタイプの合計を示すInsight カラム。
Jobs	Long	指定されたタブのタイプの合計を示すInsight カラム。
Likes	Long	指定されたタブのタイプの合計を示すInsight カラム。
Locations	Long	指定されたタブのタイプの合計を示すInsight カラム。
Notes	Long	指定されたタブのタイプの合計を示すInsight カラム。
Photos	Long	指定されたタブのタイプの合計を示すInsight カラム。
PhotosAlbums	Long	指定されたタブのタイプの合計を示すInsight カラム。
PhotosStream	Long	指定されたタブのタイプの合計を示すInsight カラム。
Posts	Long	指定されたタブのタイプの合計を示すInsight カラム。
Profile	Long	指定されたタブのタイプの合計を示すInsight カラム。
ProfileAbout	Long	指定されたタブのタイプの合計を示すInsight カラム。
ProfileCommunity	Long	指定されたタブのタイプの合計を示すInsight カラム。
ProfileHome	Long	指定されたタブのタイプの合計を示すInsight カラム。
ProfileInfo	Long	指定されたタブのタイプの合計を示すInsight カラム。
ProfileLikes	Long	指定されたタブのタイプの合計を示すInsight カラム。
ProfilePhotos	Long	指定されたタブのタイプの合計を示すInsight カラム。
ProfilePosts	Long	指定されたタブのタイプの合計を示すInsight カラム。
Reviews	Long	指定されたタブのタイプの合計を示すInsight カラム。
Timeline	Long	指定されたタブのタイプの合計を示すInsight カラム。
Videos	Long	指定されたタブのタイプの合計を示すInsight カラム。
Wall	Long	指定されたタブのタイプの合計を示すInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。PAGE_TAB_VIEWS_LOGIN_TOP_UNIQUE,PAGE_TAB_VIEWS_LOGIN_TOP,PAGE_TAB_VIEWS_LOGOUT_TOP
Period	String	インサイトの期間。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

いいねソースのタイプによるインサイトの取得を許容します。

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
DeactivatedOrMemorializedAccountRemovals	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
SuspiciousAccountRemovals	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
UnlikesFromPagePostsOrNewsFeed	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
UnlikesFromSearch	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
UnderageAccountRemovals	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
UnlikesFromPageSuggestions	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
Other	Long	指定されたいいねソースのタイプの合計を示すInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。PAGE_FANS_BY_UNLIKE_SOURCE,PAGE_FANS_BY_UNLIKE_SOURCE_UNIQUE

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

Instagram ビジネスアカウントのインサイトを取得できます。instagram_basic およびinstagram_manage_insights スコープが必須です。

Columns

Name	Type	Description
RowNumber [KEY]	String	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
Value	Long	特異値レスポンスのインサイトカラム。
Description	String	インサイトの期間。これは行を（日、週、28 day もしくはLifetime）へのブレークダウンを管理します。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。IMPRESSIONS,REACH,FOLLOWER_COUNT,EMAIL_CONTACTS,PHONE_CALL_CLICKS,TEXT_MESSAGE_CLICKS,GET_DIRECTIONS_CLICKS,WEBSITE_CLICKS,PROFILE_VIEWS,AUDIENCE_GENDER_AGE,AUDIENCE_COUNTRY,AUDIENCE_CITY,ONLINE_FOLLOWERS
InsightBreakdownValue	String	インサイトのブレークダウンの値。AUDIENCE_GENDER_AGE、AUDIENCE_COUNTRY、AUDIENCE_CITY に適用されます。
Period	String	インサイトの期間。これは行を（日、週、28 day もしくはLifetime）へのブレークダウンを管理します。これは常に指定する必要があります。AUDIENCE_GENDER_AGE、AUDIENCE_COUNTRY、およびAUDIENCE_CITY については、'lifetime' のみが有効です。 使用できる値は次のとおりです。day, week, days_28, lifetime
Timeframe	String	データをどこまで遡るかを指定。AUDIENCE_GENDER_AGE、AUDIENCE_COUNTRY、およびAUDIENCE_CITY では必須であり、これらのインサイトのFromDateTime およびToDateTime インプットの代わりとなります。 使用できる値は次のとおりです。last_14_days, last_30_days, last_90_days, prev_month, this_month, this_week
Target	String	インサイトのターゲット。この値は、Pages ビューのInstagramBusinessAccountId の値に対応しています。'Target IN (SELECT InstagramBusinessAccountId FROM Pages)' に設定することもできます。これは常に指定する必要があります。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

レスポンス内に1つの値を持つシンプルなインサイトの取得を許容します。

テーブル固有の情報

ページまたは投稿から取得できるPage and Post インサイト。これらのインサイトはレスポンスに1つの値を持ち、いくつかの値でのフィルタしかできません。

Select

Page and Post インサイトを選択する場合、常にTarget、InsightName、およびPeriod を指定します。次に例を示します。

SELECT * FROM PageAndPostInsights WHERE Target = 'mypageid' AND InsightName = 'PAGE_IMPRESSIONS' AND Period = 'day'

複数のインサイトを指定するには、IN 演算子を使用します。次に例を示します。

SELECT * FROM PageAndPostInsights WHERE Target = 'mypageid' AND InsightName IN ('PAGE_IMPRESSIONS', 'PAGE_ENGAGED_USERS') AND Period = 'day'

インサイトデータを取得する範囲を指定するには、StartTime およびEndTime を使用します。次に例を示します。

SELECT * FROM PageAndPostInsights WHERE Target = 'mypageid' AND InsightName = 'PAGE_IMPRESSIONS' AND Period = 'day' AND EndTime >= '12/1/2015' AND EndTime <= '12/31/2015'

Note： すべてのインサイトにおいてすべての期間が利用可能ではないことに注意してください。day/week/days_28 の使用をサポートするものもあれば、lifetime のみをサポートするものもあります。 対象のインサイトがサポートされている期間が不明な場合は、 https://developers.facebook.com/docs/graph-api/reference/insights を参照してください。

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータの最新の日付。
Value	Long	特異値レスポンスのインサイトカラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。 PAGE_ACTIONS_POST_REACTIONS_ANGER_TOTAL, PAGE_ACTIONS_POST_REACTIONS_HAHA_TOTAL, PAGE_ACTIONS_POST_REACTIONS_LIKE_TOTAL, PAGE_ACTIONS_POST_REACTIONS_LOVE_TOTAL, PAGE_ACTIONS_POST_REACTIONS_SORRY_TOTAL, PAGE_ACTIONS_POST_REACTIONS_WOW_TOTAL, PAGE_CONSUMPTIONS, PAGE_CONSUMPTIONS_UNIQUE, PAGE_ENGAGED_USERS, PAGE_FAN_ADDS, PAGE_FAN_ADDS_UNIQUE, PAGE_FAN_REMOVES, PAGE_FAN_REMOVES_UNIQUE, PAGE_FANS, PAGE_FANS_ONLINE, PAGE_FANS_ONLINE_PER_DAY, PAGE_IMPRESSIONS, PAGE_IMPRESSIONS_FREQUENCY_DISTRIBUTION, PAGE_IMPRESSIONS_ORGANIC, PAGE_IMPRESSIONS_ORGANIC_UNIQUE, PAGE_IMPRESSIONS_PAID, PAGE_IMPRESSIONS_PAID_UNIQUE, PAGE_IMPRESSIONS_UNIQUE, PAGE_IMPRESSIONS_VIRAL, PAGE_IMPRESSIONS_VIRAL_FREQUENCY_DISTRIBUTION, PAGE_IMPRESSIONS_VIRAL_UNIQUE, PAGE_IMPRESSIONS_NONVIRAL, PAGE_IMPRESSIONS_NONVIRAL_UNIQUE, PAGE_NEGATIVE_FEEDBACK, PAGE_NEGATIVE_FEEDBACK_UNIQUE, PAGE_PLACES_CHECKIN_MOBILE, PAGE_PLACES_CHECKIN_MOBILE_UNIQUE, PAGE_PLACES_CHECKIN_TOTAL, PAGE_PLACES_CHECKIN_TOTAL_UNIQUE, PAGE_POST_ENGAGEMENTS, PAGE_POSTS_IMPRESSIONS, PAGE_POSTS_IMPRESSIONS_ORGANIC, PAGE_POSTS_IMPRESSIONS_ORGANIC_UNIQUE, PAGE_POSTS_IMPRESSIONS_PAID, PAGE_POSTS_IMPRESSIONS_PAID_UNIQUE, PAGE_POSTS_IMPRESSIONS_UNIQUE, PAGE_POSTS_IMPRESSIONS_VIRAL, PAGE_POSTS_IMPRESSIONS_VIRAL_UNIQUE, PAGE_CONTENT_ACTIVITY, PAGE_VIDEO_COMPLETE_VIEWS_30S, PAGE_VIDEO_COMPLETE_VIEWS_30S_AUTOPLAYED, PAGE_VIDEO_COMPLETE_VIEWS_30S_CLICK_TO_PLAY, PAGE_VIDEO_COMPLETE_VIEWS_30S_ORGANIC, PAGE_VIDEO_COMPLETE_VIEWS_30S_PAID, PAGE_VIDEO_COMPLETE_VIEWS_30S_REPEAT_VIEWS, PAGE_VIDEO_COMPLETE_VIEWS_30S_UNIQUE, PAGE_VIDEO_REPEAT_VIEWS, PAGE_VIDEO_VIEWS, PAGE_VIDEO_VIEWS_AUTOPLAYED, PAGE_VIDEO_VIEWS_CLICK_TO_PLAY, PAGE_VIDEO_VIEWS_ORGANIC, PAGE_VIDEO_VIEWS_PAID, PAGE_VIDEO_VIEWS_UNIQUE, PAGE_VIEWS_TOTAL, PAGE_VIEWS_LOGGED_IN_TOTAL, PAGE_VIEWS_LOGGED_IN_UNIQUE, PAGE_VIEWS_LOGOUT, PAGE_VIEWS_UNIQUE, POST_CLICKS, POST_CLICKS_UNIQUE, POST_ENGAGED_USERS, POST_IMPRESSIONS, POST_IMPRESSIONS_FAN, POST_IMPRESSIONS_FAN_PAID, POST_IMPRESSIONS_FAN_PAID_UNIQUE, POST_IMPRESSIONS_FAN_UNIQUE, POST_IMPRESSIONS_ORGANIC, POST_IMPRESSIONS_ORGANIC_UNIQUE, POST_IMPRESSIONS_PAID, POST_IMPRESSIONS_PAID_UNIQUE, POST_IMPRESSIONS_UNIQUE, POST_IMPRESSIONS_VIRAL, POST_IMPRESSIONS_VIRAL_UNIQUE, POST_NEGATIVE_FEEDBACK, POST_NEGATIVE_FEEDBACK_UNIQUE, POST_ACTIVITY, POST_ACTIVITY_UNIQUE, POST_VIDEO_AVG_TIME_WATCHED, POST_VIDEO_COMPLETE_VIEWS_ORGANIC, POST_VIDEO_COMPLETE_VIEWS_ORGANIC_UNIQUE, POST_VIDEO_COMPLETE_VIEWS_PAID, POST_VIDEO_COMPLETE_VIEWS_PAID_UNIQUE, POST_VIDEO_LENGTH, POST_VIDEO_VIEW_TIME, POST_VIDEO_VIEW_TIME_ORGANIC, POST_VIDEO_VIEWS_10S, POST_VIDEO_VIEWS_10S_AUTOPLAYED, POST_VIDEO_VIEWS_10S_CLICKED_TO_PLAY, POST_VIDEO_VIEWS_10S_ORGANIC, POST_VIDEO_VIEWS_10S_PAID, POST_VIDEO_VIEWS_10S_SOUND_ON, POST_VIDEO_VIEWS_10S_UNIQUE, POST_VIDEO_VIEWS_ORGANIC, POST_VIDEO_VIEWS_ORGANIC_UNIQUE, POST_VIDEO_VIEWS_PAID, POST_VIDEO_VIEWS_PAID_UNIQUE, POST_VIDEO_VIEWS_SOUND_ON
Period	String	インサイトの期間。これは行を（日、週、28 day もしくはLifetime）へのブレークダウンを管理します。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

提供されたID に基づいてページをクエリします。

テーブル固有の情報

Facebook のPages は、1人のユーザーによって作成され、1人以上のユーザーによって維持されるページです。ユーザーと同様に、ページはID または画面名で参照できます。

Select

ページをクエリする場合、指定がない場合にはあなたが管理しているページがデフォルトで表示されます。そうでない場合は、ページのID を指定できます。次に例を示します。

SELECT * FROM Pages WHERE Id = 'facebook'

Columns

Name	Type	Description
ID [KEY]	String	ページのID。
Username	String	ページのユーザー名がある場合は、そのユーザー名。
Name	String	ページの名前。
Category	String	ページのカテゴリ。
Categories	String	複数のカテゴリがある場合は、ページに関連付けられたカテゴリの集計。
Link	String	ページへのリンク。
Picture	String	ページに対応するページのプロフィール写真へのリンク。
CoverId	String	ページのカバー写真のID。
CoverSource	String	ページのカバー写真のURL。
CoverOffsetY	String	ページのカバー写真のy軸オフセット。
CoverOffsetX	String	ページのカバー写真のx軸オフセット。
About	String	ページに関する基本情報。
Description	String	ページの説明がある場合は、その説明。
GeneralInfo	String	ページから提供される一般情報。
LocationStreet	String	ページの番地。
LocationCity	String	ページの市区町村。
LocationState	String	ページの状態。
LocationCountry	String	ページの国。
LocationZip	String	ページの郵便番号。
LocationLatitude	String	ページの緯度。
LocationLongitude	String	ページの経度。
StoreNumber	Integer	この場所ページの一意ストア番号（該当する場合）。
Phone	String	ページの電話番号がある場合は、その電話番号。
Website	String	ページのWebサイトへのリンク。
Likes	Integer	ページをいいね！した人の数。
Checkins	Integer	ページに関連付けられたスポットにチェックインしたユーザーの総数。
TalkingAboutCount	Integer	ページを話題にしているユーザーの数。
WereHereCount	Integer	このページの場所にいたユーザーの数（該当する場合）。
CanPost	Boolean	認証ユーザーがページに対応するページに投稿できるかどうかを示すboolean。
IsPublished	Boolean	ページに対応するページが公開されているかどうかを示すboolean。
IsCommunityPage	Boolean	これがコミュニティページかどうかを示すboolean。
PublicTransit	String	ページで公共交通を利用できる場合は、その公共交通。
ParkingStreet	Boolean	路上駐車できるかどうかを示すboolean。
ParkingLot	Boolean	駐車場があるかどうかを示すboolean。
ParkingValet	Boolean	係員付き駐車サービスがあるかどうかを示すboolean。
PromotionEligible	Boolean	投稿の宣伝適格ステータス。manage_pages アクセス許可が必要です。また、自身がページの管理者である必要があります。
PromotionIneligibleReason	String	投稿の宣伝に不適格の理由。manage_pages アクセス許可が必要です。また、自身がページの管理者である必要があります。
Founded	String	企業の設立日。企業に適用。
Mission	String	企業の使命。企業に適用。
Products	String	この企業の製品。企業に適用。
Hours	String	営業時間の集計。ビジネスとスポットに適用。
Attire	String	ビジネスの服装規定。レストランまたはナイトライフに適用。有効な値は、Casual、Dressy、またはUnspecified。
AcceptsCashOnly	Boolean	支払いオプションとして現金だけを受け付けるかどうか。レストランまたはナイトライフに適用。
AcceptsVisa	Boolean	支払いオプションとしてVisa を受け付けるかどうか。レストランまたはナイトライフに適用。
AcceptsAmericanExpress	Boolean	支払いオプションとしてAmerican Expressを受け付けるかどうか。レストランまたはナイトライフに適用。
AcceptsMasterCard	Boolean	支払いオプションとしてMasterCardを受け付けるかどうか。レストランまたはナイトライフに適用。
AcceptsDiscover	Boolean	支払いオプションとしてDiscoverを受け付けるかどうか。レストランまたはナイトライフに適用。
PriceRange	String	ビジネスの価格帯。レストランまたはナイトライフに適用。有効な値は、\$ (0-10)、\$\$ (10-30)、\$\$\$ (30-50)、\$\$\$\$ (50+)、またはUnspecified です。
TakesReservations	Boolean	レストランで予約が必要かどうか。レストランにのみ適用。
AllowsWalkins	Boolean	レストランで予約が不要かどうか。レストランにのみ適用。
AllowsGroups	Boolean	レストランで団体を受け入れるかどうか。レストランにのみ適用。
AllowsKids	Boolean	レストランで子供を受け入れるかどうか。レストランにのみ適用。
ProvidesTakeout	Boolean	レストランで持ち帰りサービスがあるかどうか。レストランにのみ適用。
ProvidesDelivery	Boolean	レストランでデリバリーサービスがあるかどうか。レストランにのみ適用。
ProvidesCatering	Boolean	レストランでケータリングサービスがあるかどうか。レストランにのみ適用。
HasWaiters	Boolean	レストランでウエイターがいるかどうか。レストランにのみ適用。
HasOutdoorSeating	Boolean	レストランで屋外座席があるかどうか。レストランにのみ適用。
ServesBreakfast	Boolean	レストランで朝食メニューがあるかどうか。レストランにのみ適用。
ServesLunch	Boolean	レストランで昼食メニューがあるかどうか。レストランにのみ適用。
ServesDinner	Boolean	レストランで夕食メニューがあるかどうか。レストランにのみ適用。
ServesCoffee	Boolean	レストランでカフェメニューがあるかどうか。レストランにのみ適用。
ServesDrinks	Boolean	レストランでアルコールメニューがあるかどうか。レストランにのみ適用。
CulinaryTeam	String	調理チーム。レストランまたはナイトライフに適用。
PharmaSafetyInfo	String	薬剤安全情報。製薬会社に適用。
Affiliation	String	この人の略歴。人物紹介ページに適用。
Birthday	String	この人の誕生日。人物紹介ページに適用。
PersonalInfo	String	個人情報。人物紹介ページに適用。
PersonalInterests	String	個人の趣味・関心。人物紹介ページに適用。
ArtistsWeLike	String	バンドが好きなアーティスト。バンドに適用。
BandInterests	String	バンドの趣味・関心。バンドに適用。
BandMembers	String	バンドのメンバー。バンドに適用。
Bio	String	バンドの略歴。バンドに適用。
BookingAgent	String	バンドのマネージャー。バンドに適用。
GeneralManager	String	ゼネラルマネージャー。レストランまたはナイトライフに適用。バンドに適用。
Hometown	String	バンドの出身地。バンドに適用。
PressContact	String	バンドのプレス窓口。バンドに適用。
RecordLabel	String	バンドのレコードレーベル。バンドに適用。
Awards	String	映画またはテレビ番組の受賞情報。映画およびテレビ番組に適用。
DirectedBy	String	映画またはテレビ番組のディレクター。映画およびテレビ番組に適用。
Genre	String	映画またはテレビ番組のジャンル。映画およびテレビ番組に適用。
Influences	String	バンドが影響を受けたもの。バンドに適用。
PlotOutline	String	映画またはテレビ番組のあらすじ。映画およびテレビ番組に適用。
ProducedBy	String	映画のプロデューサー。映画に適用。
ReleaseData	String	映画の公開日。映画およびテレビ番組に適用。
ScreenplayBy	String	映画の脚本家。映画およびテレビ番組に適用。
Starring	String	映画またはテレビ番組のキャスト。映画およびテレビ番組に適用。
Studio	String	撮影スタジオ。映画に適用。
Network	String	テレビ番組を放送するテレビネットワーク。テレビ番組に適用。
Schedule	String	テレビ番組の放送スケジュール。テレビ番組に適用。
Season	String	テレビ番組の現行シーズン。テレビ番組に適用。
WrittenBy	String	テレビ番組の脚本家。テレビ番組に適用。
Built	String	自動車の製造年に関する情報。自動車に適用。
Features	String	自動車の機能。自動車に適用。
MPG	String	自動車の燃費（マイル/ガロン）。自動車に適用。
Members	String	この組織のメンバー。チーム組織の紹介ページに適用。
InstagramBusinessAccountId	String	The business instagram account id associated with this page.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
offset	String	最初に返す結果。結果の手動ページングで使用されます。

ユーザーが現在のアプリケーションに付与した権限をクエリします。

Columns

Name	Type	Description
PermissionName [KEY]	String	権限の名前。
Status	String	要求された権限のステータス。

ターゲットに関連付けられた写真のクエリ。通常、写真情報へのアクセスには、user_photos アクセス許可が必要です。

テーブル固有の情報

Facebook のPhotos は、ユーザーによって（ページなどに）アップロードされた写真で、アルバムに含まれます。

Note： Facebook API の非推奨仕様により、ユーザープロファイルが定義された、またはデフォルトのターゲットであるComments、Photos、Posts、およびVideos ビューへのクエリは、以下のフィールドのデータを返さなくなりました。

• comments
• message_tags
• reactions
• sharedposts
• story
• story_tags
• to
• via

詳しくは、https://developers.facebook.com/docs/graph-api/changelog/version16.0 を参照してください。

Select

写真をクエリする場合は、ターゲットを指定します。ターゲットは、写真が関連付けられたユーザー、ページ、アルバム、またはイベントを表します。次に例を示します。

SELECT * FROM Photos WHERE Target = 'facebook'

ターゲットを指定しなかった場合は、現在の認証ユーザーがターゲットとして使用されます。

写真をクエリする場合は、CreatedTime またはUpdatedTime のいずれかを指定してエレメントを取得できます。次に例を示します。

SELECT * FROM Photos WHERE Target = 'mytarget' AND CreatedTime >= '1/1/2012' AND CreatedTime <= '10/1/2012'

Columns

Name	Type	Description
ID [KEY]	String	写真のID。
Target	String	投稿を取得するターゲットのID またはユーザー名、または投稿先のターゲットのID またはユーザー名。これには、アルバム、イベント、ページ、またはユーザーを指定できます。
FromId	String	写真をアップロードしたユーザーのID。
FromName	String	写真をアップロードしたユーザーの名前。
FromPicture	String	写真をアップロードしたユーザーの写真。
FromCategory	String	写真をアップロードしたユーザーのカテゴリ。FromCategory は、他のFrom* フィールドが選択されていない場合にのみ取得できます。
Link	String	Facebook内のこの写真へのリンク。
Name	String	写真の名前。
Picture	String	写真のサムネイルへのリンク。
Source	String	写真のソース画像。
Height	Integer	写真の高さ。
Width	Integer	写真の幅。
Position	Integer	アルバム内の写真の場所。
Icon	String	写真がニュースフィードに公開されるときにFacebookに表示されるアイコンへのリンク。
PlaceId	String	投稿に関連付けられた場所がある場合は、そのID。
PlaceName	String	投稿に関連付けられた場所がある場合は、その名前。
Images	String	写真に対応する4種類の画像の集計。
CommentsCount	Integer	写真に対するコメントの数。
LikesCount	Integer	写真がいいね！された回数。
CommentsData	String	この写真に対するコメントの集計。
LikesData	String	いいね！データの集計。
CreatedTime	Datetime	写真がアップロードされた時刻。
UpdatedTime	Datetime	写真が最後に更新された時刻。

提供されたID に基づいてスポットをクエリします。スポットはFacebook のページとして保存されます。

テーブル固有の情報

Facebook のPlaces は、地図上に記したり訪問することができるスポットです。通常、これには住所、座標、および基本情報が含まれます。

Select

スポットID がわかっている場合は、ID を指定すると特定のスポットに関する情報を取得できます。次に例を示します。

SELECT * FROM Places WHERE Id = '407032649344593'

ID が指定されない場合は、結果は返されません。

Columns

Name	Type	Description
ID [KEY]	String	スポットのID。
Username	String	スポットのページのユーザー名がある場合は、そのユーザー名。
Name	String	スポットの名前。
Category	String	スポットのカテゴリ。
Categories	String	複数のカテゴリがある場合は、ページに関連付けられたカテゴリの集計。
Link	String	スポットへのリンク。
LocationStreet	String	スポットの番地。
LocationCity	String	スポットの市区町村。
LocationState	String	スポットの都道府県。
LocationCountry	String	スポットの国。
LocationZip	String	スポットの郵便番号。
LocationLatitude	String	スポットの緯度。
LocationLongitude	String	スポットの経度。
Phone	String	スポットの電話番号がある場合は、その電話番号。
Picture	String	スポットに対応するページのプロフィール写真へのリンク。
About	String	スポットに関する基本情報。
Description	String	スポットの説明がある場合は、その説明。
Website	String	スポットのWebサイトへのリンク。
Likes	Integer	スポットをいいね！した人の数。
Checkins	Integer	スポットにチェックインしたユーザーの総数。
TalkingAboutCount	Integer	スポットを話題にしているユーザーの数。
CanPost	Boolean	認証ユーザーがスポットに対応するページに投稿できるかどうかを示すboolean。
IsPublished	Boolean	スポットに対応するページが公開されているかどうかを示すboolean。
IsCommunityPage	Boolean	これがコミュニティページかどうかを示すboolean。
PublicTransit	String	スポットで公共交通を利用できる場合は、その公共交通。
ParkingStreet	Boolean	路上駐車できるかどうかを示すboolean。
ParkingLot	Boolean	駐車場があるかどうかを示すboolean。
ParkingValet	Boolean	係員付き駐車サービスがあるかどうかを示すboolean。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
Distance	String	スポットを検索する場合に指定できるオプションの入力。これは、指定されたLocationLatitude およびLocationLongitude からの最大距離です（メートル単位）。
offset	String	最初に返す結果。結果の手動ページングで使用されます。

Facebook ページの評価のリスト。このビューには認証が必要です。

Columns

Name	Type	Description
Target	String	評価を取得するページのID または名前。
CreatedTime	Datetime	レビュアーがこのオブジェクトを評価した時刻。
HasRating	Boolean	評価が含まれているかどうかを示すboolean。（星1-5）。
HasReview	Boolean	評価にテキストが含まれているかどうかを示すboolean。
OpenGraphID	String	評価アクションによって生成されたOpen Graph story のID。
Rating	Integer	評価（星1-5）。
ReviewText	String	最後のメッセージが会話に投稿された時刻。
ReviewerID	String	オブジェクトを評価した人。
ReviewerName	String	オブジェクトを評価した人。

レスポンス内に1つの値を持つシンプルな動画インサイトの取得を許容します。

テーブル固有の情報

シンプル動画インサイトとは、動画から取得できるシンプルなインサイトを指します。これらのインサイトはレスポンスに1つの値を持ち、いくつかの値でのフィルタしかできません。

Select

シンプル動画インサイトを選択する場合は、Target を指定する必要があります。加えて、InsightName は常に指定される必要があります。次に例を示します。

SELECT * FROM SimpleVideoInsights WHERE Target = 'myvideoid' AND InsightName = 'TOTAL_VIDEO_VIEWS'

Note：他のインサイトタイプとは異なり、動画インサイトは動画のlifetime 全体でのみ有効です。ブレークダウンなどはできません。

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
Value	Long	特異値レスポンスのInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。 TOTAL_VIDEO_VIEWS, TOTAL_VIDEO_VIEWS_UNIQUE, TOTAL_VIDEO_VIEWS_AUTOPLAYED, TOTAL_VIDEO_VIEWS_CLICKED_TO_PLAY, TOTAL_VIDEO_VIEWS_SOUND_ON, TOTAL_VIDEO_COMPLETE_VIEWS, TOTAL_VIDEO_COMPLETE_VIEWS_UNIQUE, TOTAL_VIDEO_COMPLETE_VIEWS_AUTO_PLAYED, TOTAL_VIDEO_COMPLETE_VIEWS_CLICKED_TO_PLAY, TOTAL_VIDEO_10S_VIEWS, TOTAL_VIDEO_10S_VIEWS_UNIQUE, TOTAL_VIDEO_10S_VIEWS_auto_played, TOTAL_VIDEO_10S_VIEWS_CLICKED_TO_PLAY, TOTAL_VIDEO_10S_VIEWS_SOUND_ON, TOTAL_VIDEO_AVG_TIME_WATCHED, TOTAL_VIDEO_VIEW_TOTAL_TIME, TOTAL_VIDEO_IMPRESSIONS, TOTAL_VIDEO_IMPRESSIONS_UNIQUE, TOTAL_VIDEO_IMPRESSIONS_VIRAL_UNIQUE, TOTAL_VIDEO_IMPRESSIONS_VIRAL, TOTAL_VIDEO_IMPRESSIONS_FAN_UNIQUE, TOTAL_VIDEO_IMPRESSIONS_FAN

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

Query attachments from a post or comment.

Table Specific Information

StoryAttachments in Facebook are attachments associated with a particular user or page story, like a page post or comment.

Select

When querying StoryAttachments, the Target must be specified and set to that of a post or comment. For example, to retrieve all the attachments for a specific post, your SELECT statement could look something like this:

SELECT * FROM StoryAttachments WHERE Target = '15526475270_410830705612736'

Columns

Name	Type	Description
Target	String	The Id or username of the target you are retrieving the wall for.
Type	String	The type of post.
Link	String	The link attached to the post.
Name	String	The name of the link.
Caption	String	The caption of the link, which appears beneath the link name.
Description	String	A description of the link, appears beneath the link caption.
Source	String	A URL to a flash movie or video file embedded within the post.
ObjectId	String	The Facebook object Id for an uploaded photo or video.

ユーザー、またはページにタグ付けされた投稿、ステータス、写真、およびその他のエンティティ情報をクエリします。このビューは、ターゲットユーザーまたはターゲットページにタグ付けしたエントリだけが返される、ウォールコネクションの一部です。一般に、これはページにのみ使用できます。

Columns

Name	Type	Description
ID [KEY]	String	ユーザーまたはページにタグ付けしたエンティティのID。
Target	String	音楽の取得元になるユーザーのIdまたはユーザー名。
FromId	String	投稿を行ったユーザーのID。
FromName	String	投稿を行ったユーザーの名前。
FromPicture	String	投稿を行ったユーザーの写真。
Message	String	投稿または近況のメッセージがある場合は、そのメッセージ。
CommentsCount	Integer	投稿に対するコメントの数。
LikesCount	Integer	投稿がいいね！された回数。
SharesCount	Integer	投稿が共有された回数。
CreatedTime	Datetime	投稿の作成時刻。
UpdatedTime	Datetime	投稿が最後に更新された時刻。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
offset	String	最初に返す結果。結果の手動ページングで使用されます。

認証されたユーザーに関する基本情報を返します。

テーブル固有の情報

Facebook のUsers は、Facebook 内のさまざまなユーザーアカウントです。

Select

ユーザーを選択する場合は、ID を指定する必要があります。次に例を示します。

SELECT * FROM Posts WHERE Id = 'UserId'

ID が指定されない場合は、現在ログインしているユーザーの情報が返されます。

Columns

Name	Type	Description
ID [KEY]	String	ユーザーのID。
Name	String	ユーザーの氏名。
Picture	String	ユーザーの写真。
FirstName	String	ユーザーの名。
MiddleName	String	ユーザーのミドルネーム。
LastName	String	ユーザーの姓。
Birthday	String	ユーザーの誕生日。user_birthday アクセス許可が必要です。
Email	String	ユーザーのE メールアドレス。email アクセス許可が必要です。
HometownName	String	ユーザーの出身地名。user_hometown アクセス許可が必要です。
HometownId	String	ユーザーの出身地名。user_hometown アクセス許可が必要です。
LocationName	String	ユーザーの現在の市区町村名。user_location アクセス許可が必要です。
LocationId	String	ユーザーの現在の市区町村ID。user_location アクセス許可が必要です。

ストーリーアクションタイプごとの動画インサイトの取得を許容します。

テーブル固有の情報

アクションタイプによる動画インサイトとは、ストーリーの種類の合計を詳細に取得できる動画インサイトを指します。

Select

動画インサイトを選択する場合は、Target を指定する必要があります。

SELECT * FROM VideoInsightsByActionType WHERE Target = 'myvideoid'

Note：他のインサイトタイプとは異なり、動画インサイトは動画のlifetime 全体でのみ有効です。より小さな単位への分割はできません。

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
Like	Long	いいねの合計。
Comment	Long	コメントの合計。
Share	Long	シェアの合計。
Target	String	インサイトのターゲット。これは動画で、常に指定が必要です。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

ディストリビューションタイプごとの動画インサイトの取得を許容します。

テーブル固有の情報

リアクションタイプによる動画インサイトとは、さまざまなディストリビューションソースから動画が獲得したビューの情報を提供する動画インサイトを指します。

Select

動画インサイトを選択する場合は、Target を指定する必要があります。加えて、InsightName は常に指定される必要があります。次に例を示します。

SELECT * FROM VideoInsightsByDistributionType WHERE Target = 'myvideoid' AND InsightName = 'TOTAL_VIDEO_VIEWS_BY_DISTRIBUTION_TYPE'

Note：他のインサイトタイプとは異なり、動画インサイトは動画のlifetime 全体でのみ有効です。より小さな単位への分割はできません。

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
Page_Owned	Long	ページにより所有されているビュー。
Shared	Long	シェアされたビュー。
Crossposted	Long	クロス投稿された投稿のビュー。
Target	String	インサイトのターゲット。これは動画で、常に指定が必要です。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです。TOTAL_VIDEO_VIEWS_BY_DISTRIBUTION_TYPE、TOTAL_VIDEO_VIEW_TIME_BY_DISTRIBUTION_TYPE

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

リアクションタイプごとの動画インサイトの取得を許容します。

テーブル固有の情報

リアクションタイプによる動画インサイトとは、リアクションのタイプによって測定できる動画インサイトを指します。

Select

動画インサイトを選択する場合は、Target を指定する必要があります。次に例を示します。

SELECT * FROM VideoInsightsByReactionType WHERE Target = 'myvideoid'

Note：他のインサイトタイプとは異なり、動画インサイトは動画のlifetime 全体でのみ有効です。より小さな単位への分割はできません。

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
Like	Long	いいねリアクションの合計。
Love	Long	超いいねリアクションの合計。
Wow	Long	すごいねリアクションの合計。
Haha	Long	うけるねリアクションの合計。
Sorry	Long	悲しいねリアクションの合計。
Anger	Long	ひどいねリアクションの合計。
Target	String	インサイトのターゲット。これは動画で、常に指定が必要です。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。

Name	Type	Description
FromDateTime	String	収集されたインサイトデータの時刻の最小値。
ToDateTime	String	収集されたインサイトデータの時刻の最大値。

ターゲットからの動画をクエリします。通常は、user_videos アクセス許可が必要です。

テーブル固有の情報

Facebook のVideos は、ユーザーによってアップロードされた動画やFacebook 内のページにアップロードされた動画です。

Note： Facebook API の非推奨仕様により、ユーザープロファイルが定義された、またはデフォルトのターゲットであるComments、Photos、Posts、およびVideos ビューへのクエリは、以下のフィールドのデータを返さなくなりました。

• comments
• message_tags
• reactions
• sharedposts
• story
• story_tags
• to
• via

詳しくは、https://developers.facebook.com/docs/graph-api/changelog/version16.0 を参照してください。

Select

動画を選択する場合は、ターゲットを指定します。ターゲットは、動画をアップロードしたユーザーまたはページを表します。ターゲットを指定しなかった場合は、現在の認証ユーザーがターゲットとして使用されます。次に例を示します。

SELECT * FROM Videos WHERE Target = 'facebook'

ID がわかっている場合は、ID を指定して特定の動画に関する情報を取得できます。次に例を示します。

SELECT * FROM Videos WHERE Id = 'VideoId'

動画をクエリする場合は、CreatedTime またはUpdatedTime のいずれかを指定してエレメントを取得します。次に例を示します。

SELECT * FROM Videos WHERE Target = 'mytarget' AND CreatedTime >= '1/1/2012' AND CreatedTime <= '10/1/2012'

Columns

Name	Type	Description
ID [KEY]	String	動画のID。
Target	String	動画の取得元になるターゲットのIdまたはユーザー名。
FromId	String	動画をアップロードしたユーザーのID。
FromName	String	動画をアップロードしたユーザーの名前。
FromPicture	String	動画をアップロードしたユーザーの写真。
FromCategory	String	動画をアップロードしたユーザーのカテゴリ。FromCategory は、他のFrom* フィールドが選択されていない場合にのみ取得できます。
Description	String	動画の説明。
Picture	String	動画のサムネイルのURL。
Source	String	元の再生可能動画ファイルのURL。
EmbedHtml	String	Webページに埋め込んで動画を再生するためのHTML要素。
Icon	String	動画がフィードに公開されたときにFacebookに表示されるアイコン。
Format	String	動画に対応する4種類の形式の集計。
TagsData	String	動画内でタグ付けされたユーザーがいる場合は、その集計。
CommentsCount	Integer	動画に対するコメントの数。
LikesCount	Integer	動画がいいね！された回数。
CommentsData	String	動画に対するコメントの集計。
CreatedTime	Datetime	動画がアップロードされた時刻。
UpdatedTime	Datetime	動画が最後に更新された時刻。

ターゲットのウォールからの投稿をクエリします。

テーブル固有の情報

Facebook のWalls は、ユーザーのプロフィールやウォールに行われたさまざまな投稿やアップデートの集合です。

Select

ウォールから選択する場合は、ターゲットを指定します。ターゲットは、ウォールに関連付けることができるユーザー、ページ、グループ、アプリケーションなどの有効なエンティティを表します。ターゲットを指定しなかった場合は、現在の認証ユーザーがターゲットとして使用されます。次に例を示します。

SELECT * FROM Wall WHERE Target = 'facebook'

ウォールをクエリする場合は、CreatedTime またはUpdatedTime のいずれかを指定してエレメントを取得できます。次に例を示します。

SELECT * FROM Wall WHERE Target = 'facebook' AND CreatedTime >= '1/1/2012' AND CreatedTime <= '2/1/2012'

INSERT

ウォールに直接挿入されない場合でも、Posts テーブルを使うことで、正しいターゲットにINSERT を発行しウォールに投稿することができます。

Columns

Name	Type	Description
ID [KEY]	String	投稿のID。
Target	String	ウォールの取得元になるターゲットのIdまたはユーザー名。
FromId	String	投稿を行ったユーザーのID。
FromName	String	投稿を行ったユーザーの名前。
FromPicture	String	コメントを行ったユーザーの写真。
FromCategory	String	投稿を行ったユーザーのカテゴリ。FromCategory は、他のFrom* フィールドが選択されていない場合にのみ取得できます。
ToData	String	投稿先のユーザーの集計。
Message	String	投稿のメッセージ。
MessageTags	String	メッセージ内でタグ付けされたユーザー、ページなどのオブジェクトの集計。
Picture	String	投稿に含まれる写真へのリンク。
Icon	String	投稿のタイプを表すアイコンへのリンク。
Actions	String	投稿に対して実行できるアクション（コメント、いいね！など）の集計。
CommentsCount	Integer	投稿に対するコメントの数。
LikesCount	Integer	投稿がいいね！された回数。
SharesCount	Integer	投稿が共有された回数。
PlaceId	String	投稿に関連付けられた場所がある場合は、そのID。
PlaceName	String	投稿に関連付けられた場所がある場合は、その名前。
Attachments	String	投稿の添付ファイルの集計。
ApplicationId	String	この投稿が行われたアプリケーションのID。
ApplicationNamespace	String	エンティティの作成に使用されたアプリケーションに関する情報。
Story	String	ユーザーから意図せず生まれた記事。例えば、2人のユーザーが友達になったときに生まれた記事です。このような記事を取得するには、アプリで［最近のニュースフィード記事を含める］移行オプションを有効にする必要があります。
StoryTags	String	記事に関連付けられたオブジェクト（ユーザー、ページなど）の集計。
LikesData	String	いいね！データの集計。
CommentsData	String	この投稿に対するコメントの集計。
CreatedTime	Datetime	投稿の作成時刻。
UpdatedTime	Datetime	投稿が最後に更新された時刻。

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication

---

プロパティ	説明
AuthenticateAsPage	Facebook への要求時に認証するページの名前またはID。

OAuth

---

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
Scope	The scope to use when authenticating to Facebook.

SSL

---

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

Firewall

---

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

Proxy

---

プロパティ	説明
ProxyAutoDetect	これは、システムプロキシ設定を使用するかどうかを示します。
ProxyServer	HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
ProxyPort	ProxyServer プロキシが起動しているTCP ポート。
ProxyAuthScheme	ProxyServer プロキシへの認証で使われる認証タイプ。
ProxyUser	ProxyServer プロキシへの認証に使われるユーザー名。
ProxyPassword	ProxyServer プロキシへの認証に使われるパスワード。
ProxySSLType	ProxyServer プロキシへの接続時に使用するSSL タイプ。
ProxyExceptions	ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

Logging

---

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

Schema

---

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

Miscellaneous

---

プロパティ	説明
AggregateFormat	集計またはコレクションの列を返す場合の形式。
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
Pagesize	Facebook から返されるページあたりの結果の最大数。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Target	何も指定されなかった場合のデフォルトのターゲット。ターゲットを指定できるComments などの一部のテーブルで使用されます。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UploadLinkedMedia	新しい投稿を挿入する前に、リンクされた写真または動画をアップロードします。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

---

プロパティ	説明
AuthenticateAsPage	Facebook への要求時に認証するページの名前またはID。

Facebook への要求時に認証するページの名前またはID。

解説

データを取得するページのID。ページは認証されたユーザーにより管理されている必要があり、Pages ビューをクエリすることでそれらのすべてのページのID を取得することができます。

このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。

---

プロパティ	説明
OAuthClientId	OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。
OAuthClientSecret	OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。
Scope	The scope to use when authenticating to Facebook.

OAuth 認証サーバーを使用してアプリケーションを登録する場合に割り当てられたクライアントId。

解説

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId 値、およびクライアントシークレットOAuthClientSecret が提供されます。

OAuth 認証サーバーにアプリケーションを登録する場合に割り当てられたクライアントシークレット。

解説

OAuth アプリケーションの登録の一環として、コンシューマキーとも呼ばれるOAuthClientId が提供されます。また、コンシューマーシークレットと呼ばれるクライアントシークレットも提供されます。クライアントシークレットをOAuthClientSecret プロパティに設定します。

The scope to use when authenticating to Facebook.

解説

The scope that are used when authenticating to Facebook give your App access to request additional information that may be required for certain tables. Individual scope may be entered in a comma separated list. Leaving it blank will use the defaults. The Scope is only used if you have specified your own OAuthClientId and OAuthClientSecret.

Requesting Additional Permissions

You may find while using the Sync App that Facebook returns an error stating your app does not have permissions to do a certain action. To resolve this, you will need to generate a new OAuth access token with the required scope. Set the Scope property in the authentication step. You can find a list of available Facebook scopes here: http://developers.facebook.com/docs/authentication/permissions/. Permissions that may be required depending on your use case are:

user_birthday, user_photos, user_videos, user_likes, user_hometown, user_location, read_insights, pages_manage_metadata, pages_read_engagement, pages_read_user_content, pages_messaging, business_management, instagram_basic, instagram_manage_insights

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。

---

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。

解説

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：

説明	例
フルPEM 証明書（例では省略されています）	-----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
証明書を保有するローカルファイルへのパス。	C:\cert.cer
公開鍵（例では省略されています）	-----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
MD5 Thumbprint （hex 値はスペースおよびコロン区切り）	ecadbdda5a1529c58a1e9e09828d70e4
SHA1 Thumbprint （hex 値はスペースおよびコロン区切り）	34a929226ae0819f2ec14b4a3d904f801cbb150d

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。

---

プロパティ	説明
FirewallType	プロキシベースのファイアウォールで使われるプロトコル。
FirewallServer	プロキシベースのファイアウォールの名前もしくはIP アドレス。
FirewallPort	プロキシベースのファイアウォールのTCP ポート。
FirewallUser	プロキシベースのファイアウォールに認証するために使うユーザー名。
FirewallPassword	プロキシベースのファイアウォールへの認証に使われるパスワード。

プロキシベースのファイアウォールで使われるプロトコル。

解説

このプロパティは、Sync App がFirewallServer プロキシ経由でトンネルトラフィックを使うためのプロトコルを指定します。デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し次のプロキシタイプのどれかで接続するには、ProxyAutoDetect をfalse に設定します。

タイプ	デフォルトポート	説明
TUNNEL	80	これが設定されている場合、Sync App はFacebook への接続を開き、プロキシを経由して通信が行われます。
SOCKS4	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 4 プロキシ経由で送信し、接続リクエストが許容されるかどうかを決定します。
SOCKS5	1080	これが設定されている場合、Sync App はデータをFirewallServer およびFirewallPort で指定されたSOCS 5 プロキシ経由で送信します。プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

プロキシベースのファイアウォールの名前もしくはIP アドレス。

解説

ファイアウォールトラバーサルを許容するために設定するIP アドレス、DNS 名、もしくはプロキシホスト名を指定するプロパティです。プロトコルはFirewallType で指定されます。このプロパティとFirewallServer を使って、SOCKS 経由での接続、もしくはトンネリングが可能です。HTTP プロキシへの接続には、ProxyServer を使用します。

Sync App はデフォルトでシステムプロキシを使うので注意してください。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定してください。

プロキシベースのファイアウォールのTCP ポート。

解説

ファイアウォールトラバーサルを許容するために設定するプロキシベースのファイアウォールのTCP ポート。名前もしくはIP アドレスを指定するには、FirewallServer を使います。FirewallType でプロトコルを指定します。

プロキシベースのファイアウォールに認証するために使うユーザー名。

解説

FirewallUser およびFirewallPassword プロパティは、FirewallType により指定された認証方式に則り、FirewallServer、およびFirewallPort で指定されたプロキシに対しての認証に使われます。

プロキシベースのファイアウォールへの認証に使われるパスワード。

解説

このプロパティは、FirewallType により指定された認証メソッドに則り、FirewallServer およびFirewallPort で指定されたプロキシに渡されます。

このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。

---

プロパティ	説明
ProxyAutoDetect	これは、システムプロキシ設定を使用するかどうかを示します。
ProxyServer	HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
ProxyPort	ProxyServer プロキシが起動しているTCP ポート。
ProxyAuthScheme	ProxyServer プロキシへの認証で使われる認証タイプ。
ProxyUser	ProxyServer プロキシへの認証に使われるユーザー名。
ProxyPassword	ProxyServer プロキシへの認証に使われるパスワード。
ProxySSLType	ProxyServer プロキシへの接続時に使用するSSL タイプ。
ProxyExceptions	ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

これは、システムプロキシ設定を使用するかどうかを示します。

解説

これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。

解説

HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。HTTP プロキシへの認証には、Sync App はHTTP、Windows(NTLM)、もしくはKerberos 認証タイプを使用することができます。

SOCKS プロキシを経由して接続する、もしくは接続をトンネルするには、FirewallType を参照してください。

デフォルトで、Sync App はsystem プロキシを使います。他のプロキシを使う場合には、ProxyAutoDetect をfalse に設定します。

ProxyServer プロキシが起動しているTCP ポート。

解説

HTTP トラフィックをリダイレクトするHTTP プロキシが実行されているポート。ProxyServer でHTTP プロキシを指定します。その他のプロキシタイプについては、FirewallType を参照してください。

ProxyServer プロキシへの認証で使われる認証タイプ。

解説

この値は、ProxyServer およびProxyPort で指定されるHTTP プロキシに認証するために使われる認証タイプを指定します。

Sync App は、デフォルトでsystem proxy settings を使い、追加での設定が不要です。他のプロキシへの接続をする場合には、ProxyServer およびProxyPort に加え、ProxyAutoDetect をfalse に設定します。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

認証タイプは、次のどれかになります。

• BASIC： Sync App はHTTP BASIC 認証を行います。
• DIGEST： Sync App はHTTP DIGEST 認証を行います。
• NEGOTIATE： Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
• PROPRIETARY： Sync App はNTLM もしくはKerberos トークンを発行しません。このトークンを、HTTP リクエストのAuthorization ヘッダーに含める必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

ProxyServer プロキシへの認証に使われるユーザー名。

解説

ProxyUser および ProxyPassword オプションは、ProxyServer で指定されたHTTP プロキシに対して接続および認証するために使用されます。

ProxyAuthScheme で使用可能な認証タイプを選択することができます。HTTP 認証を使う場合、これをHTTP プロキシで識別可能なユーザーのユーザー名に設定します。Windows もしくはKerberos 認証を使用する場合、このプロパティを次の形式のどれかでユーザー名に設定します。

user@domain
domain\user

ProxyServer プロキシへの認証に使われるパスワード。

解説

このプロパティは、NTLM(Windows)、Kerberos、もしくはHTTP 認証をサポートするHTTP プロキシサーバーに認証するために使われます。HTTP プロキシを指定するためには、ProxyServer およびProxyPort を設定します。認証タイプを指定するためにはProxyAuthScheme を設定します。

HTTP 認証を使う場合、さらにHTTP プロキシにProxyUser およびProxyPassword を設定します。

NTLM 認証を使う場合、Windows パスワードにProxyUser およびProxyPassword を設定します。Kerberos 認証には、これらを入力する必要があります。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

デフォルトで、Sync App はsystem プロキシを使います。他のプロキシに接続する場合には、これをfalse に設定します。

ProxyServer プロキシへの接続時に使用するSSL タイプ。

解説

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この値は、AUTO、ALWAYS、NEVER、TUNNEL のいずれかです。有効な値は次のとおりです。

AUTO	デフォルト設定。URL がHTTPS URL の場合、Sync App は、TUNNEL オプションを使います。URL がHTTP URL の場合、コンポーネントはNEVER オプションを使います。
ALWAYS	接続は、常にSSL 有効となります。
NEVER	接続は、SSL 有効になりません。
TUNNEL	接続は、トンネリングプロキシを経由します。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。

ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

解説

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

Sync App は、追加設定なしにデフォルトでシステムのプロキシ設定を使います。この接続のプロキシ例外を明示的に構成するには、ProxyAutoDetect をfalse に設定して、ProxyServer およびProxyPort を設定する必要があります。認証するには、ProxyAuthScheme を設定し、必要な場合にはProxyUser およびProxyPassword を設定します。

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。

---

プロパティ	説明
LogModules	ログファイルに含めるコアモジュール。

ログファイルに含めるコアモジュール。

解説

指定された（';' で区切られた）モジュールのみがログファイルに含まれます。デフォルトではすべてのモジュールが含まれます。

概要はログ ページを参照してください。

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。

---

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。
BrowsableSchemas	このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。
Views	使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリへのパス。

解説

Sync App のスキーマファイル（テーブルとビューの場合は.rsd ファイル、ストアドプロシージャの場合は.rsb ファイル）を含むディレクトリへのパス。このフォルダの場所は、実行ファイルの場所からの相対パスにすることができます。Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

指定しない場合、デフォルトの場所は"%APPDATA%\\CData\\Facebook Data Provider\\Schema" となり、%APPDATA% はユーザーのコンフィギュレーションディレクトリに設定されます：

Platform	%APPDATA%
Windows	APPDATA 環境変数の値
Linux	~/.config

このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、 パフォーマンスが向上します。

このプロパティは、使用可能なテーブルのサブセットにレポートされるテーブルを制限します。例えば、Tables=TableA,TableB,TableC です。

解説

テーブルを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でテーブルのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

使用可能なテーブルのサブセットにレポートされるビューを制限します。例えば、Views=ViewA,ViewB,ViewC です。

解説

ビューを複数のデータベースからリストすると、負荷がかかる可能性があります。接続文字列でビューのリストを提供すると、Sync App のパフォーマンスが向上します。

このプロパティは、作業したいビューがすでにわかっていて、ビューが多すぎる場合に、ビューを自動的にリストする代わりに使用することもできます。

カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

複数のスキーマまたはカタログを持つデータソースに接続する場合は、複数のカタログやスキーマに存在するテーブル間の曖昧さを避けるため、最後の例のように、このプロパティにテーブルの完全修飾名を指定する必要があることに注意してください。

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。

---

プロパティ	説明
AggregateFormat	集計またはコレクションの列を返す場合の形式。
MaxRows	クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
Pagesize	Facebook から返されるページあたりの結果の最大数。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Target	何も指定されなかった場合のデフォルトのターゲット。ターゲットを指定できるComments などの一部のテーブルで使用されます。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UploadLinkedMedia	新しい投稿を挿入する前に、リンクされた写真または動画をアップロードします。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

集計またはコレクションの列を返す場合の形式。

解説

集計またはコレクションの列を返す場合の形式。

クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。

解説

クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。

これらの隠しプロパティは特定のユースケースでのみ使用されます。

解説

以下にリストされているプロパティは、特定のユースケースで使用可能です。通常のドライバーのユースケースおよび機能では、これらのプロパティは必要ありません。

複数のプロパティをセミコロン区切りリストで指定します。

統合およびフォーマット

DefaultColumnSize	データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT	日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。
RecordToFile=filename	基底のソケットデータ転送を指定のファイルに記録します。

Facebook から返されるページあたりの結果の最大数。

解説

Pagesize プロパティは、Facebook から返されるページあたりの結果の最大数に影響を与えます。時折、要求するデータを少なくすることを要求するエラーが出ることがあります。 ページサイズを減らすことでそのようなエラーの発生頻度を下げることが可能です。 最大ページサイズはページあたり100であることが多いです。

このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。

解説

Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。

何も指定されなかった場合のデフォルトのターゲット。ターゲットを指定できるComments などの一部のテーブルで使用されます。

解説

何も指定されなかった場合のデフォルトのターゲット。ターゲットを指定できるComments などの一部のテーブルで使用されます。

タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。

解説

Timeout が0に設定されている場合は、操作がタイムアウトしません。処理が正常に完了するか、エラー状態になるまで実行されます。

Timeout の有効期限が切れても処理が完了していない場合は、Sync App は例外をスローします。

新しい投稿を挿入する前に、リンクされた写真または動画をアップロードします。

解説

UploadLinkedMedia は、投稿を挿入する前にメディアをアップロードするかどうかを決定します。True に設定すると、Link カラムで新しい投稿を挿入しようとすると、ドライバーは最初にURL が写真もしくは動画を参照しているかどうかを判断します。 参照している場合は、最初に写真または動画がアップロードされ、次にそのメディアを含む新しい投稿が作成されます。False の場合、新しい投稿はリンク投稿として作成されます。

カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

解説

ユーザー定義ビューは、UserDefinedViews.json というJSON 形式のコンフィギュレーションファイルで定義されています。Sync App は、このファイルで指定されたビューを自動的に検出します。

また、複数のビュー定義を持ち、UserDefinedViews 接続プロパティを使用して制御することも可能です。このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。

このユーザー定義ビューのコンフィギュレーションファイルは、次のようにフォーマットされています。

• 各ルートエレメントはビューの名前を定義します。
• 各ルートエレメントには、query と呼ばれる子エレメントが含まれており、この子エレメントにはビューのカスタムSQL クエリが含まれています。

次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM Posts WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

UserDefinedViews 接続プロパティを使用して、JSON コンフィギュレーションファイルの場所を指定します。次に例を示します。

"UserDefinedViews", C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json

指定されたパスは引用符で囲まれていないことに注意してください。