このページでは、CData Cloud でのFacebook への接続の確立 のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。

Facebook への接続

接続の確立 は、CData Cloud にデータベースを作成するためのFacebook への認証方法と必要な接続プロパティの設定方法について示します。

CData Cloud サービスからデータにアクセス

利用可能な標準サービスを経由してFacebook からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメント で詳しく説明します。

Database タブで対応するアイコンを選択して、Facebook に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。

Facebook への接続

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

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

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

Facebook への認証

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

Web アプリケーション

Web アプリケーション経由で接続する場合は、カスタムOAuth アプリケーションの作成 で説明するようにFacebook にカスタムOAuth アプリケーションを作成および登録する必要があります。 それからCloud を使用して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：別のマシンにCloud をインストールし、後述の「OAuth 設定を転送」の説明に従い、通常のブラウザベースのフローで認証後にOAuth 認証値を転送します。
2. ヘッドレスマシンからアクセストークンを自動的にリフレッシュするようにCloud を設定します。

オプション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. ログインして、Cloud にアクセス許可を与えます。すると、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 設定を転送

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

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

追加認証のリクエスト

Cloud の使用中に、指定のアクションを行う権限がアプリにありませんというエラーメッセージが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
InsightsByStoryType	PAGE_CONTENT_ACTIVITY_BY_ACTION_TYPE	day, week, days_28	page
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
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_UNIQUE	day, week, days_28	page
InsightsByLikeSourceType	PAGE_FANS_BY_LIKE_SOURCE	day	page
InsightsByLikeSourceType	PAGE_FANS_BY_LIKE_SOURCE_UNIQUE	day	page
InsightsByUnlikeSourceType	PAGE_FANS_BY_UNLIKE_SOURCE	day, week, days_28	page
InsightsByUnlikeSourceType	PAGE_FANS_BY_UNLIKE_SOURCE_UNIQUE	day, week, days_28	page
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
PageAndPostInsights	PAGE_FAN_ADDS	day	page
PageAndPostInsights	PAGE_FAN_ADDS_UNIQUE	day	page
PageAndPostInsights	PAGE_FAN_REMOVES	day	page
PageAndPostInsights	PAGE_FAN_REMOVES_UNIQUE	day	page
PageAndPostInsights	PAGE_FANS	day	page
PageAndPostInsights	PAGE_FANS_CITY	day	page
PageAndPostInsights	PAGE_FANS_COUNTRY	day	page
PageAndPostInsights	PAGE_FANS_LOCALE	day	page
PageAndPostInsights	PAGE_IMPRESSIONS	day, week, days_28	page
PageAndPostInsights	PAGE_IMPRESSIONS_PAID	day, week, days_28	page
PageAndPostInsights	PAGE_IMPRESSIONS_VIRAL	day, week, days_28	page
PageAndPostInsights	PAGE_IMPRESSIONS_NONVIRAL	day, week, days_28	page
PageAndPostInsights	POST_IMPRESSIONS	lifetime	post
PageAndPostInsights	POST_IMPRESSIONS_PAID	lifetime	post
PageAndPostInsights	POST_IMPRESSIONS_VIRAL	lifetime	post
PageAndPostInsights	POST_IMPRESSIONS_FAN	lifetime	post

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

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

次のインサイトは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_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_FANS_ONLINE	day	page	-
PAGE_FANS_ONLINE_PER_DAY	day	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_UNIQUE	day, week, days_28	page	-
PAGE_IMPRESSIONS_UNIQUE	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_MEDIA_VIEW	day, week, days_28	page	PAGE_IMPRESSIONS
PAGE_VIEWS_LOGOUT	day	page	-
PAGE_FOLLOWS	day	page	PAGE_FANS
POST_CLICKS	lifetime	post	POST_CONSUMPTIONS
POST_CLICKS_UNIQUE	lifetime	post	POST_CONSUMPTIONS_UNIQUE
POST_ENGAGED_USERS	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_UNIQUE	lifetime	post	-
POST_IMPRESSIONS_UNIQUE	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	-
POST_REACTIONS_LIKE_TOTAL	lifetime	post	-
POST_REACTIONS_LOVE_TOTAL	lifetime	post	-
POST_REACTIONS_WOW_TOTAL	lifetime	post	-
POST_REACTIONS_HAHA_TOTAL	lifetime	post	-
POST_REACTIONS_SORRY_TOTAL	lifetime	post	-
POST_REACTIONS_ANGER_TOTAL	lifetime	post	-
POST_MEDIA_VIEW	lifetime	post	POST_IMPRESSIONS

消費タイプ別インサイト

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

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
POST_CLICKS_BY_TYPE	lifetime	post	POST_CONSUMPTIONS_BY_CONSUMPTION_TYPE

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

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

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

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

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

インサイト名	使用可能な期間	ターゲットタイプ	変更前の名前
POST_ACTIVITY_BY_ACTION_TYPE	lifetime	post	PAGE_CONTENT_ACTIVITY_BY_ACTION_TYPE
POST_ACTIVITY_BY_ACTION_TYPE_UNIQUE	lifetime	post	-

タブタイプ別インサイト

次のインサイトは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 Cloud 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 Cloud.

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 Cloud 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 Cloud 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

SSL 設定のカスタマイズ

デフォルトでは、Cloud はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

• ProxyServer：HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
• ProxyPort：プロキシサーバーが起動しているTCP ポート。
• ProxyAuthScheme：プロキシサーバーに対して認証する際にCloud が使用する認証方法。
• ProxyUser：プロキシサーバーに登録されているユーザーアカウントのユーザー名。
• ProxyPassword：ProxyUser に紐付けられたパスワード。

その他のプロキシ

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

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

