使用物件

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 端點觸發抓取動作時

此 Graph API 端點只會向下列項目執行呼叫:

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

此端點的回應是一項 JSON 物件,其中包含所抓取物件的所有相關資訊(從 Graph API 讀取物件編號時傳回的相同資料)。

id 參數可以是物件的標準網址,或圖表中的物件實例編號。


您可以隨時編輯物件的屬性,但有兩個例外情況:

  • 標題:與物件相關的動作(讚好、分享和回應)一旦超過 50 個,您將無法更新其標題
  • 類型:一旦用於動態,物件的類型將不可變更。詳情請參閱開放式圖表類型

如果您要更新物件的圖像,我們強烈建議將該圖像的網址改成與原始圖像不同的網址。快取可能會令系統無法更新圖像。

網頁遷移與更改網址

如果您想將網頁移至新網址,您可以使用舊網址作為新網址的標準來源,同時保留物件的讚好、回應和分享。查閱我們的網站管理員的分享指南,以了解相關做法。