NOTE: THIS SDK IS DEPRECATED. WE ARE KNOW LONGER SUPPORTING IT AND IT WILL BE MADE PRIVATE SOON.
This SDK provides a light wrapper around the Facebook Graph API.
The easiest way to get started is to have Visual Studio. You can get a free copy of Visual C# 2010 Express Edition from Microsoft.
The instructions that follow will assume that are you using this version. The steps are very similar for other versions.
Once you have installed it and downloaded the source of the
SDK, you will need to
build the library. Open facebook/FacebookAPI.csproj
. It may ask you to create
a solution, in which case you can just use the default name. Right click on
FacebookAPI
in the Solution Explorer and choose Build. This shouldn't
take very long. The SDK is ready to use. You can either build on top of this
project, or use the DLL directly in another project.
There is a sample app included, which shows an example of the latter. Open
examples/FacebookSampleApp.csproj
. Again, it may ask you to create a
solution. Go to the Solution Explorer and right click on References
and choose Add a Reference. Navigate to the DLL you built and select it.
Now build the project, and run it. You should see the string Mark
Zuckerberg printed out, if everything worked.
Most data accessible via the Graph API required an access token. This SDK does not include a method of getting a token from a user, as the best method will depend on what type of application is using it. A desktop application might show a popup browser window that loads the Facebook site, for example. You can read more about obtaining an access token in the authentication guide.
First you instantiate an API object (passing in the token):
Facebook.FacebookAPI api = new Facebook.FacebookAPI(token);
If you pass in null
then you will only be able to access public data.
Then you make calls like:
JSONObject result = api.Get("/userid");
The JSONObject
class provides a wrapper around JSON that allows for automatic
type conversion. In particular, it can treat JSON as a Dictionary
, Array
,
String
, or Integer
. So to get the name of the userid as a string you would
do:
string name = result.Dictionary["name"].String;
The SDK also supports POST
and DELETE
requests, for writing data. For
example to delete a comment once you have gotten its id you could do:
api.Delete("/comment_id");
To write a post on a user's wall you could do:
Dictionary<string, string> postArgs = new Dictionary<string, string>();
postArgs["message"] = "Hello, world!";
api.Post("/userid/feed", postArgs);
More information on the API itself can be found in the developer documentation.
Any errors in making Graph API calls cause a FacebookAPIException
to be
thrown.