CData Cloud は、Facebook API をリレーショナルテーブル、ビュー、およびストアドプロシージャにモデル化します。 Cloud は、Facebook API を使用してサポートされているフィルタを処理します。その他のフィルタは、Cloud 内でクライアント側で処理されます。

テーブル

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

ビュー

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

ストアドプロシージャ

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

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

CData Cloud - Facebook テーブル

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	投稿が最後に更新された時刻。
PermalinkUrl	String	True	www.facebook.com の投稿への恒久的な静的URL。

Pseudo-Columns

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

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

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

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

CData Cloud - Facebook ビュー

Name	Description
Comments	ターゲットに対するコメントを作成、更新、削除、およびクエリします。ターゲットに基づいてコメントを挿入したり、ID に基づいて削除することもできます。
Events	ページID などのターゲットのイベントをクエリします。
InsightsByConsumptionType	消費タイプによるインサイトの取得を許容します。
InsightsByReactionTotals	いいねソースのタイプによるインサイトの取得を許容します。
InsightsByStoryType	ストーリーのタイプによるインサイトの取得を許容します。
InsightsByTabType	タブのタイプによるインサイトの取得を許容します。
InstagramAccountInsights	Instagram ビジネスアカウントのインサイトを取得できます。instagram_basic およびinstagram_manage_insights スコープが必須です。
PageAndPostInsights	レスポンス内に1つの値を持つシンプルなインサイトの取得を許容します。
PageLiveVideos	Live videos on a specified page. This table requires authentication, and the pages_read_engagement (or Page Public Content Access feature if you cannot moderate the page) and pages_show_list permissions. The Page Id must be specified as the Target.
Pages	提供されたID に基づいてページをクエリします。
Permissions	ユーザーが現在のアプリケーションに付与した権限をクエリします。
Photos	ターゲットに関連付けられた写真のクエリ。通常、写真情報へのアクセスには、user_photos アクセス許可が必要です。
Places	提供されたID に基づいてスポットをクエリします。スポットはFacebook のページとして保存されます。
PostSponsorTags	Query the Pages that have sponsored a target post. This table requires authentication, and the Post Id must be specified as the Target.
Ratings	Facebook ページの評価のリスト。このビューには認証が必要です。
SimpleVideoInsights	レスポンス内に1つの値を持つシンプルな動画インサイトの取得を許容します。
StoryAttachments	Query attachments from a post or comment.
TaggedBy	ユーザー、またはページにタグ付けされた投稿、ステータス、写真、およびその他のエンティティ情報をクエリします。このビューは、ターゲットユーザーまたはターゲットページにタグ付けしたエントリだけが返される、ウォールコネクションの一部です。一般に、これはページにのみ使用できます。
Users	認証されたユーザーに関する基本情報を返します。
VideoInsightsByActionType	ストーリーアクションタイプごとの動画インサイトの取得を許容します。
VideoInsightsByDistributionType	ディストリビューションタイプごとの動画インサイトの取得を許容します。
VideoInsightsByReactionType	リアクションタイプごとの動画インサイトの取得を許容します。
VideoReels	Query reels for a given page.
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	イベントに返信しなかった人の数。

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

テーブル固有の情報

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

Select

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

SELECT * FROM InsightsByConsumptionType WHERE Target = 'mypostid' AND InsightName = 'POST_CLICKS_BY_TYPE' AND Period = 'lifetime'

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

SELECT * FROM InsightsByConsumptionType WHERE Target = 'mypostid' AND InsightName = 'POST_CLICKS_BY_TYPE' AND Period = 'lifetime' 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	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです: POST_CLICKS_BY_TYPE
Period	String	インサイトの期間。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime

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	ひどいねリアクションの合計。
Thankful	Long	感謝リアクションの合計。
Pride	Long	Pride リアクションの合計。
Care	Long	大切だねリアクションの合計。
Fire	Long	Fire リアクションの合計。
Hundred	Long	Hundred リアクションの合計。
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 = 'POST_ACTIVITY_BY_ACTION_TYPE' AND Period = 'lifetime'

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

SELECT * FROM InsightsByStoryType WHERE Target = 'mypostid' AND InsightName = 'POST_ACTIVITY_BY_ACTION_TYPE' AND Period = 'lifetime' AND FromDateTime >= '08/20/2025' and ToDateTime <= '09/19/2025'

Columns

Name	Type	Description
RowNumber [KEY]	Int	結果の行番号。
EndTime	Date	このインサイトデータが関連する最新の日付。非推奨。v26 で削除予定。
UserPost	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
PagePost	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Checkin	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Fan	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Question	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Coupon	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Event	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Mention	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Other	Long	指定されたストーリータイプの合計を示すInsight カラム。非推奨。v26 で削除予定。
Share	Long	指定されたストーリータイプの合計を示すInsight カラム。
Like	Long	指定されたストーリータイプの合計を示すInsight カラム。
Comment	Long	指定されたストーリータイプの合計を示すInsight カラム。
Target	String	インサイトのターゲット。これは常に指定する必要があります。
InsightName	String	インサイトの名前。これは常に指定する必要があります。利用可能な値は次のとおりです: POST_ACTIVITY_BY_ACTION_TYPE, POST_ACTIVITY_BY_ACTION_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	収集されたインサイトデータの時刻の最大値。

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 およびPeriod を指定します。パフォーマンスを向上させるにはInsightName も指定する必要があります。次に例を示します。

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

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

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

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

