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

必須プロパティは［設定］タブにリストされています。［Advanced］タブには、通常は必要ない接続プロパティが表示されます。

Facebook への接続

以下はオプションの接続プロパティです。

• Target：Facebook テーブルのいくつかはターゲットによりフィルタリング可能です。例えば、動画のコメントを取得するには、ターゲットとして動画のID を指定します。このプロパティは、クエリ結果を指定されたターゲットに合致するレコードに限定することを可能にします。Target カラムを使ってクエリ毎にこの制限をかけることができます。
• AggregateFormat：Sync App は、文字列集合としていくつかのカラムを返します。例えば、エンティティのいいねデータは集計されて返されます。デフォルトでは、Sync App はJSON で集計カラムを返します。集計をXML で返すことも可能です。
• Version：デフォルトではないバージョンを使う場合には、このプロパティをFacebook API バージョンに設定します。

Facebook への認証

Facebook はユーザー認証にOAuth 標準を使用しています。

OAuth

すべてのOAuth フローで、AuthScheme をOAuth に設定する必要があります。以下のセクションは、すでに設定済みであることを前提として書かれています。

Web アプリケーション

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

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

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

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

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

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 プロパティを設定します。

Web アプリケーションは、リクエストしたいアクセス許可のインプットを持つGetOAuthAuthorizationURL およびGetOAuthAccessToken ストアドプロシージャを呼び出す必要があります。

これらはカンマで区切られたアクセス許可のリストで、一回の認可要求で複数を要求することができます。 利用可能なFacebook アクセス許可のリストはこちらで確認できます。

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

AuthenticateAsPage プロパティ

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

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

ページとして投稿

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

自動ページ

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

Facebook インサイトで使用可能な期間、使用できるビュー、使用できるターゲットなどのマッピングを以下に示します。 Facebook によって利用可能なインサイトが頻繁に変更されるため、Facebook から最近削除されたインサイトを示す表と、インサイトの名前が変更されている場合は変更前のインサイト名を表示します。

現在のインサイト

