グラフAPIバージョン

URL `/?id={url}`

投稿または投稿のコメントでシェアされるURLを表します。

詳しくは、Facebookのニュースタブインデックス作成APIのドキュメントをご覧ください。

読み取り

投稿または投稿のコメントでシェアされるURLに関する情報を取得します。

要件

タイプ	説明
アクセストークン	任意のアクセストークンを使用して、このリクエストを実行できます。
機能	該当なし。
ページタスク	該当なし。
アクセス許可	該当なし。

制限

返されるエンゲージメント値は正確ではありませんが、URLに対するユーザーエンゲージメントを反映しています。
GETリクエストの上限は、1つのアプリ、1つのURLにつき、1時間あたり10件です。

パラメーター

リクエストに以下のクエリ文字列パラメーターを追加します。

パラメーター	説明
`access_token` 必須 string	アクセストークン。
`fields` string	リクエストするフィールドのコンマ区切りリスト。
`id` string	シェアするURL。
`scopes` string	範囲のコンマ区切りリスト。

フィールド

プロパティ名	説明	タイプ
`app_links`	このURLに関連付けられているAppLinksデータ(あれば)。	`AppLinks`
`id`	URL自体。	`string`
`engagement`	ユーザーがURLを操作した方法の数。注: エンゲージメント数は意図的に不正確な値になっていますが、URLによるユーザーエンゲージメントを正確に反映していることは信頼できます。	`object`
`comment_count`	URLに付けられたコメントの数	`int`
`comment_plugin_count`	サイトのコメントプラグインを使用して収集された、プラグインに対するコメントの数。	`int`
`reaction_count`	URLに対するリアクションの数。	`int`
`share_count`	URLがシェアされた回数。	`int`
`og_object`	このURLに対して正規に関連付けられているOpen Graphオブジェクト。	`OGObject`
`id`	オブジェクトのID。	`string`
`description`	オブジェクトの説明(あれば)。	`string`
`title`	オブジェクトのタイトル(あれば)。	`string`
`type`	オブジェクトタイプ。	`og:type`
`updated_time`	オブジェクトの最終更新日時。	`datetime`

例

投稿またはコメントで公開されるURLに関する情報を取得するには、URLに設定されたidパラメーター、URLに関する任意のフィールド、投稿またはコメントを公開したユーザーまたはページから要求されたアクセストークンを使ってhttps://graph.facebook.comにGETリクエストを送信します。

次の例は、ユーザーアクセストークンが表すユーザーによってシェアされるURL (https://www.facebook.com)のエンゲージメントを示しています。

読みやすくするためにフォーマットを調整しています。

curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

成功すると、アプリはシェアされるURLの次のエンゲージメントカウントを受け取ります。

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

作成

このエンドポイントではこの操作を実行できません。

更新

URLを更新します。

要件

タイプ	説明
アクセストークン	任意のアクセストークンを使用して、このリクエストを実行できます。
機能	該当なし。
ページタスク	該当なし。
アクセス許可	該当なし。

例

投稿やコメントに掲載されているURLに関する情報を更新するには、https://graph.facebook.comにPOSTリクエストを送信します。その際、idパラメーターをそのURLに、scrapeパラメーターをtrueに設定し、URLに関する任意のfieldsと、その投稿やコメントを公開したユーザーまたはページからリクエストされたアクセストークンも指定します。

次の例は、ユーザーアクセストークンが表すユーザーによってシェアされるURL (https://www.facebook.com/my-update)を更新します。