SELECT * FROM PageAndPostInsights WHERE Target = 'mypageid' AND InsightName = 'PAGE_MEDIA_VIEW' 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, POST_REACTIONS_LIKE_TOTAL,POST_REACTIONS_LOVE_TOTAL,POST_REACTIONS_WOW_TOTAL,POST_REACTIONS_HAHA_TOTAL,POST_REACTIONS_SORRY_TOTAL,POST_REACTIONS_ANGER_TOTAL, PAGE_IMPRESSIONS_PAID_UNIQUE, PAGE_IMPRESSIONS_UNIQUE, PAGE_IMPRESSIONS_VIRAL_UNIQUE,PAGE_IMPRESSIONS_NONVIRAL_UNIQUE, PAGE_POST_ENGAGEMENTS, PAGE_POSTS_IMPRESSIONS, PAGE_POSTS_IMPRESSIONS_PAID, PAGE_POSTS_IMPRESSIONS_PAID_UNIQUE, PAGE_POSTS_IMPRESSIONS_UNIQUE, PAGE_POSTS_IMPRESSIONS_VIRAL, PAGE_POSTS_IMPRESSIONS_VIRAL_UNIQUE, 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, POST_CLICKS,POST_IMPRESSIONS_FAN_UNIQUE, POST_IMPRESSIONS_ORGANIC, POST_IMPRESSIONS_ORGANIC_UNIQUE,POST_IMPRESSIONS_PAID_UNIQUE, POST_IMPRESSIONS_UNIQUE,POST_IMPRESSIONS_VIRAL_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_15S, POST_VIDEO_VIEWS_ORGANIC, POST_VIDEO_VIEWS_ORGANIC_UNIQUE, POST_VIDEO_VIEWS_PAID, POST_VIDEO_VIEWS_PAID_UNIQUE, POST_VIDEO_VIEWS_SOUND_ON,PAGE_FOLLOWS,PAGE_MEDIA_VIEW,POST_MEDIA_VIEW
Period	String	インサイトの期間。これは行を（日、週、28 day もしくはLifetime）へのブレークダウンを管理します。これは常に指定する必要があります。 使用できる値は次のとおりです。day, week, days_28, lifetime

Pseudo-Columns

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

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

Live videos on a specified page. This table requires authentication, and the pages_read_engagement (or Page Public Content Access feature if you cannot moderate the page) and pages_show_list permissions. The Page Id must be specified as the Target.

Columns

Name	Type	Description
ID [KEY]	String	The Id of the post.
Title	String	The title of the live video.
Status	String	The status of the LiveVideo.
StreamUrl	String	The stream url of the live video.
SecureStreamUrl	String	The secure stream url of the live video. Check with your encoder whether this is supported before adapting.
EmbedHtml	String	The embed html of the live video.
BroadcastStartTime	Datetime	The time the video was initially published.
CreationTime	Datetime	The creation time of the live video.
DashIngestUrl	String	The dash ingest stream URL of the live video.
DashPreviewUrl	String	Preview URL for dash player.
Description	String	The description of the live video.
FromName	String	The name of the originator of the live video.
FromId	String	The id of the originator of the live video.
TargetingAgeMax	Integer	The maximum age of viewers to target the video toward.
TargetingAgeMin	Integer	The minimum age of viewers to target the video toward.
TargetingCountries	String	The countries of viewers to target the video toward.
PermalinkUrl	String	The permalink URL of this video on Facebook.
VideoId	String	The Id of the video.
Target	String	ID of the page of the live videos.

提供された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	最初に返す結果。結果の手動ページングで使用されます。

Query the Pages that have sponsored a target post. This table requires authentication, and the Post Id must be specified as the Target.

Columns

Name	Type	Description
ID [KEY]	String	The Id of the post.
Description	String	A description of the page, if available.
Founded	String	When the company was founded.
GeneralInfo	String	General information about the page.
About	String	Basic information about the page.
Name	String	The name of the page.
Category	String	The category of the page.
FanCount	Integer	The number of fans of the page.
Link	String	A link to the page.
LocationCity	String	The city for the page.
LocationCountry	String	The country for the page.
TalkingAboutCount	Integer	The number of users talking about the page.
Target	String	ID of the post that has sponsored the pages.

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	収集されたインサイトデータの時刻の最大値。

Query reels for a given page.

Columns

Name	Type	Description
ID [KEY]	String	The Id of the video.
Target	String	The Id or username of the target you are retrieving videos for.
Description	String	A description of the video.
Published [KEY]	Boolean	Whether a post about this reel is published.
VideoStatus [KEY]	String	Status attributes of a video.
UploadingPhaseStatus [KEY]	String	Status attributes of a video.
ProcessingPhaseStatus [KEY]	String	Status attributes of a video.
PublishingPhaseStatus [KEY]	String	Status attributes of a video.
PublishingPhasePublishStatus [KEY]	String	Status attributes of a video.
PublishingPhasePublishTime [KEY]	String	Status attributes of a video.
Title [KEY]	String	The video title or caption.
Views [KEY]	Long	The public view count of the video.
Place [KEY]	String	Place info.
PrivacyAllow [KEY]	String	Privacy setting for the video.
PrivacyDeny [KEY]	String	Privacy setting for the video.
PrivacyDescription [KEY]	String	Privacy setting for the video.
PrivacyFriends [KEY]	String	Privacy setting for the video.
PrivacyNetworks [KEY]	String	Privacy setting for the video.
PrivacyValue [KEY]	String	Privacy setting for the video.
FromId	String	The Id of the user who uploaded the video.
FromName	String	The name of the user who uploaded the video.
FromPicture	String	The picture of the user who uploaded the video.
FromCategory	String	The category of the user who uploaded the video. FromCategory may only be retrieved if the other From* fields are not selected.
Picture	String	The URL for the thumbnail of the video.
Source	String	The URL to the raw, playable video file.
EmbedHtml	String	The HTML element that may be embedded in a Web page to play the video.
Icon	String	The icon that Facebook displays when videos are published to the Feed.
Format	String	An aggregate of four different formats for the video.
Tags	String	An aggregate of users tagged in the video, if any.
CommentsCount	Integer	The number of comments for the video.
LikesCount	Integer	The number of times the video has been liked.
CommentsData	String	An aggregate of comments for the video.
CreatedTime	Datetime	When the video was uploaded.
UpdatedTime	Datetime	When the video was last updated.