ビューまたはストアドプロシージャ	インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
SimpleInsights	PAGE_ACTIONS_POST_REACTIONS_ANGER_TOTAL	day	page
SimpleInsights	PAGE_ACTIONS_POST_REACTIONS_HAHA_TOTAL	day	page
SimpleInsights	PAGE_ACTIONS_POST_REACTIONS_LIKE_TOTAL	day	page
SimpleInsights	PAGE_ACTIONS_POST_REACTIONS_LOVE_TOTAL	day	page
SimpleInsights	PAGE_ACTIONS_POST_REACTIONS_SORRY_TOTAL	day	page
SimpleInsights	PAGE_ACTIONS_POST_REACTIONS_WOW_TOTAL	day	page
SimpleInsights	PAGE_CONSUMPTIONS	day, week, days_28	page
SimpleInsights	PAGE_CONSUMPTIONS_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_ENGAGED_USERS	day, week, days_28	page
SimpleInsights	PAGE_FAN_ADDS	day	page
SimpleInsights	PAGE_FAN_ADDS_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_FAN_REMOVES	day	page
SimpleInsights	PAGE_FAN_REMOVES_UNIQUE	day	page
SimpleInsights	PAGE_FANS	day	page
SimpleInsights	PAGE_FANS_ONLINE	day	page
SimpleInsights	PAGE_FANS_ONLINE_PER_DAY	day	page
SimpleInsights	PAGE_IMPRESSIONS	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_FREQUENCY_DISTRIBUTION	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_ORGANIC	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_ORGANIC_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_PAID	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_PAID_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_VIRAL	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_VIRAL_FREQUENCY_DISTRIBUTION	day, week, days_28	page
SimpleInsights	PAGE_IMPRESSIONS_VIRAL_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_NEGATIVE_FEEDBACK	day, week, days_28	page
SimpleInsights	PAGE_NEGATIVE_FEEDBACK_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_PLACES_CHECKIN_MOBILE	day, week, days_28	page
SimpleInsights	PAGE_PLACES_CHECKIN_MOBILE_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_PLACES_CHECKIN_TOTAL	day, week, days_28	page
SimpleInsights	PAGE_PLACES_CHECKIN_TOTAL_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS_ORGANIC	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS_ORGANIC_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS_PAID	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS_PAID_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS_VIRAL	day, week, days_28	page
SimpleInsights	PAGE_POSTS_IMPRESSIONS_VIRAL_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_CONTENT_ACTIVITY	day, week, days_28	page	PAGE_STORIES
SimpleInsights	PAGE_VIDEO_COMPLETE_VIEWS_30S	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_COMPLETE_VIEWS_30S_AUTOPLAYED	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_COMPLETE_VIEWS_30S_CLICK_TO_PLAY	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_COMPLETE_VIEWS_30S_ORGANIC	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_COMPLETE_VIEWS_30S_PAID	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_COMPLETE_VIEWS_30S_REPEAT_VIEWS	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_COMPLETE_VIEWS_30S_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_REPEAT_VIEWS	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_VIEWS	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_VIEWS_AUTOPLAYED	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_VIEWS_CLICK_TO_PLAY	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_VIEWS_ORGANIC	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_VIEWS_PAID	day, week, days_28	page
SimpleInsights	PAGE_VIDEO_VIEWS_UNIQUE	day, week, days_28	page
SimpleInsights	PAGE_VIEWS_TOTAL	day, week, days_28	page	PAGE_VIEWS
SimpleInsights	PAGE_VIEWS_LOGGED_IN_TOTAL	day, week, days_28	page	PAGE_VIEWS_LOGIN
SimpleInsights	PAGE_VIEWS_LOGGED_IN_UNIQUE	day, week, days_28	page	PAGE_VIEWS_LOGIN_UNIQUE
SimpleInsights	PAGE_VIEWS_LOGOUT	day	page
SimpleInsights	POST_CLICKS	lifetime	post	POST_CONSUMPTIONS
SimpleInsights	POST_CLICKS_UNIQUE	lifetime	post	POST_CONSUMPTIONS_UNIQUE
SimpleInsights	POST_ENGAGED_USERS	lifetime	post
SimpleInsights	POST_IMPRESSIONS	lifetime	post
SimpleInsights	POST_IMPRESSIONS_FAN	lifetime	post
SimpleInsights	POST_IMPRESSIONS_FAN_PAID	lifetime	post
SimpleInsights	POST_IMPRESSIONS_FAN_PAID_UNIQUE	lifetime	post
SimpleInsights	POST_IMPRESSIONS_FAN_UNIQUE	lifetime	post
SimpleInsights	POST_IMPRESSIONS_ORGANIC	lifetime	post
SimpleInsights	POST_IMPRESSIONS_ORGANIC_UNIQUE	lifetime	post
SimpleInsights	POST_IMPRESSIONS_PAID	lifetime	post
SimpleInsights	POST_IMPRESSIONS_PAID_UNIQUE	lifetime	post
SimpleInsights	POST_IMPRESSIONS_UNIQUE	lifetime	post
SimpleInsights	POST_IMPRESSIONS_VIRAL	lifetime	post
SimpleInsights	POST_IMPRESSIONS_VIRAL_UNIQUE	lifetime	post
SimpleInsights	POST_NEGATIVE_FEEDBACK	lifetime	post
SimpleInsights	POST_NEGATIVE_FEEDBACK_UNIQUE	lifetime	post
SimpleInsights	POST_ACTIVITY	lifetime	post	POST_STORIES
SimpleInsights	POST_ACTIVITY_UNIQUE	lifetime	post	POST_STORYTELLERS
SimpleInsights	POST_VIDEO_AVG_TIME_WATCHED	lifetime	post
SimpleInsights	POST_VIDEO_COMPLETE_VIEWS_ORGANIC	lifetime	post
SimpleInsights	POST_VIDEO_COMPLETE_VIEWS_ORGANIC_UNIQUE	lifetime	post
SimpleInsights	POST_VIDEO_COMPLETE_VIEWS_PAID	lifetime	post
SimpleInsights	POST_VIDEO_COMPLETE_VIEWS_PAID_UNIQUE	lifetime	post
SimpleInsights	POST_VIDEO_LENGTH	lifetime	post
SimpleInsights	POST_VIDEO_VIEW_TIME	lifetime	post
SimpleInsights	POST_VIDEO_VIEW_TIME_ORGANIC	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_10S	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_10S_AUTOPLAYED	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_10S_CLICKED_TO_PLAY	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_10S_ORGANIC	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_10S_PAID	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_10S_SOUND_ON	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_10S_UNIQUE	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_ORGANIC	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_ORGANIC_UNIQUE	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_PAID	lifetime	post
SimpleInsights	POST_VIDEO_VIEWS_PAID_UNIQUEPOST_VIDEO_VIEWS_SOUND_ON	lifetime	post
InsightsByConsumptionType	PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE	day, week, days_28	page
InsightsByConsumptionType	PAGE_CONSUMPTIONS_BY_CONSUMPTION_TYPE_UNIQUE	day, week, days_28	page
InsightsByConsumptionType	POST_CLICKS_BY_TYPE	lifetime	post	POST_CONSUMPTIONS_BY_CONSUMPTION_TYPE
InsightsByConsumptionType	POST_CLICKS_BY_TYPE_UNIQUE	lifetime	post	POST_CONSUMPTIONS_BY_CONSUMPTION_TYPE_UNIQUE
InsightsByFeedbackType	PAGE_NEGATIVE_FEEDBACK_BY_TYPE	day, week, days_28	page
InsightsByFeedbackType	PAGE_NEGATIVE_FEEDBACK_BY_TYPE_UNIQUE	day, week, days_28	page
InsightsByFeedbackType	PAGE_POSITIVE_FEEDBACK_BY_TYPE	day, week, days_28	page
InsightsByFeedbackType	PAGE_POSITIVE_FEEDBACK_BY_TYPE_UNIQUE	day, week, days_28	page
InsightsByFeedbackType	POST_NEGATIVE_FEEDBACK_BY_TYPE	lifetime	post
InsightsByFeedbackType	POST_NEGATIVE_FEEDBACK_BY_TYPE_UNIQUE	lifetime	post
InsightsByLikeSourceType	PAGE_FANS_BY_LIKE_SOURCE	day	page
InsightsByLikeSourceType	PAGE_FANS_BY_LIKE_SOURCE_UNIQUE	day	page
InsightsByUnLikeSourceType	PAGE_FANS_BY_UNLIKE_SOURCE	day	page
InsightsByUnLikeSourceType	PAGE_FANS_BY_UNLIKE_SOURCE_UNIQUE	day	page
InsightsByReactionTotals	PAGE_ACTIONS_POST_REACTIONS_TOTAL	day	page
InsightsByReactionTotals	POST_REACTIONS_BY_TYPE_TOTAL	day	page
InsightsByStoryType	PAGE_CONTENT_ACTIVITY_BY_ACTION_TYPE	day, week, days_28	page	PAGE_STORIES_BY_STORY_TYPE
InsightsByStoryType	PAGE_IMPRESSIONS_BY_STORY_TYPE	day, week, days_28	page
InsightsByStoryType	PAGE_IMPRESSIONS_BY_STORY_TYPE_UNIQUE	day, week, days_28	page
InsightsByStoryType	POST_IMPRESSIONS_BY_STORY_TYPE	day, week, days_28	page
InsightsByStoryType	POST_IMPRESSIONS_BY_STORY_TYPE_UNIQUE	day, week, days_28	page
InsightsByTabType	PAGE_TAB_VIEWS_LOGIN_TOP_UNIQUE	day, week	page
InsightsByTabType	PAGE_TAB_VIEWS_LOGIN_TOP	day, week	page
InsightsByTabType	PAGE_TAB_VIEWS_LOGOUT_TOP	day	page
SimpleVideoInsights	PAGE_VIDEO_VIEW_TIME	day	page
SimpleVideoInsights	TOTAL_VIDEO_VIEWS	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_VIEWS_UNIQUE	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_VIEWS_AUTOPLAYED	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_VIEWS_CLICKED_TO_PLAY	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_VIEWS_SOUND_ON	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_COMPLETE_VIEWS	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_COMPLETE_VIEWS_UNIQUE	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_COMPLETE_VIEWS_AUTO_PLAYED	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_COMPLETE_VIEWS_CLICKED_TO_PLAY	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_10S_VIEWS	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_10S_VIEWS_UNIQUE	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_10S_VIEWS_auto_played	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_10S_VIEWS_CLICKED_TO_PLAY	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_10S_VIEWS_SOUND_ON	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_AVG_TIME_WATCHED	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_VIEW_TOTAL_TIME	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_IMPRESSIONS	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_IMPRESSIONS_UNIQUE	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_IMPRESSIONS_VIRAL_UNIQUE	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_IMPRESSIONS_VIRAL	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_IMPRESSIONS_FAN_UNIQUE	lifetime	video
SimpleVideoInsights	TOTAL_VIDEO_IMPRESSIONS_FAN	lifetime	video
VideoInsightsByActionType	TOTAL_VIDEO_STORIES_BY_ACTION_TYPE	lifetime	video
VideoInsightsByDistributionType	TOTAL_VIDEO_VIEWS_BY_DISTRIBUTION_TYPE	lifetime	video
VideoInsightsByDistributionType	TOTAL_VIDEO_VIEW_TIME_BY_DISTRIBUTION_TYPE	lifetime	video
VideoInsightsByReactionType	TOTAL_VIDEO_REACTIONS_BY_TYPE_TOTAL	lifetime	video
CreateInsightSchema	PAGE_CONTENT_ACTIVITY_BY_AGE_GENDER_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_AGE_GENDER
CreateInsightSchema	PAGE_CONTENT_ACTIVITY_BY_CITY_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_CITY
CreateInsightSchema	PAGE_CONTENT_ACTIVITY_BY_COUNTRY_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_COUNTRY
CreateInsightSchema	PAGE_CONTENT_ACTIVITY_BY_LOCALE_UNIQUE	day, week, days_28	page	PAGE_STORYTELLERS_BY_LOCALE
CreateInsightSchema	PAGE_IMPRESSIONS_BY_CITY_UNIQUE	day, week, days_28	page
CreateInsightSchema	PAGE_IMPRESSIONS_BY_COUNTRY_UNIQUE	day, week, days_28	page
CreateInsightSchema	PAGE_IMPRESSIONS_BY_LOCALE_UNIQUE	day, week, days_28	page
CreateInsightSchema	PAGE_IMPRESSIONS_BY_AGE_GENDER_UNIQUE	day, week, days_28	page
CreateInsightSchema	PAGE_PLACES_CHECKINS_BY_AGE_GENDER	day	page
CreateInsightSchema	PAGE_PLACES_CHECKINS_BY_LOCALE	day	page
CreateInsightSchema	PAGE_PLACES_CHECKINS_BY_COUNTRY	day	page
CreateInsightSchema	PAGE_FANS_LOCALE	day	page
CreateInsightSchema	PAGE_FANS_CITY	day	page
CreateInsightSchema	PAGE_FANS_COUNTRY	day	page
CreateInsightSchema	PAGE_FANS_GENDER_AGE	day	page
CreateInsightSchema	PAGE_VIEWS_EXTERNAL_REFERRALS	day	page
CreateInsightSchema	POST_STORIES_BY_ACTION_TYPE	lifetime	post
CreateInsightSchema	POST_STORYTELLERS_BY_ACTION_TYPE	lifetime	post
CreateInsightSchema	PAGE_POSTS_IMPRESSIONS_FREQUENCY_DISTRIBUTION	day, week, days_28	post
CreateInsightSchema	POST_VIDEO_RETENTION_GRAPH	lifetime	post

