一個臉書應用程式,除了本身自己的功能外,會需要臉書的不過就是需要它的社交網路,取取資料、改改資料或貼貼資料。對使用Graph API而言,就是CRU(Create、Read、Update)。那Delete勒?我想除非是一個臉書功能相關的管理程式,像是Facebook手機版,否則不太會需要用到Delete。這些操作的內容,其實是對應到HTTP不同種類的request:
- HTTP Get: Read。Graph API中最廣泛的使用,取資料就靠它。
- HTTP Post: Create、Update、Delete。新增、修改、刪除資料都可以透過它,但大都用於新增與修改。
- HTTP Delete: Delete。刪除資料就靠它,但並非所有的Client都支援Delete的Request,所以POST request也提供刪除的功能。
為了讓大家容易了解,接下來我會透過範例,並使用Graph API Explorer示範這些操作。
- 我想知道我的好友中,有幾個裝這個應用程式。
- 我要發佈訊息到塗鴉牆。
- 我要刪除我發布的訊息。
HTTP Get
先前介紹Graph API所提到的操作,都是很單純的用HTTP Get去取得資料。今天在這我就介紹給大家一定會使用到的應用: 取得已安裝應用程式的朋友。在我的國軍登出倒數計時器APP中,提供了朋友的資訊,讓你知道有多少人安裝了這個APP。
除了主要功能會用到外,要邀請朋友當然也會需要去濾掉那些已經安裝的朋友們拉! 送禮物或索討禮物也會想先發給安裝的朋友們! 那我們該如何取到這樣的資訊呢?
「透過HTTP Get去取得朋友的清單,接著使用Field Selection功能去顯示出User Object的installed欄位。」
這個操作僅會使用到User的Object,包含friends connection與installed field。讓我們看看透過Explorer Query的結果:
如上圖所示,如果User的結果中有installed且為true,就代表它有安裝這個APP。
使用Graph API取資料,我認為要點是: 「先思考你要找的東西中心點為何? 它所對應的物件為何? 此中心點與要找的東西關聯性為何? 最後才看看你要的屬性為何?」
除了上述提到的Field Selection功能,Graph API還支援Paging、Locale、Search等功能。有興趣的鄉民可以至各連結或Document中研究與練習。
HTTP Post
常見如讚(like)、貼文(feed)、回文(comment)等,都是Post操作,使用也相當簡單。
假設我想告訴大家輔大操場有正妹,還要點讚推文好讓大家都看的到。我要做兩個Post操作: feed與like, 貼文(feed)的格式為:
https://graph.facebook.com/PROFILE_ID/feed
讚(like)的格式為:
https://graph.facebook.com/OBJECT_ID/likes
因為我要發佈到我的塗鴉牆,所以PROFILE_ID是我的ID或用me替代。接著新增一個field(Post操作才有),key為message,value就是把輔大有正妹的消息告訴大家。接著加上feed的connection:
在做完貼文的操作後,我們可以取得一個ID(這是PROFILE_ID和POST_ID串起來的),這就是OBJECT_ID。將它加上likes的connection:最後到塗鴉牆上,就可以發現有幾個色坏(我除外)來點讚了:
當你想新增或修改什麼東西的時候,「先看看中心物件為何?再看看此中心物件與你要新增修改的關係為何?」。這樣子就可以透過文件看看該如何做,去達到你想要的結果:
像打卡中心就是自己(User Object),checkins就是關係connections。從文件中可以知道必須至少給它地點ID與座標所在的參數。
HTTP Delete
Delete也相當容易,直接指定OBJECT_ID即可。
https://graph.facebook.com/OBJECT_ID
像是要砍掉在Post範例中的貼文:
需要另外注意的是:有些刪除動作是要打斷connections。之前點讚是透過對某物件的likes connections做Post,收回讚就是對某物件的likes connections做Delete就可以了!
我認為訣竅是:「刪物件用ID,斷連結用ID+Connections。」
Summary
不管是先前的Graph API介紹或本篇文章,目的都是為了讓大家了解“根本”,其實早就有人將Graph API包裝成各自語言的API了。但API該如何使用,或是如何擴充API都必須了解Graph API之根本才行。希望Graph API介紹系列的文章能給予大家一些幫助。
留言
張貼留言