ターゲットからの動画をクエリします。通常は、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	投稿が最後に更新された時刻。

ストアドプロシージャはファンクションライクなインターフェースで、Facebook の単純なSELECT/INSERT/UPDATE/DELETE 処理にとどまらずCloud の機能を拡張します。

ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにFacebook から関連するレスポンスデータを返します。

CData Cloud - Facebook ストアドプロシージャ

Name	Description
CreateInsightSchema	インサイトのスキーマファイルを作成します。

インサイトのスキーマファイルを作成します。

Input

Name	Type	Description
InsightName	String	テーブルを作成する対象となるインサイトの名前。 使用できる値は次のとおりです。PAGE_ENGAGED_USERS, PAGE_FANS_GENDER_AGE, PAGE_FANS_ONLINE, PAGE_FANS_ONLINE_PER_DAY, PAGE_IMPRESSIONS_BY_AGE_GENDER_UNIQUE, PAGE_IMPRESSIONS_BY_CITY_UNIQUE, PAGE_IMPRESSIONS_BY_COUNTRY_UNIQUE, PAGE_IMPRESSIONS_BY_LOCALE_UNIQUE, PAGE_IMPRESSIONS_FREQUENCY_DISTRIBUTION, PAGE_IMPRESSIONS_ORGANIC, PAGE_IMPRESSIONS_ORGANIC_UNIQUE, PAGE_IMPRESSIONS_PAID_UNIQUE, PAGE_IMPRESSIONS_UNIQUE, PAGE_IMPRESSIONS_VIRAL_FREQUENCY_DISTRIBUTION, PAGE_IMPRESSIONS_VIRAL_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_PLACES_CHECKINS_BY_AGE_GENDER, PAGE_PLACES_CHECKINS_BY_COUNTRY, PAGE_PLACES_CHECKINS_BY_LOCALE, PAGE_POSTS_IMPRESSIONS, PAGE_POSTS_IMPRESSIONS_FREQUENCY_DISTRIBUTION, 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_STORIES, PAGE_STORIES_BY_STORY_TYPE, PAGE_STORYTELLERS, PAGE_CONTENT_ACTIVITY_BY_AGE_GENDER_UNIQUE, PAGE_CONTENT_ACTIVITY_BY_CITY_UNIQUE, PAGE_CONTENT_ACTIVITY_BY_COUNTRY_UNIQUE, PAGE_CONTENT_ACTIVITY_BY_LOCALE_UNIQUE, PAGE_STORYTELLERS_BY_STORY_TYPE, PAGE_TAB_VIEWS_LOGIN_TOP, PAGE_TAB_VIEWS_LOGIN_TOP_UNIQUE, PAGE_TAB_VIEWS_LOGOUT_TOP, 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_VIEW_TIME, 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, PAGE_VIEWS_EXTERNAL_REFERRALS, PAGE_VIEWS_LOGIN, PAGE_VIEWS_LOGIN_UNIQUE, PAGE_VIEWS_LOGOUT, PAGE_VIEWS_UNIQUE, POST_CONSUMPTIONS, POST_CONSUMPTIONS_BY_TYPE, POST_CONSUMPTIONS_BY_TYPE_UNIQUE, POST_CONSUMPTIONS_UNIQUE, POST_ENGAGED_USERS, POST_IMPRESSIONS_FAN_PAID, POST_IMPRESSIONS_FAN_PAID_UNIQUE, POST_IMPRESSIONS_FAN_UNIQUE, POST_IMPRESSIONS_ORGANIC, POST_IMPRESSIONS_ORGANIC_UNIQUE, POST_IMPRESSIONS_PAID_UNIQUE, POST_IMPRESSIONS_UNIQUE, POST_IMPRESSIONS_VIRAL_UNIQUE, POST_NEGATIVE_FEEDBACK, POST_NEGATIVE_FEEDBACK_UNIQUE, POST_STORIES, POST_STORIES_BY_ACTION_TYPE, POST_STORYTELLERS, POST_STORYTELLERS_BY_ACTION_TYPE, 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_RETENTION_GRAPH, POST_VIDEO_RETENTION_GRAPH_AUTOPLAYED, POST_VIDEO_RETENTION_GRAPH_CLICKED_TO_PLAY, POST_VIDEO_VIEW_TIME_BY_AGE_BUCKET_AND_GENDER, POST_VIDEO_VIEW_TIME_BY_COUNTRY_ID, POST_VIDEO_VIEW_TIME_BY_DISTRIBUTION_TYPE, POST_VIDEO_VIEW_TIME_BY_REGION_ID, POST_VIDEO_VIEWS_BY_DISTRIBUTION_TYPE, POST_VIDEO_VIEWS_ORGANIC, POST_VIDEO_VIEWS_ORGANIC_UNIQUE, POST_VIDEO_VIEWS_PAID, POST_VIDEO_VIEWS_PAID_UNIQUE, POST_ACTIVITY_BY_ACTION_TYPE, POST_ACTIVITY_BY_ACTION_TYPE_UNIQUE, PAGE_ACTIONS_POST_REACTIONS_TOTAL, POST_REACTIONS_BY_TYPE_TOTAL, 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, POST_REACTIONS_LIKE_TOTAL, POST_REACTIONS_LOVE_TOTAL, POST_REACTIONS_WOW_TOTAL, POST_REACTIONS_HAHA_TOTAL, POST_REACTIONS_SORRY_TOTAL, POST_REACTIONS_ANGER_TOTAL, PAGE_FOLLOWS, PAGE_FOLLOWS_CITY, PAGE_FOLLOWS_COUNTRY, PAGE_MEDIA_VIEW, POST_MEDIA_VIEW
Target	String	このインサイトのデフォルトのターゲット。
FromDateTime	String	インサイトデータを返す日時の最小値。これは、Periods 入力より優先して使用され、一部のインサイトでは必須です。
ToDateTime	String	インサイトデータを返す日時の最大値。これは、Periods 入力より優先して使用され、一部のインサイトでは必須です。
Description	String	インサイトのオプションの説明。データソースから取得した説明より優先して使用されます。

