图谱 API
图谱 API 版

网址 /?id={url}

表示在帖子或帖子评论中共享的网址。

如需获取其他信息，请参阅我们的新闻选项卡索引 API 文档。

读取

获取在帖子或帖子评论中所共享网址的相关信息。

要求

类型描述
访问口令

可用于发出此请求的任何访问口令。

功能

不适用。

公共主页任务

不适用。

权限

不适用。

限制

  • 返回的互动值并不精确，但确实能够反映用户与网址的互动情况。
  • 您每小时最多可向每个应用的每个网址发送 10 次 GET 请求。

参数

添加以下查询字符串参数以扩展请求。

参数描述

access_token

必要

字符串

访问口令。

fields

字符串

您想要请求的以逗号分隔的字段清单。

id

字符串

要分享的网址。

scopes

字符串

以逗号分隔的范围清单。

字段

属性名称 描述 类型
app_links

与此网址关联的应用链接数据（如有）。

AppLinks

id

网址本身。

string

engagement

用户与网址的不同互动方式计数。请注意，虽然这个互动率值并非精确无误，但您放心，该值将准确反映用户与某个网址的互动情况。

object

comment_count

网址中的评论数量。

int

comment_plugin_count

使用网站中的评论插件收集的有关插件的评论数量。

int

reaction_count

网址收到的心情数量。

int

share_count

网址被分享的次数。

int

og_object

与此网址相关的典型开放图谱对象。

OGObject

id

对象编号。

string

description

对象说明（如有）。

string

title

对象标题（如有）。

string

type

对象类型。

og:type

updated_time

对象上次更新时间。

datetime

示例

如要获取在帖子或评论中已发布网址的相关信息，请向 https://graph.facebook.com 发送 GET 请求，在该请求中加入 id 参数（设为网址）、与该网址相关的任何字段，以及从发布该帖子或评论的用户或公共主页请求获得的访问口令。

以下示例显示了对用户共享的网址 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}"

若请求成功，您的应用会收到对共享网址的以下互动量：

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

创建

您无法在此端点上执行此操作。

更新

更新网址。

要求

类型描述
访问口令

可用于发出此请求的任何访问口令。

功能

不适用。

公共主页任务

不适用。

权限

不适用。

示例

如要更新在帖子或评论中所发布网址的相关信息，请向 https://graph.facebook.com 发送 POST 请求，在该请求中将 id 参数设为网址，将 scrape 参数设为 true，将任何 fields 参数设为网址相关信息，将 access_token 设为向发布了帖子或评论的用户或公共主页所请求的访问口令。

以下示例更新了用户共享的网址 https://www.facebook.com/my-update，其中用户由用户访问口令表示。

为方便阅读，示例格式已经过调整。
curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

若请求成功，您的应用会收到对共享网址的以下互动量：

{
  "success": true
}

查询字符串参数

添加以下查询字符串参数以扩展请求。

参数描述

access_token

必要

字符串

访问口令。

fields

字符串

您想要请求的以逗号分隔的字段清单。

id

必要

字符串

要更新的网址。此网址必须经过编码，以免干扰 scrape 参数。

scrape

必要

布尔值

值必须为 true。

请求示例

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

响应示例

{
  "success": true
}

删除

您无法在此端点上执行此操作。