動態對話方塊

您可以將「動態對話方塊」新增至應用程式，讓用戶可以將個別的動態連同留言，一起發佈至其動態時報。

透過動態對話方塊分享動態不需要要求任何延伸權限。

整合

此對話方塊可以搭配 Facebook SDK for Javascript、iOS 和 Android，透過執行完整頁面重新導向至網址網址。以下是可以用來觸發此對話方塊的一些範例程式碼片段。

JavaScript

若要觸發「動態對話方塊」，請呼叫函式 FB.ui 並為 method 參數使用 feed 值。

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

請參閱也可讓您發佈開放社交關係圖動態的 iOS 分享對話方塊指南。

Android

請參閱也可讓您發佈開放社交關係圖動態的 Android 分享對話方塊。

網址重新導向

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

注意

如果某個用戶將「誰可以在你的動態時報上發佈貼文？」設定設定為「只限本人」，而另一個用戶嘗試使用「動態對話方塊」在第一個用戶的動態時報上貼文，則會顯示「無法發佈動態」錯誤。

參數

注意：如果您的應用程式分享指向 iTunes 或 Google Play 商店的連結，我們不會張貼您在分享中使用下列參數指定的任何圖像或說明。而是會張貼使用 Webcrawler 直接從應用程式商店或 Facebook 粉絲專頁抓取的部分應用程式資訊。此資訊可能不含圖像。若要預覽 iTunes 或 Google Play 的連結分享，請在分享偵錯工具中輸入您的網址。

參數	說明
`app_id`	應用程式的唯一識別碼。必要項目。
`redirect_uri`	用戶點擊對話方塊上的按鈕後，會重新導向至這個網址。使用網址重新導向時為必要項目。
`display`	決定對話方塊的轉譯方式。如果您使用網址重新導向對話方塊實作，則會在 Facebook.com 中以完整網頁顯示。此顯示類型稱為 `page`。如果您使用 Facebook iOS SDK 或 Facebook Android SDK 來叫用對話方塊，則會自動指定此項目並針對裝置選擇適當的顯示類型。如果您使用 Facebook SDK for JavaScript，此項目將針對登入您應用程式的用戶預設為強制回應 `iframe` 類型，在 Facebook.com 上的遊戲中使用時則預設為 `async`，其他情況則預設為 `popup` 視窗。如有需要，您還可以在使用 Facebook SDK for JavaScript 時強制使用 `popup` 或 `page` 類型。行動版網頁應用程式將一律預設為 `touch` 顯示類型。
`from`	張貼訊息之用戶的編號。若未指定，則預設為目前的用戶。若已指定，則必須是該用戶的編號，或是該用戶管理的粉絲專頁。
`to`	此動態將發佈到的個人檔案的編號。若未指定，則預設為 `from` 的值。此編號必須是也使用您應用程式的朋友。
`link`	附加至此貼文的連結。
`source`	附加至此貼文的媒體檔案（SWF 或 MP3）網址。若是 SWF，您也必須指定 `picture`，才能提供影片的縮圖。
`ref`	此引數是一個逗號分隔清單，其中包含最多 5 個不同的項目，每個長度為從 "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_" 中提取的至少 1 個字元，至多 15 個字元。Facebook 分析資料中會使用每個類別來協助您衡量不同類型貼文的成效

已停用的參數

參數	說明
`post_id`	如果用戶選擇發佈到其動態時報，則為所發佈動態的編號。
`properties`	索引鍵值組的 JSON 物件，將顯示在說明下方的串流影片附件中，其中每個屬性都各自位於一行。索引鍵必須是字串，而值可以是字串或包含索引鍵 `text` 和 `href` 的 JSON 物件。
`actions`	包含單一物件的 JSON 陣列，此物件說明顯示在貼文下方「留言」和「讚」旁邊的動作連結。包含的物件必須有索引鍵 `name` 和 `link`。
`picture`	附加至此貼文的圖片網址。圖片必須至少是 200x200 像素。如需有關大小的詳細資訊，請參閱我們文件中的分享最佳作法。
`name`	連結附件的名稱。
`caption`	連結的說明文字（顯示在連結名稱下方）。如果未指定，此欄位會自動填入連結網址。
`description`	連結的說明（顯示在連結說明文字下方）。如果未指定，此欄位會自動填入從連結抓取的資訊，通常是網頁的標題。
`thumbnail`	上傳的本機影像檔 `.jpg`、`.jpeg`、`.gif` 或 `.png`。