Result Set Columns

Name	Type	Description
Result	String	Success またはFailure を返します。
SchemaFile	String	生成されるスキーマファイル。Location 接続プロパティを、スキーマファイルが入っているフォルダに設定する必要があります。
Columns	String	見つかった列の数。

このセクションで説明されているシステムテーブルをクエリして、スキーマ情報、データソース機能に関する情報、およびバッチ操作の統計にアクセスできます。

スキーマテーブル

以下のテーブルは、Facebook のデータベースメタデータを返します。

• sys_catalogs：利用可能なデータベースをリスト。
• sys_schemas：利用可能なスキーマをリスト。
• sys_tables：利用可能なテーブルおよびビューをリスト。
• sys_tablecolumns：利用可能なテーブルおよびビューのカラムについて説明。
• sys_procedures：利用可能なストアドプロシージャについて説明。
• sys_procedureparameters：ストアドプロシージャパラメータについて説明。
• sys_keycolumns：主キーおよび外部キーについて説明。
• sys_indexes：利用可能なインデックスについて説明。

データソーステーブル

以下のテーブルは、データソースへの接続方法およびクエリ方法についての情報を返します。

• sys_connection_props：利用可能な接続プロパティについての情報を返す。
• sys_sqlinfo：Cloud がデータソースにオフロードできるSELECT クエリについて説明。

クエリ情報テーブル

次のテーブルは、データ変更クエリのクエリ統計を返します。

• sys_identity：バッチ処理または単一の更新に関する情報を返す。

利用可能なデータベースをリストします。

次のクエリは、接続文字列で決定されるすべてのデータベースを取得します。

SELECT * FROM sys_catalogs

Columns

Name	Type	Description
CatalogName	String	データベース名。

利用可能なスキーマをリストします。

次のクエリは、すべての利用可能なスキーマを取得します。

          SELECT * FROM sys_schemas
          

Columns

Name	Type	Description
CatalogName	String	データベース名。
SchemaName	String	スキーマ名。

利用可能なテーブルをリストします。

次のクエリは、利用可能なテーブルおよびビューを取得します。

          SELECT * FROM sys_tables
          

Columns

Name	Type	Description
CatalogName	String	テーブルまたはビューを含むデータベース。
SchemaName	String	テーブルまたはビューを含むスキーマ。
TableName	String	テーブル名またはビュー名。
TableType	String	テーブルの種類（テーブルまたはビュー）。
Description	String	テーブルまたはビューの説明。
IsUpdateable	Boolean	テーブルが更新可能かどうか。

利用可能なテーブルおよびビューのカラムについて説明します。

次のクエリは、Posts テーブルのカラムとデータ型を返します。

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Posts' 

Columns

Name	Type	Description
CatalogName	String	テーブルまたはビューを含むデータベースの名前。
SchemaName	String	テーブルまたはビューを含むスキーマ。
TableName	String	カラムを含むテーブルまたはビューの名前。
ColumnName	String	カラム名。
DataTypeName	String	データ型の名前。
DataType	Int32	データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。
Length	Int32	カラムのストレージサイズ。
DisplaySize	Int32	指定されたカラムの通常の最大幅（文字数）。
NumericPrecision	Int32	数値データの最大桁数。文字データおよび日時データの場合は、カラムの長さ（文字数）。
NumericScale	Int32	カラムのスケール（小数点以下の桁数）。
IsNullable	Boolean	カラムがNull を含められるかどうか。
Description	String	カラムの簡単な説明。
Ordinal	Int32	カラムのシーケンスナンバー。
IsAutoIncrement	String	カラムに固定増分値が割り当てられるかどうか。
IsGeneratedColumn	String	生成されたカラムであるかどうか。
IsHidden	Boolean	カラムが非表示かどうか。
IsArray	Boolean	カラムが配列かどうか。
IsReadOnly	Boolean	カラムが読み取り専用かどうか。
IsKey	Boolean	sys_tablecolumns から返されたフィールドがテーブルの主キーであるかどうか。
ColumnType	String	スキーマ内のカラムの役割または分類。可能な値は、SYSTEM、LINKEDCOLUMN、NAVIGATIONKEY、REFERENCECOLUMN、およびNAVIGATIONPARENTCOLUMN が含まれます。

利用可能なストアドプロシージャをリストします。

次のクエリは、利用可能なストアドプロシージャを取得します。

          SELECT * FROM sys_procedures
          

Columns

Name	Type	Description
CatalogName	String	ストアドプロシージャを含むデータベース。
SchemaName	String	ストアドプロシージャを含むスキーマ。
ProcedureName	String	ストアドプロシージャの名前。
Description	String	ストアドプロシージャの説明。
ProcedureType	String	PROCEDURE やFUNCTION などのプロシージャのタイプ。

ストアドプロシージャパラメータについて説明します。

次のクエリは、GetOAuthAccessToken ストアドプロシージャのすべての入力パラメータについての情報を返します。

