使用物件

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 個時,您將無法更新其標題
  • 類型:一旦物件用於限時動態中,就無法變更其類型。如需更多資訊,請參閱開放社交關係圖類型

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

網頁移轉與變更網址

若要將網頁移至新網址,則可使用舊網址作為新網址的標準來源,同時保留物件的按讚、留言和分享。如需瞭解操作方式,請參閱網站管理員專用的分享指南