Graph 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,以及由發佈此帖子或回應的用戶或專頁所要求的存取憑證。

以下範例更新網址 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
}

刪除

您無法在此端點上執行此操作。