SELECT * FROM sys_procedureparameters WHERE ProcedureName = 'GetOAuthAccessToken' AND Direction = 1 OR Direction = 2

パラメータに加えて結果セットのカラムを含めるには、IncludeResultColumns 擬似カラムをTrue に設定します。

SELECT * FROM sys_procedureparameters WHERE ProcedureName = 'GetOAuthAccessToken' AND IncludeResultColumns='True'

Columns

Name	Type	Description
CatalogName	String	ストアドプロシージャを含むデータベースの名前。
SchemaName	String	ストアドプロシージャを含むスキーマの名前。
ProcedureName	String	パラメータを含むストアドプロシージャの名前。
ColumnName	String	ストアドプロシージャパラメータの名前。
Direction	Int32	パラメータのタイプに対応する整数値：input (1)。input/output (2)、またはoutput(4)。input/output タイプパラメータは、入力パラメータと出力パラメータの両方になれます。
DataType	Int32	データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。
DataTypeName	String	データ型の名前。
NumericPrecision	Int32	数値データの場合は最大精度。文字データおよび日時データの場合は、カラムの長さ（文字数）。
Length	Int32	文字データの場合は、許可される文字数。数値データの場合は、許可される桁数。
NumericScale	Int32	数値データの小数点以下の桁数。
IsNullable	Boolean	パラメータがNull を含められるかどうか。
IsRequired	Boolean	プロシージャの実行にパラメータが必要かどうか。
IsArray	Boolean	パラメータが配列かどうか。
Description	String	パラメータの説明。
Ordinal	Int32	パラメータのインデックス。
Values	String	このパラメータで設定できる値は、このカラムに表示されるものに限られます。指定できる値はカンマ区切りです。
SupportsStreams	Boolean	パラメータがファイルを表すかどうか。ファイルは、ファイルパスとして渡すことも、ストリームとして渡すこともできます。
IsPath	Boolean	パラメータがスキーマ作成操作のターゲットパスかどうか。
Default	String	何も値が指定されていない場合に、このパラメータで使用される値。
SpecificName	String	複数のストアドプロシージャが同じ名前を持つ場合、それぞれの同名のストアドプロシージャを一意に識別するラベル。特定の名前を持つプロシージャが1つだけの場合は、その名前がここに単純に反映されます。
IsCDataProvided	Boolean	プロシージャがネイティブのFacebook プロシージャではなく、CData によって追加 / 実装されているかどうか。

Pseudo-Columns

Name	Type	Description
IncludeResultColumns	Boolean	出力にパラメータに加えて結果セットのカラムを含めるかどうか。デフォルトはFalse です。

主キーおよび外部キーについて説明します。

次のクエリは、Posts テーブルの主キーを取得します。

         SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Posts' 
          

Columns

Name	Type	Description
CatalogName	String	キーを含むデータベースの名前。
SchemaName	String	キーを含むスキーマの名前。
TableName	String	キーを含むテーブルの名前。
ColumnName	String	キーカラムの名前
IsKey	Boolean	カラムがTableName フィールドで参照されるテーブル内の主キーかどうか。
IsForeignKey	Boolean	カラムがTableName フィールドで参照される外部キーかどうか。
PrimaryKeyName	String	主キーの名前。
ForeignKeyName	String	外部キーの名前。
ReferencedCatalogName	String	主キーを含むデータベース。
ReferencedSchemaName	String	主キーを含むスキーマ。
ReferencedTableName	String	主キーを含むテーブル。
ReferencedColumnName	String	主キーのカラム名。

外部キーについて説明します。

次のクエリは、他のテーブルを参照するすべての外部キーを取得します。

         SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
          

カラム

名前	タイプ	説明
CatalogName	String	キーを含むデータベースの名前。
SchemaName	String	キーを含むスキーマの名前。
TableName	String	キーを含むテーブルの名前。
ColumnName	String	キーカラムの名前
PrimaryKeyName	String	主キーの名前。
ForeignKeyName	String	外部キーの名前。
ReferencedCatalogName	String	主キーを含むデータベース。
ReferencedSchemaName	String	主キーを含むスキーマ。
ReferencedTableName	String	主キーを含むテーブル。
ReferencedColumnName	String	主キーのカラム名。
ForeignKeyType	String	外部キーがインポート（他のテーブルを指す）キーかエクスポート（他のテーブルから参照される）キーかを指定します。

主キーについて説明します。

次のクエリは、すべてのテーブルとビューから主キーを取得します。

         SELECT * FROM sys_primarykeys
          

Columns

Name	Type	Description
CatalogName	String	キーを含むデータベースの名前。
SchemaName	String	キーを含むスキーマの名前。
TableName	String	キーを含むテーブルの名前。
ColumnName	String	キーカラムの名前。
KeySeq	String	主キーのシーケンス番号。
KeyName	String	主キーの名前。

利用可能なインデックスについて説明します。インデックスをフィルタリングすることで、より高速なクエリ応答時間でセレクティブクエリを記述できます。

次のクエリは、主キーでないすべてのインデックスを取得します。

          SELECT * FROM sys_indexes WHERE IsPrimary='false'
          

Columns

Name	Type	Description
CatalogName	String	インデックスを含むデータベースの名前。
SchemaName	String	インデックスを含むスキーマの名前。
TableName	String	インデックスを含むテーブルの名前。
IndexName	String	インデックス名。
ColumnName	String	インデックスに関連付けられたカラムの名前。
IsUnique	Boolean	インデックスが固有の場合はTrue。そうでない場合はFalse。
IsPrimary	Boolean	インデックスが主キーの場合はTrue。そうでない場合はFalse。
Type	Int16	インデックスタイプに対応する整数値：statistic (0)、clustered (1)、hashed (2)、またはother (3)。
SortOrder	String	並べ替え順序：A が昇順、D が降順。
OrdinalPosition	Int16	インデックスのカラムのシーケンスナンバー。