Facebook によって削除されたインサイト

ビューまたはストアドプロシージャ	インサイト名	使用可能な期間	ターゲットタイプ
SimpleInsights	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 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 テーブルのクエリは、リレーショナルデータベースのテーブルのクエリと同じです。時には特別なケースもあります。例えば、テーブルの特定のカラムデータを取得するために特定のカラムをWHERE 句に含める必要がある場合などです。これは通常、特定のカラムを取得するために行ごとに個別のリクエストを行う必要がある場合に必要です。これらの特別な状況は、以下にリンクされているテーブルページの上部に明確に文書化されています。

Facebook Connector for CData Sync テーブル

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

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

テーブル固有の情報

Facebook のLikes は、特定のターゲットをいいね！したユーザーを表します。ターゲットには、投稿、写真などのいいね！を関連付けることができる有効なエンティティを指定できます。Facebook の新しいページエクスペリエンスでページのいいね！などのリアクションを照会したい場合は、SimpleInsights テーブルを参照してください。

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

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'

Insert

投稿を挿入するには、投稿の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')

Update

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

Delete

投稿を削除するには、投稿の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 アクセス許可が必要です。

ビューは、カラムと疑似カラムで構成されます。ビューは、データを示すという点でテーブルに似ていますが、ビューでは更新はサポートされません。通常、ビューとして表されるエンティティは、読み取り専用のエンティティです。多くの場合、これらのデータはストアドプロシージャを使用することで更新できます（その機能がデータソースに適用できる場合）。

