網址 /?id={url}

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

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

讀取

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

需求

限制

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

參數

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

欄位

範例

若要取得在貼文或留言中所發佈之網址的相關資訊，請向 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
}  

查詢字串參數

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

要求範例

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

回應範例

{
  "success": true
}

刪除

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