Facebook - 發佈訊息至塗鴉牆

源起

最近剛好有時間，想讓國軍登出倒數計時器擁有更好的UI。回顧FB Javascript API，原先FB.UI stream.publish發佈方法已經過時了，取而代之的是feed方法。毅然決然一邊修改一邊整理篇筆記，好讓鄉民們可以更快上手。首先我會說明Graph API是怎麼做的，接著再告訴大家如何透過Javascript使用FB Dialog做發佈塗鴉牆動作。

Graph API

打卡、送禮物、分享連結都是發佈至塗鴉牆的功能，使用相當廣泛。而它的核心，就是使用Graph API的user_id/feed做POST。我直接透過Graph API Explorer來做說明:

請用上方的API參數與下方的結果做比較。message通常是User輸入後的訊息；link有可能是你分享的連結或是使用者點擊後預計處理的動作，例如送禮物、開寶箱等，可能會連到App的某一個ActionURL；place就把它當成打卡地點，必須是地點id；picture必須要填入一個完整的URL；name、caption、description就是圖片右邊的那些文字了，如果沒輸入會直接從link中自動抓取metadata顯示。

picture的部分你也許想直接使用臉書上的照片，但這些照片必須有別人看的到的權限，否則會出現「FBCDN image is not allowed in stream」錯誤訊息。你可以選擇把照片放到網路上開放空間，我是放在picasa。如果是放在自己的Server，當user的朋友看到他post的feed時，就會去你的server讀取一次，這將會是一種資源浪費，所以要好好利用「網路資源」。假如是照片分享或打卡程式，應會先將照片上傳至User的相簿中，再做post feed的動作，這是另外一種做法。

Feed Dialog with Javascript

有了Graph API概念後，使用Javascript API就很簡單了! 直接看範例:

var publish = {
	display: 'iframe',
	method: 'feed',
	picture: 'https://blogger.googleusercontent.com/img/b/R29vZ2xl/AVvXsEjK3bPKKZPVInWG82QHnWJD9rKGQ7p41Ns_pexserBKiDYsPIXpiZsbQ_4Tdb_tdJgYg1ObG_D1-q0JRiCVWa4HY1yWrb8KM6dWCcvN3XgWKdoxcGRyWVK9-dmfMRrHrpFIn-0ygMuIvOI/s207/lacd_surprise.jpg',
	link: 'http://apps.facebook.com/leavearmycountdown/',
	name: '好好關注你的兄弟吧!',
	caption: ' ',
	description: message
};
FB.ui(publish, null);

在UI上某個button會bind onclcik的動作，會去呼叫上方javascript的method，就是把該填的東西填一填而已。display有其它幾種方式，iframe是我試過在各瀏覽器不會有問題的方法；而caption傳入空格目的是不想讓它以link顯示；FB.ui第二個參數是callback function，這裡我沒特別需要所已設為null；message欄位我在這沒宣告，因為我預期是要讓使用者自行輸入。

我習慣將與FB有關的東西集中放在一起，使用singleton的方式做宣告。

FacebookUtillity.postMessageToWall = function(post_message,
	post_picture, post_link, post_name, post_caption, post_desc, callback){
 
   var publish = {
    display: 'iframe',
	method: 'feed',
	picture: post_picture,
	link: post_link,
	name: post_name,
	caption: post_caption,
	description: post_desc,
	message: post_message
   };
   FB.ui(publish, callback);
};

如果想發佈至朋友的塗鴉牆呢? 多加一個to欄位即可。對於Graph API來說，就是對friend_uid/feed做POST，

Summary

如果你的應用程式是以iframe的方式顯示在Facebook中，會適合用Facebook Dialog的方式發佈，因為這較有UI整合性。但如果你是屬於另外一個web site或server side要做發佈的動作，可以透過Graph API。如果是iOS或Android也有SDK可以做出Dialog的效果喔。

阿兩的筆記本 Ryoutsu's Notebook

搜尋此網誌