ビューに対しては、通常のテーブルと同じようにクエリを実行でき、このときに返されるデータも同様です。

ビューとして公開されるクエリなどの動的ビューや、project_team ワークアイテムの特定の組み合わせを検索するためのビューがサポートされています。

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 スコープが必須です。
Pages	提供されたID に基づいてページをクエリします。
Permissions	ユーザーが現在のアプリケーションに付与した権限をクエリします。
Photos	ターゲットに関連付けられた写真のクエリ。通常、写真情報へのアクセスには、user_photos アクセス許可が必要です。
Places	提供されたID に基づいてスポットをクエリします。スポットはFacebook のページとして保存されます。
Ratings	Facebook ページの評価のリスト。このビューには認証が必要です。
SimpleInsights	レスポンス内に1つの値を持つシンプルなインサイトの取得を許容します。
SimpleVideoInsights	レスポンス内に1つの値を持つシンプルな動画インサイトの取得を許容します。
StoryAttachments	Query attachments from a post or comment.
TaggedBy	ユーザー、またはページにタグ付けされた投稿、ステータス、写真、およびその他のエンティティ情報をクエリします。このビューは、ターゲットユーザーまたはターゲットページにタグ付けしたエントリだけが返される、ウォールコネクションの一部です。一般に、これはページにのみ使用できます。
Users	認証されたユーザーに関する基本情報を返します。
VideoInsightsByActionType	ストーリーアクションタイプごとの動画インサイトの取得を許容します。
VideoInsightsByDistributionType	ディストリビューションタイプごとの動画インサイトの取得を許容します。
VideoInsightsByReactionType	リアクションタイプごとの動画インサイトの取得を許容します。
Videos	ターゲットからの動画をクエリします。通常は、user_videos アクセス許可が必要です。
Wall	ターゲットのウォールからの投稿をクエリします。

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

