年紀大了有些事容易忘記... 所以.....

星期二, 5月 20, 2014

2014 Facebook Application API & FB API 串接權限審核

這應該跟Facebook F8發表會所提到的有關,
所以現在只要你網站或APP使用到一些「特殊」功能(取得按讚數、取得生日資料、發佈照片資料等)

我大概測試了一下,只有新建的APP才需要做審核,
如果是舊有的APP,即使user至設定將該APP使用權限移除後再重新進入該APP授權
操作與權限都還是會與之前相同,別擔心

另外本次在 feed 這 method 看似也移除掉了分享預設文字的功能(所以以後分享不能設預設文字了?!!!)

如果你只需要用到下面三種權限的話則不需要審核
1.email
2.public_profile
3.user_friends

各權限的功能及範圍可以參考此篇
Permissions with Facebook Login
https://developers.facebook.com/docs/facebook-login/permissions/v2.0#permission-user_website

簡單來說 APP若想要向使用者要求Public profile、電子郵件以及朋友清單之外的權限就需要申請審核


送審則需要準備下列資訊
1.APP圖示(1024x1024, 16x16)
2.APP完整說明(APP用來做什麼 有什麼功能等)
3.隱私權保護政策頁
4.可能會需要4張活動螢幕截圖
5.如果有要特殊授權 如USER的生日、是否有按讚 那就要寫APP如何使用這資料 以及審查小組要如何審到這部份的流程

送審需要7~14個工作天 且必須是完成的活動網站送審

如果你使用到了該權限而你沒有審核的話,那你將看到這樣的訊息

※Facebook Developer API 更新記錄(更新日期2014/8/22)
https://developers.facebook.com/docs/apps/changelog













※2014/8/22 補充(專案送審分享)
最近做了一個專案是有 tag 好友及上傳圖片的,在送審的過程中倒是被退了蠻多次,
Facebook 的審核很快,大概隔天就審完了,假設你申請了3個權限要審,假設有2項沒審過,
他只會針對不通過的退件,另1項則會通過審核

在2014/8之後新增的App,只能使用 Facebook API 2.1 (不能使用舊版本要注意,僅只有先前的App可以選擇 v1.0 v2.0 v2.1)

下面大概說明一下送審要注意的地方
1.網站必需要先做完,並且串好API,這樣 Facebook 人員才可以連過去測試
2.在Facebook App未公開及未審過前,App管理者是可以使用所有權限的,因此,不影響開發
3.你必需在 Roles 建立 Test Users,如果你是要讀好友名單的話,那你要先建立多個 Test Users 並互加為好友
 (Facebook審核時只會用這些 Test Users 測試)
4.送審時,因為 Facebook 審核人員不懂英文,所以請用截圖,並在每個畫面上將要點擊的按鈕圈起並於說明,然後在申請權限時的Note裡,以 step-by-step 方式用英文說明,寫法規則如下:

 ※Open Graph Submission Process
 https://developers.facebook.com/docs/opengraph/submission-process
 請看 Usage Instruction Guidelines 這則

5.像我這個專案裡,用到了下列權限
 user_friends 讀好友名單  (此權限為基本,無需審核)
 Taggable Friends Tag好友 (此權限需申請)
 user_photos (上傳圖片到使用者相簿裡,同時並發佈在塗鴉牆)
 publish_actions  (發佈訊息到使用者的塗鴉牆)

6.在 Facebook 的規則裡,你不能在使用者貼文或是上傳圖片時,有預設的文字訊息,所有的一切說明,必需由使用者本身自行填寫(當然,也許可以等審過再加上去,但不知會不會被抓包就是了),下列影片有說明了一切

 ※Platform Policy 2.3 Example and Explanation
 https://developers.facebook.com/docs/apps/review/prefill

7.以上,祝各位送審都可以順順利利 ^_^


2014/8/20 補充
※Facebook 授權項目中文說明如下

使用者本身資料 :
email : 取得使用者的信箱資料。
publish_actions :可以用你的名義貼文
user_about_me    :關於你
user_actions.music :你的音樂應用程式的動態
user_actions.news : 你的新聞應用程式的動態
user_actions.video : 你的影片應用程式的動態
user_activities : 你的休閒愛好
user_birthday : 你的生日
user_education_history : 你的學歷
user_events : 你的活動
user_games_activity : 你的遊戲動態
user_groups : 你的社團
user_hometown :    你的家鄉
user_interests :    你的興趣
user_likes : 你按讚的內容
user_location : 你的位置
user_notes : 你的網誌
user_photos : 你的相片
user_questions : 你的「民調問答」
user_relationship_details : 你的感情狀態細項
user_relationships : 你的感情狀態
user_religion_politics : 你的宗教信仰與政治觀念
user_status : 你的近況更新
user_subscriptions : 你的訂閱者和訂閱名單
user_videos : 你的影片
user_website : 你的網站
user_work_history : 你的工作經歷

使用者朋友的資料 :
friends_about_me : 朋友的簡介
friends_actions.music : 朋友的音樂動態
friends_actions.news : 朋友的新聞動態
friends_actions.video : 朋友的影片動態
friends_activities : 朋友的
friends_birthday : 朋友的生日
friends_education_history : 朋友的學歷
friends_events : 朋友與你分享的活動
friends_games_activity : 朋友的遊戲動態
friends_groups : 朋友的社團資料
friends_hometown :     朋友的家鄉資料
friends_interests : 朋友的興趣資料
friends_likes : 朋友說讚的事物
friends_location : 朋友的地點
friends_notes : 朋友的分享給你的文章
friends_photos : 朋友與你分享的相片
friends_questions : 朋友與你分享的「民調問答」
friends_relationship_details : 朋友的感情狀態細節
friends_relationships : 朋友的感情狀態
friends_religion_politics : 朋友的宗教信仰與政治觀念
friends_status : 朋友的近況更新
friends_subscriptions : 訂閱者和訂閱者對像
friends_videos : 朋友與你分享的影片
friends_website : 朋友的網站
friends_work_history : 朋友的工作經歷

其他延伸的權限 :
ads_management : 管理你的廣告
create_event : 管理你的活動
create_note : 以你的名義貼文
export_stream : 存取你在動態消息的貼文
friends_online_presence : 存取朋友們的聯絡資料
manage_friendlists : 管理你自訂的朋友名單
manage_notifications : 管理你的通知設定
manage_pages : 管理你的粉絲專頁
offline_access :
photo_upload : 以你的名義貼文(圖片)
publish_checkins : 打卡動態
publish_stream : 以你的名義貼文(動態消息)
read_friendlists : 存取你自訂的朋友名單
read_insights : 洞察報告
read_mailbox : 存取你收件匣的訊息
read_page_mailboxes : 粉絲專頁訊息
read_requests : 存取你的交友邀請
read_stream : 存取你在動態消息的貼文
rsvp_event : 管理你的活動
share_item : 以你的名義貼文
sms : 傳送簡訊給你
status_update : 以你的名義貼文(近況)
user_online_presence : 存取你的聯絡資料
video_upload : 以你的名義貼文(影片)
xmpp_login : 存取聊天室





延伸閱讀
Facebook f8 2014終極攻略(一) – Anonymous Login、升級版Facebook Login與Login Review
http://blog.youmeb.com/archives/2078

Facebook Developers Review Guidelines
https://developers.facebook.com/docs/apps/review

Facebook Developers Login Review
https://developers.facebook.com/docs/apps/review/login
Facebook API 更新記錄
https://developers.facebook.com/docs/apps/changelog