使用对象

Facebook 支持使用包含对象和操作的强类型 API,从应用发布丰富的结构化快拍。对象是“名词”,即用户在应用中所执行操作的目标。

对象由网页中的开放图谱 HTML 标记定义。

创建对象

通过向托管内容的网页添加开放图谱元标签即可创建对象。

这些标签是将您的网页转变为对象所需的基本标签。请将这些标签添加到网页 HTML 的 <head> 中。

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

在有些托管和开发平台上,如果您在创建对象网页的同时将对象发布到开放图谱,系统可能会发出错误消息,指出对象不存在。这是某些系统中存在的争用情形所致。建议在将操作发布到开放图谱前验证是否已创建对象页面,或引入短暂延迟以应对复制滞后的情形(例如,延迟 15 - 30 秒)。


测试

您可通过分享调试器传递网址来测试标记。此操作将显示网络爬虫抓取的标签及任何错误或警告。

更新对象

在下列情况中,Facebook 爬虫会重新搜刮(并更新)对象:

  • 分享调试器中输入对象网址时
  • 第一次抓取后每隔 30 天
  • 应用使用 API 端点触发抓取操作时

此图谱 API 端点只会调用以下内容:

POST /?id={object-instance-id or object-url}&scrape=true

此端点返回的响应是一个 JSON 对象,包含有关被抓取对象的所有信息(从图谱 API 读取对象编号时将返回相同的数据)。

id 参数既可以是对象的标准网址,也可以是图表中对象实例的编号。


您可以编辑对象的属性,但以下两种情况例外:

  • 标题:如果某个对象已关联 50 个操作(赞、分享和评论),则无法更新该对象的标题
  • 类型:无法更改已在快拍中使用的对象类型。如需更多信息,请参阅开放图谱类型

如果想要更新对象的图像,强烈建议使用与原始图像网址不同的新图像网址。缓存可能会阻止图像更新。

网页迁移和网址更改

如果将某个网页移到新的网址,则可将旧网址用作新网址的权威来源,从而保留对象的赞、评论和分享。请参阅网站管理员分享指南,了解相关操作。