テーブル固有の情報

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

Select

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

SELECT * FROM Comments WHERE Target = '15526475270_410830705612736'

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

SELECT * FROM Comments WHERE Id = '15526475270_410830705612736_5193593'

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_LOCALE,AUDIENCE_COUNTRY,AUDIENCE_CITY,ONLINE_FOLLOWERS
Period	String	インサイトの期間。これは行を（日、週、28 day もしくはLifetime）へのブレークダウンを管理します。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime
Target	String	インサイトのターゲット。この値は、Pages ビューのInstagramBusinessAccountId の値に対応しています。'Target IN (SELECT InstagramBusinessAccountId FROM Pages)' に設定することもできます。これは常に指定する必要があります。

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 は、ユーザーによって（ページなどに）アップロードされた写真で、アルバムに含まれます。

Select

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

SELECT * FROM Photos WHERE Target = 'facebook'

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

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

SELECT * FROM Photos WHERE Target='thesimpsons' 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 およびPeriod は常に指定される必要があります。次に例を示します。

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

IN 演算子によって複数のインサイトを指定できることに注意してください。次に例を示します。

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

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

SELECT * FROM SimpleInsights 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 である場合もあります。Facebook でどの期間がサポートされているかを確認することを推奨します。こちらを参照してください：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	収集されたインサイトデータの時刻の最大値。

