Facebook API Developers Guide

Content
About the Author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
About the Technical Reviewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
■CHAPTER 1 Introducing the Facebook Platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
What Is Facebook?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
A Brief History of Facebook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
The Elements of the Facebook Platform . . . . . . . . . . . . . . . . . . . . . . . . . 2
Facebook Markup Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
REST API Calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Facebook Query Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Facebook JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Client Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
■CHAPTER 2 Getting Ready for Facebook Application Development . . . . . . . . . . . 9
What’s Needed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Creating a Facebook Account. . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Understanding Facebook Layout and Terms . . . . . . . . . . . . . . . . . 10
Setting Up Your Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Adding the Developer Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Understanding How Facebook Applications Work . . . . . . . . . . . . . . . . . 15
Creating a New Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Facebook Terms of Service Highlights . . . . . . . . . . . . . . . . . . . . . 19
Using Facebook Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
API Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
XML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
JSON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
FBML Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Feed Preview Console Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Using Programming Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
■CHAPTER 3 Learning Facebook Platform Fundamentals . . . . . . . . . . . . . . . . . . . . 31
Client Library Primer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
API Primer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
FBML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
FQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Friends . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Marketplace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Photos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Data Store API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
FQL Primer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Functions and Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Facebook Markup Language Primer . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Valid HTML Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
FBML Tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Conditionals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
User/Group Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Profile Specific. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Embedded Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Visibility on Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Editor Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Page Navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Wall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Mock Ajax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Facebook JavaScript Primer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
DOM Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Putting It Together . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Things to Remember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
■CHAPTER 4 Building a Facebook Application, Start to Finish . . . . . . . . . . . . . . . . 71
Setting Up Eclipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Using Plug-Ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Remote Project Support (FTP/SFTP) . . . . . . . . . . . . . . . . . . . . . . . 73
PHP Development Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Data Tools Platform SQL Development Tools . . . . . . . . . . . . . . . . 78
Connecting to Your Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Layout Out the Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Creating the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Designing the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Working with SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Jumping In. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
External Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Game Review . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Add Game . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Publishing Feeds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Debugging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Launching Your Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Creating the About Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Creating a Logo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Submitting for Approval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Publicizing Your Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Advanced Techniques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
■CHAPTER 5 Going Further with Your Application. . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Application Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Monetizing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
AdSense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Amazon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Adonomics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Others . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Advertising Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Selling Your Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Help, I’m Stuck! (and Other Resources) . . . . . . . . . . . . . . . . . . . . . . . 136
Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136



Another Social Network Books
Download