利用可能な接続プロパティと、接続文字列に設定されている接続プロパティに関する情報を返します。

次のクエリは、接続文字列に設定されている、あるいはデフォルト値で設定されているすべての接続プロパティを取得します。

SELECT * FROM sys_connection_props WHERE Value <> ''

Columns

Name	Type	Description
Name	String	接続プロパティ名。
ShortDescription	String	簡単な説明。
Type	String	接続プロパティのデータ型。
Default	String	明示的に設定されていない場合のデフォルト値。
Values	String	可能な値のカンマ区切りリスト。別な値が指定されていると、検証エラーがスローされます。
Value	String	設定した値またはあらかじめ設定されたデフォルト。
Required	Boolean	プロパティが接続に必要かどうか。
Category	String	接続プロパティのカテゴリ。
IsSessionProperty	String	プロパティが、現在の接続に関する情報を保存するために使用されるセッションプロパティかどうか。
Sensitivity	String	プロパティの機密度。これは、プロパティがロギングおよび認証フォームで難読化されているかどうかを通知します。
PropertyName	String	キャメルケースの短縮形の接続プロパティ名。
Ordinal	Int32	パラメータのインデックス。
CatOrdinal	Int32	パラメータカテゴリのインデックス。
Hierarchy	String	このプロパティと一緒に設定する必要がある、関連のある依存プロパティを表示します。
Visible	Boolean	プロパティが接続UI に表示されるかどうかを通知します。
ETC	String	プロパティに関するその他のさまざまな情報。

Cloud がデータソースにオフロードできるSELECT クエリ処理について説明します。

SQL 構文の詳細については、SQL 準拠 を参照してください。

データソースのSELECT 機能

以下はSQL 機能のサンプルデータセットです。 SELECT 機能のいくつかの側面がサポートされている場合には、カンマ区切りのリストで返されます。サポートされていない場合、カラムにはNO が入ります。

名前	説明	有効な値
AGGREGATE_FUNCTIONS	サポートされている集計関数。	AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT	COUNT 関数がサポートされているかどうか。	YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR	識別子をエスケープするための開始文字。	[
IDENTIFIER_QUOTE_CLOSE_CHAR	識別子をエスケープするための終了文字。	]
SUPPORTED_OPERATORS	サポートされているSQL 演算子。	=, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY	GROUP BY がサポートされているかどうか。サポートされている場合、どのレベルでサポートされているか。	NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
OJ_CAPABILITIES	サポートされている外部結合の種類。	NO, LEFT, RIGHT, FULL, INNER, NOT_ORDERED, ALL_COMPARISON_OPS
OUTER_JOINS	外部結合がサポートされているかどうか。	YES, NO
SUBQUERIES	サブクエリがサポートされているかどうか。サポートされていれば、どのレベルでサポートされているか。	NO, COMPARISON, EXISTS, IN, CORRELATED_SUBQUERIES, QUANTIFIED
STRING_FUNCTIONS	サポートされている文字列関数。	LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS	サポートされている数値関数。	ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS	サポートされている日付および時刻関数。	NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES	レプリケーション中にスキップされたテーブルを示します。
REPLICATION_TIMECHECK_COLUMNS	レプリケーション中に更新判断のカラムとして使用するかどうかを、（指定された順に）チェックするカラムのリストを含む文字列の配列。
IDENTIFIER_PATTERN	識別子としてどの文字列が有効かを示す文字列値。
SUPPORT_TRANSACTION	プロバイダーが、コミットやロールバックなどのトランザクションをサポートしているかどうかを示します。	YES, NO
DIALECT	使用するSQL ダイアレクトを示します。
KEY_PROPERTIES	Uniform データベースを特定するプロパティを示します。
SUPPORTS_MULTIPLE_SCHEMAS	プロバイダー用に複数のスキームが存在するかどうかを示します。	YES, NO
SUPPORTS_MULTIPLE_CATALOGS	プロバイダー用に複数のカタログが存在するかどうかを示します。	YES, NO
DATASYNCVERSION	このドライバーにアクセスするために必要な、CData Sync のバージョン。	Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY	このドライバーのCData Sync カテゴリ。	Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL	API で提供されている以上の、追加SQL 機能がサポートされているかどうか。	TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS	バッチ操作がサポートされているかどうか。	YES, NO
SQL_CAP	このドライバーでサポートされているすべてのSQL 機能。	SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS	使用したいcacheOptions を指定する文字列値。
ENABLE_EF_ADVANCED_QUERY	ドライバーがEntity Framework の高度なクエリをサポートしているかどうかを示します。サポートしていなければ、クエリはクライアントサイドで処理されます。	YES, NO
PSEUDO_COLUMNS	利用可能な疑似カラムを示す文字列の配列。
MERGE_ALWAYS	値がtrue であれば、CData Sync 内でMerge Model が強制的に実行されます。	TRUE, FALSE
REPLICATION_MIN_DATE_QUERY	レプリケート開始日時を返すSELECT クエリ。
REPLICATION_MIN_FUNCTION	サーバーサイドでmin を実行するために使用する式名を、プロバイダーが指定できるようになります。
REPLICATION_START_DATE	レプリケート開始日を、プロバイダーが指定できるようになります。
REPLICATION_MAX_DATE_QUERY	レプリケート終了日時を返すSELECT クエリ。
REPLICATION_MAX_FUNCTION	サーバーサイドでmax を実行するために使用する式名を、プロバイダーが指定できるようになります。
IGNORE_INTERVALS_ON_INITIAL_REPLICATE	初回のレプリケートで、レプリケートをチャンクに分割しないテーブルのリスト。
CHECKCACHE_USE_PARENTID	CheckCache 構文を親キーカラムに対して実行するかどうかを示します。	TRUE, FALSE
CREATE_SCHEMA_PROCEDURES	スキーマファイルの生成に使用できる、ストアドプロシージャを示します。

