圖形 API
圖形 API 版本

網址 /?id={url}

代表在貼文或貼文留言中分享的網址。

其他資訊請參閱我們的新聞頁籤索引 API 文件。

讀取

取得在貼文或貼文留言中分享的網址相關資訊。

需求

類型說明
存取權杖

可使用任何存取權杖來提出此要求。

功能

不適用。

粉絲專頁任務

不適用。

權限

不適用。

限制

  • 傳回的互動值並不精確，但確實能夠反映用戶與網址的互動。
  • 每個小時、每個應用程式、每個網址只能有 10 個 GET 要求。

參數

加入下列查詢字串參數，以擴充要求。

參數說明

access_token

必填

字串

存取權杖。

fields

字串

您想要求的欄位逗號分隔清單。

id

字串

要分享的網址。

scopes

字串

範圍的逗號分隔清單。

欄位

屬性名稱 說明 類型
app_links

與此網址產生關聯的 AppLinks 資料（如果適用）。

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
}

刪除

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