レスポンス内に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 内のページにアップロードされた動画です。

Select

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

SELECT * FROM Videos WHERE Target = 'facebook'

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

SELECT * FROM Videos WHERE Id = 'VideoId'

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

SELECT * FROM Videos WHERE Target='thesimpsons' 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 テーブルを使うことで、正しいターゲットに挿入を発行しウォールに投稿することができます。

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

---

プロパティ	説明
Version	使用するFacebook Graph API のバージョン。
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	これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。
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	クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
Pagesize	Facebook から返されるページあたりの結果の最大数。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Target	何も指定されなかった場合のデフォルトのターゲット。ターゲットを指定できるComments などの一部のテーブルで使用されます。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UploadLinkedMedia	新しい投稿を挿入する前に、リンクされた写真または動画をアップロードします。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

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

---

プロパティ	説明
Version	使用するFacebook Graph API のバージョン。
AuthenticateAsPage	Facebook への要求時に認証するページの名前またはID。

使用するFacebook Graph API のバージョン。

解説

使用するFacebook Graph API のバージョン。一般的に、このプロパティは設定する必要はありません。

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.

Web applications need to call the GetOAuthAuthorizationURL and GetOAuthAccessToken stored procedures, which have inputs for the scope you would like to request.

Note that these are comma-separated lists of scopes, so you can request more than one per authorization request. You can find a list of available Facebook scopes here: http://developers.facebook.com/docs/authentication/permissions/.

このセクションでは、本プロバイダーの接続文字列で設定可能な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	これは、システムプロキシ設定を使用するかどうかを示します。これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するにはProxyAutoDetect をFALSE に設定する必要があります。
ProxyServer	HTTP トラフィックをルートするためのプロキシのホストネームもしくはIP アドレス。
ProxyPort	ProxyServer プロキシが起動しているTCP ポート。
ProxyAuthScheme	ProxyServer プロキシへの認証で使われる認証タイプ。
ProxyUser	ProxyServer プロキシへの認証に使われるユーザー名。
ProxyPassword	ProxyServer プロキシへの認証に使われるパスワード。
ProxySSLType	ProxyServer プロキシへの接続時に使用するSSL タイプ。
ProxyExceptions	ProxyServer 経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

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

解説

これは他のプロキシ設定よりも優先されるため、カスタムプロキシ設定を使用するには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 もしくはKereros トークンを取得します。
• 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% はユーザーのコンフィギュレーションディレクトリに設定されます：

このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、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	クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。
Other	これらの隠しプロパティは特定のユースケースでのみ使用されます。
Pagesize	Facebook から返されるページあたりの結果の最大数。
PseudoColumns	このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
Target	何も指定されなかった場合のデフォルトのターゲット。ターゲットを指定できるComments などの一部のテーブルで使用されます。
Timeout	タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
UploadLinkedMedia	新しい投稿を挿入する前に、リンクされた写真または動画をアップロードします。
UserDefinedViews	カスタムビューを含むJSON コンフィギュレーションファイルを指すファイルパス。

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

解説

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

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

解説

クエリで集計またはグループ化を使用しない場合に返される行数を制限します。これにより、設計時にパフォーマンスの問題を回避できます。

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

解説

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

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

統合およびフォーマット

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"