次のクエリは、WHERE 句で使用できる演算子を取得します。

SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'

WHERE 句では、個々のテーブルの制限や要件が異なる場合がありますので注意してください。詳しくは、データモデル セクションを参照してください。

Columns

Name	Type	Description
NAME	String	SQL 構文のコンポーネント、またはサーバー上で処理できる機能。
VALUE	String	サポートされるSQL またはSQL 構文の詳細。

試行された変更に関する情報を返します。

次のクエリは、バッチ処理で変更された行のId を取得します。

         SELECT * FROM sys_identity
          

Columns

Name	Type	Description
Id	String	データ変更処理から返された、データベース生成Id。
Batch	String	バッチの識別子。1 は単一処理。
Operation	String	バッチ内の処理の結果：INSERTED、UPDATED、またはDELETED。
Message	String	SUCCESS、またはバッチ内の更新が失敗した場合のエラーメッセージ。

利用可能なシステム情報を説明します。

次のクエリは、すべてのカラムを取得します。

SELECT * FROM sys_information

Columns

Name	Type	Description
Product	String	製品名。
Version	String	製品のバージョン番号。
Datasource	String	製品が接続するデータソースの名前。
NodeId	String	製品がインストールされているマシンの固有識別子。
HelpURL	String	製品のヘルプドキュメントのURL。
License	String	製品のライセンス情報。（この情報が利用できない場合、この項目は空白のままか「N/A」と表示されます。）
Location	String	製品のライブラリが格納されているファイルパスの場所。
Environment	String	製品が現在稼働している環境またはランタイムのバージョン。
DataSyncVersion	String	本コネクタを使用するために必要なCData Sync のティア。
DataSyncCategory	String	CData Sync 機能のカテゴリ（例：Source、Destination）。

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

Authentication

---

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

OAuth

---

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	The scope to use when authenticating to Facebook.

SSL

---

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

Logging

---

プロパティ	説明
Verbosity	ログファイルのVerbosity レベルを指定し、記録される情報の詳細度を制御します。サポートされる値の範囲は1から5までです。

Schema

---

プロパティ	説明
BrowsableSchemas	レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

Miscellaneous

---

プロパティ	説明
AggregateFormat	集計またはコレクションの列を返す場合の形式。
IgnorePermissionErrors	On reads of data from Facebook, ignore errors about missing permissions.
MaxRows	集計やGROUP BY を含まないクエリで返される最大行数を指定します。
Pagesize	Facebook から返されるページあたりの結果の最大数。
PseudoColumns	テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
Target	何も指定されなかった場合のデフォルトのターゲット。ターゲットを指定できるComments などの一部のテーブルで使用されます。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
UploadLinkedMedia	新しい投稿を挿入する前に、リンクされた写真または動画をアップロードします。

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

---

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

Facebook への要求時に認証するページのID。

データ型

string

デフォルト値

""

解説

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

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

---

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
OAuthClientSecret	カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）
Scope	The scope to use when authenticating to Facebook.

カスタムOAuth アプリケーションに割り当てられたクライアントID（コンシューマーキーとも呼ばれます）を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。

データ型

string

デフォルト値

""

解説

このプロパティは2つのケースで必要となります：

• カスタムOAuth アプリケーションを使用する場合。たとえば、Web ベースの認証フロー、サービスベースの認証、またはアプリケーションの登録が必要な証明書ベースのフローなどが該当します。
• ドライバーが埋め込みOAuth 資格情報を提供しない場合。

（ドライバーが埋め込みOAuth 資格情報を提供する場合、この値はすでにCloud によって設定されており、手動で入力する必要がないことがあります。）

OAuthClientId は、認証付きの接続を構成する際に、OAuthClientSecret やOAuthSettingsLocation などの他のOAuth 関連プロパティと一緒に使用されるのが一般的です。

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。 この値は、通常、ID プロバイダーのアプリケーション登録設定で確認できます。 Client ID、Application ID、Consumer Key などとラベル付けされた項目を探してください。

クライアントID は、クライアントシークレットのような機密情報とは見なされませんが、アプリケーションの識別情報の一部であるため、慎重に取り扱う必要があります。公開リポジトリや共有設定ファイルでこの値を露出させないようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。

カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。（カスタムOAuth アプリケーションのみ）

データ型

string

デフォルト値

""

解説

このプロパティ（アプリケーションシークレットまたはコンシューマシークレットとも呼ばれます）は、安全なクライアント認証を必要とするすべてのフローでカスタムOAuth アプリケーションを使用する場合に必要です。たとえば、Web ベースのOAuth、サービスベースの接続、証明書ベースの認可フローなどが該当します。 組み込みOAuth アプリケーションを使用する場合は必要ありません。

クライアントシークレットは、OAuth フローのトークン交換ステップで使用されます。このステップでは、ドライバーが認可サーバーにアクセストークンを要求します。 この値が欠落しているか正しくない場合、認証はinvalid_client またはunauthorized_client エラーで失敗します。

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、OAuth アプリケーションを登録する際にID プロバイダーから取得できます。

Notes：

• この値は安全に保管し、公開リポジトリやスクリプト、安全でない環境では決して公開しないようにしてください。
• クライアントシークレットは、一定期間が経過すると有効期限が切れる場合もあります。 アクセスを中断させないために、有効期限を常に監視し、必要に応じてシークレットをローテーションするようにしてください。

接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。