간단한 개발관련 내용

"SELECT uid2 FROM friend WHERE uid1=me()" 쿼리는 

GET /fql?q=SELECT+uid2+FROM+friend+WHERE+uid1=me()&access_token=...

SELECT name FROM user WHERE uid = me() 

SELECT uid, name, pic_square FROM user WHERE uid = me()
OR uid IN (SELECT uid2 FROM friend WHERE uid1 = me()) 

"query1":"SELECT uid, rsvp_status FROM event_member WHERE eid=12345678"

그 다음으로 참석자의 프로필 정보를 얻으려면(name, URL, 그리고 picture), 두 번째 쿼리를 만들어야만 합니다. – query2 – query1 으로부터의 결과를 참조합니다. 여러분은 query2 를 다음과 같이 명확하게 할 수 있습니다.:

"query2":"SELECT name, url, pic FROM profile WHERE id IN (SELECT uid FROM #query1)"

이방법 또한  batch.run. 을 호출한 fql.query의 묶음을 실행하는 것보다 더 나은 성능을 가실 수 있습니다. 

<?php
  $app_id = 'YOUR_APP_ID';
  $app_secret = 'YOUR_APP_SECRET';
  $my_url = 'POST_AUTH_URL';

  $code = $_REQUEST["code"];
 
 //auth user
 if(empty($code)) {
    $dialog_url = 'https://www.facebook.com/dialog/oauth?client_id=' 
    . $app_id . '&redirect_uri=' . urlencode($my_url) ;
    echo("<script>top.location.href='" . $dialog_url . "'</script>");
  }

  //get user access_token
  $token_url = 'https://graph.facebook.com/oauth/access_token?client_id='
    . $app_id . '&redirect_uri=' . urlencode($my_url) 
    . '&client_secret=' . $app_secret 
    . '&code=' . $code;
  $access_token = file_get_contents($token_url);
 
  // Run fql query
  $fql_query_url = 'https://graph.facebook.com/'
    . '/fql?q=SELECT+uid2+FROM+friend+WHERE+uid1=me()'
    . '&' . $access_token;
  $fql_query_result = file_get_contents($fql_query_url);
  $fql_query_obj = json_decode($fql_query_result, true);

  //display results of fql query
  echo '<pre>';
  print_r("query results:");
  print_r($fql_query_obj);
  echo '</pre>';

  // Run fql multiquery
  $fql_multiquery_url = 'https://graph.facebook.com/'
    . 'fql?q={"all+friends":"SELECT+uid2+FROM+friend+WHERE+uid1=me()",'
    . '"my+name":"SELECT+name+FROM+user+WHERE+uid=me()"}'
    . '&' . $access_token;
  $fql_multiquery_result = file_get_contents($fql_multiquery_url);
  $fql_multiquery_obj = json_decode($fql_multiquery_result, true);

  //display results of fql multiquery
  echo '<pre>';
  print_r("multi query results:");
  print_r($fql_multiquery_obj);
  echo '</pre>';
?>

https://www.facebook.com/dialog/oauth?


     client_id=YOUR_APP_ID&redirect_uri=YOUR_URL

좀 더 많은 정보를 원한다면 아래의 Alternate Redirect URIs section 을 보십시요.

만약 사용자가 이미 로그인 했다면, 페이스북은 사용자의 브라우저에 저장한 로그인 쿠키를 검증할 것이고 그 사용자를 인증할 것입니다. 만약에 사용자가 로그인하지 않았다면, 사용자들은 그들의 신용정보를 입력해야 할 것입니다.

https://www.facebook.com/dialog/oauth?


     client_id=YOUR_APP_ID&redirect_uri=YOUR_URL&scope=email,read_stream

아래 대화창의 결과는 사용자들이 인증받은 후에 보여집니다. :

http://YOUR_URL?error_reason=user_denied&


     error=access_denied&error_description=The+user+denied+your+request.

http://YOUR_URL?code=A_CODE_GENERATED_BY_SERVER

손으로 쓴 이 코드와 함께, 앱인증, API 호출을 위해 필요한 access token 을 얻기 위해서, 여러분은 다음 단계로 나아갈 수 있을 것입니다.

여러분의 앱을 인증하기 위해서, 여러분은 인증코드와 app secret을 https://graph.facebook.com/oauth/access_token. 에 redirect_uri가 붙은 Graph API 끝에 붙여서 보내야만 합니다.  app secret은 Developer App 에서부터 이용가능하고 어느누구에게 공유되어지거나 당신이 배포하는 어떤 코드에 포함되서는 안 됩니다(여러분은 이 이나리오를 클라이언트측 흐름에서만 사용해야 합니다).

https://graph.facebook.com/oauth/access_token?
     client_id=YOUR_APP_ID&redirect_uri=YOUR_URL&
     client_secret=YOUR_APP_SECRET&code=THE_CODE_FROM_ABOVE

만약 당신의 앱이 성공적으로 인증되었고 사용자의 권한코드가 유효한 것이라면, 그 인증서버는  access token을 반환할 것입니다. 

{
   "error": {
      "type": "OAuthException",
      "message": "Error validating verification code."
   }
}

 <?php 

   $app_id = "YOUR_APP_ID";
   $app_secret = "YOUR_APP_SECRET";
   $my_url = "YOUR_URL";

   session_start();
   $code = $_REQUEST["code"];

   if(empty($code)) {
     $_SESSION['state'] = md5(uniqid(rand(), TRUE)); //CSRF protection
     $dialog_url = "http://www.facebook.com/dialog/oauth?client_id=" 
       . $app_id . "&redirect_uri=" . urlencode($my_url) . "&state="
       . $_SESSION['state'];

     echo("<script> top.location.href='" . $dialog_url . "'</script>");
   }

   if($_REQUEST['state'] == $_SESSION['state']) {
     $token_url = "https://graph.facebook.com/oauth/access_token?"
       . "client_id=" . $app_id . "&redirect_uri=" . urlencode($my_url)
       . "&client_secret=" . $app_secret . "&code=" . $code;

     $response = @file_get_contents($token_url);
     $params = null;
     parse_str($response, $params);

     $graph_url = "https://graph.facebook.com/me?access_token=" 
       . $params['access_token'];

     $user = json_decode(file_get_contents($graph_url));
     echo("Hello " . $user->name);
   }
   else {
     echo("The state does not match. You may be a victim of CSRF.");
   }

 ?>

https://www.facebook.com/dialog/oauth?
     client_id=YOUR_APP_ID&redirect_uri=YOUR_URL&response_type=token

서버측 흐름에 따라, 여러분은 scope 매개변수를 사용해서 추가적인 승인을 요청할 수 있습니다.:

https://www.facebook.com/dialog/oauth?
     client_id=YOUR_APP_ID&redirect_uri=YOUR_URL&scope=email,read_stream&
     response_type=token

사용자가 인증되고 앱에 대한 권한을 받았을 때, 브라우저는 redirect_uri를 리다이렉트 하겠지만 서버측흐름에서는 권한 코드(code 매개변수를 통해서)를 전달하는 대신, redirect_uri는 URI 요소에 access token을 전달할 것입니다.(#access_token).:

http://YOUR_URL#access_token=166942940015970%7C2.sa0&expires_in=64090

access token 이 URI 요소로 전달되어지기 때문에, 클라이언트측 코드(브라우저에서 실행되는 자바스크립트나 웹을 제어하기위해 호스팅하는 데스크탑 코드)는 token을 추출할 수 있습니다. 앱인증은 개발자 앱의 Site URL로 설정되어 있는 같은 경로의 redirect_uri가  다양하게 처리되어 집니다. 좀더 많은 정보를 보려면  Alternate Redirect URIs 영역을 보십시요.

아래의 그림은 클라이언트측 흐름을 통해 HTTP 호출을 만든는 것을 나타냅니다. :

 <html> 
   <head> 
     <title>Client Flow Example</title> 
   </head> 
   <body> 
   <script> 
     function displayUser(user) {
       var userName = document.getElementById('userName');
       var greetingText = document.createTextNode('Greetings, '
         + user.name + '.');
   userName.appendChild(greetingText);
     }

     var appID = "YOUR_APP_ID";
     if (window.location.hash.length == 0) {
       var path = 'https://www.facebook.com/dialog/oauth?';
   var queryParams = ['client_id=' + appID,
     'redirect_uri=' + window.location,
     'response_type=token'];
   var query = queryParams.join('&');
   var url = path + query;
   window.open(url);
     } else {
       var accessToken = window.location.hash.substring(1);
       var path = "https://graph.facebook.com/me?";
   var queryParams = [accessToken, 'callback=displayUser'];
   var query = queryParams.join('&');
   var url = path + query;

   // use jsonp to call the graph
       var script = document.createElement('script');
       script.src = url;
       document.body.appendChild(script);        
     }
   </script> 
   <p id="userName"></p> 
   </body> 
  </html>

 https://graph.facebook.com/me?access_token=ACCESS_TOKEN 

만약에 사용자가 패스워드를 변경했다면, access token 은 만료되거나 그 사용자는 App Dashboard 에서 당신의 앱에 대한 권한이 해제될 것이고, Graph API HTTP 400 를 발행할 것이고 응답으로 오류를 반환할 것입니다. :

{
   "error": {
      "type": "OAuthException",
      "message": "Error validating access token."
   }
}  

당신의 앱은 이러한 오류가 발생했을경우 적절한 흐름을 재수행함으로서 새로운 access token을 요청할 수 있습니다.

https://www.facebook.com/logout.php?next=YOUR_URL&access_token=ACCESS_TOKEN 

Developer App 의 정의에 따라 YOUR_URL 은 여러분 사이트 도메인의 URL이어야만 합니다.

https://graph.facebook.com/oauth/access_token?client_id=YOUR_APP_ID&client_secret=YOUR_APP_SECRET&grant_type=client_credentials

위의 URL에 대한 HTTP GET 요청을 보내는 것은 그 응답의 내부에 access_token을 반환할 것입니다.:

https://graph.facebook.com/YOUR_APP_ID/insights?access_token=TOKEN_FROM_ABOVE

https://www.facebook.com/dialog/oauth?client_id=YOUR_APP_ID&redirect_uri=YOUR_URL&scope=manage_pages&response_type=token

https://graph.facebook.com/me/accounts?access_token=TOKEN_FROM_ABOVE

이 연결은 각페이지에 대하여 특정한 access token을 포함하는 페이지의 사용자 관리자들에 대한 모든 페이지들의 목록을 반환합니다. :

• 끼워진 웹 브라우저 그리고 클라이언트측 흐름을 사용하는 OAuth Dialog 로딩 (https://www.facebook.com/dialog/oauth)(i.e. response_type=token):

https://www.facebook.com/dialog/oauth?
    client_id=YOUR_APP_ID&
    redirect_uri=https://www.facebook.com/connect/login_success.html

• 사용자가 앱으로부터 권한을 얻은 후에, 페이스북은 사용자가 돌아올 수 있게 URI 요소에 있는 redirect_uri를 access token과 함께 리다이렉트 합니다.:

https://www.facebook.com/connect/login_success.html#access_token=...

• 이와 같은 리다이렉트를 인지하고 그 다음에 여러분의 프레임워크에 의해 제공되는 기술을 사용하는 URI읠 밖에서 access token을 읽으십시요. 

{
   "name": "Facebook Platform",
   "type": "page",
   "website": "http://developers.facebook.com",
   "username": "platform",
   "founded": "May 2007",
   "company_overview": "Facebook Platform enables anyone to build...",
   "mission": "To make the web more open and social.",
   "products": "Facebook Application Programming Interface (API)...",
   "likes": 449921,
   "id": 19292868552,
   "category": "Technology"
}

• Users: https://graph.facebook.com/btaylor (Bret Taylor)
• Pages: https://graph.facebook.com/cocacola (Coca-Cola page)
• Events: https://graph.facebook.com/251906384206 (Facebook Developer Garage Austin)
• Groups: https://graph.facebook.com/195466193802264 (Facebook Developers group)
• Applications: https://graph.facebook.com/2439131959 (the Graffiti app)
• Status messages: https://graph.facebook.com/367501354973 (A status message from Bret)
• Photos: https://graph.facebook.com/98423808305 (A photo from the Coca-Cola page)
• Photo albums: https://graph.facebook.com/99394368305 (Coca-Cola's wall photos)
• Profile pictures: http://graph.facebook.com/YooJooChang/picture (your profile picture)
• Videos: https://graph.facebook.com/817129783203 (A Facebook tech talk on Graph API)
• Notes: https://graph.facebook.com/122788341354 (Note announcing Facebook for iPhone 3.0)
• Checkins: https://graph.facebook.com/414866888308 (Check-in at a pizzeria)

페이스북 소셜 그래프의 모들 객체들은 관계를 통해서 각자 서로에게 연결되어져 있습니다. Bret Taylor 는 코카콜라 페이지의 팬이고, Bret Taylor 와 Arjun Banker 는 친구입니다. 우리는 우리의 API로 그러한 관계 연결들은 가져옵니다. 당신은 객체들 사이의 연결을 https://graph.facebook.com/ID/CONNECTION_TYPE URL구조를 사용해서 조사할 수 있습니다. 그 연결들은 아래에 있는 사람들과 페이지들을 위해 제공되어 집니다.

• Friends: https://graph.facebook.com/me/friends?access_token=...
• News feed: https://graph.facebook.com/me/home?access_token=...
• Profile feed (Wall): https://graph.facebook.com/me/feed?access_token=...
• Likes: https://graph.facebook.com/me/likes?access_token=...
• Movies: https://graph.facebook.com/me/movies?access_token=...
• Music: https://graph.facebook.com/me/music?access_token=...
• Books: https://graph.facebook.com/me/books?access_token=...
• Notes: https://graph.facebook.com/me/notes?access_token=...
• Permissions: https://graph.facebook.com/me/permissions?access_token=...
• Photo Tags: https://graph.facebook.com/me/photos?access_token=...
• Photo Albums: https://graph.facebook.com/me/albums?access_token=...
• Video Tags: https://graph.facebook.com/me/videos?access_token=...
• Video Uploads: https://graph.facebook.com/me/videos/uploaded?access_token=...
• Events: https://graph.facebook.com/me/events?access_token=...
• Groups: https://graph.facebook.com/me/groups?access_token=...
• Checkins: https://graph.facebook.com/me/checkins?access_token=...

우리가 지원하는 객체와 연결들의 모든 다른 형들은 그래프 API 참조문서(Graph API reference documentation)에 포함되어져 있습니다. 가장 쉽게 시작하는 방법은 Graph API Explorer 로 탐색하는 것입니다.

Authorization

 그래프 API는 당신이 객체와 관련한 모든 공공(공개된?) 정보에 쉽게 접근할 수 있도록 허용해 주는 것과 같은 것입니다.  예를 들면, https://graph.facebook.com/btaylor (Bret Taylor) 는 Bret 에 관한 모든 공개된 정보를 반환합니다. 예를 들면, 사용자의 이름, 가족이름 그리고 개인정보사진들은 공개적으로 이용할 수 있습니다.

 사용자에 대한 추가적인 정보를 얻기 위해서, 첫째로 당신은 사용자들의 권한을 얻어야만 합니다. 높은 레벨에서, 당신은 페이스북 사용자에 대한 access_token을 가질 필요가 있습니다. 당신이 사용자에 대한 access_token을 획득한 후에, 당신은 권한 있는 요청들을 수행할 수 있습니다. 

https://graph.facebook.com/220439?access_token=...

예를 들면 https://graph.facebook.com/btaylor?access_token=... (Bret Taylor) 은 Bret Taylor에 대한 추가적인 정보들을 반환합니다. 

 Graph API는 인증을 위해 OAuth2.0을 사용합니다. 페이스북의 OAuth2.0을 구현한 인증가이드라인을 읽고 사용자로부터 어떻게 권한을 요청하고 access token을 얻는지 확인하세요.

 access token을 얻는데는 추가적인 권한이 필요하지 않지만 이메일이나 현재 회사정보 등을 가져오려면 추가적인 권한 정보가 필요할 것입니다.

Page Login
manage_pages permission.

App Login 
app access token.

Reading

Selection
https://graph.facebook.com/bgolub?fields=id,name,picture 처럼 field param을 사용해서 원하는 요소들에 대한 값을 받을 수 있습니다.
https://graph.facebook.com?ids=arjun,vernal 단일 쿼리로 복수의 객체를 받을 수 있습니다.
ids param은 url도 받습니다. https://graph.facebook.com/?ids=http://www.imdb.com/title/tt0117500/

Pictures

아래와 같이 /picture 접미어를 사용해서 프로필 사진을 가져올 수 있습니다.:

• People: http://graph.facebook.com/YooJooChang/picture
• Events: http://graph.facebook.com/331218348435/picture
• Groups: http://graph.facebook.com/69048030774/picture
• Pages: http://graph.facebook.com/DoloresPark/picture
• Applications: http://graph.facebook.com/2318966938/picture
• Photo Albums: http://graph.facebook.com/platform/picture

• limit, offset: https://graph.facebook.com/me/likes?limit=3
• until, since (a unix timestamp or any date accepted by strtotime):https://graph.facebook.com/search?until=yesterday&q=orange

You can search over all public objects in the social graph with https://graph.facebook.com/search. The format is:

https://graph.facebook.com/search?q=QUERY&type=OBJECT_TYPE

아래와 같은 객체 형식들도 지원합니다.:

• All public posts: https://graph.facebook.com/search?q=watermelon&type=post
• People: https://graph.facebook.com/search?q=mark&type=user
• Pages: https://graph.facebook.com/search?q=platform&type=page
• Events: https://graph.facebook.com/search?q=conference&type=event
• Groups: https://graph.facebook.com/search?q=programming&type=group
• Places: https://graph.facebook.com/search?q=coffee&type=place&center=37.76,122.427&distance=1000
• Checkins: https://graph.facebook.com/search?type=checkin

fields= URL paramete의 사용:

• Event Names: https://graph.facebook.com/search?fields=name&q=conference&type=event

Some fields such as id, and start_time for events, are always returned.

homeconnection URL을 사용한 뉴스피드 검색:

• News Feed: https://graph.facebook.com/me/home?q=facebook

curl -F 'access_token=...' \
     -F 'message=Hello, Arjun. I like this new API.' \
     https://graph.facebook.com/arjun/feed

각각 /comments 나 /likes 를 사용해서 보낼 수 있습니다.
 https://graph.facebook.com/OBJECT_ID/comments 
 https://graph.facebook.com/OBJECT_ID/likes :

curl -F 'access_token=...' \
     https://graph.facebook.com/313449204401/likes

Deleting
 객체 url에 대한 HTTP DELETE 요청을 실행함으로써 객체를 삭제할 수 있습니다. 예시,

DELETE https://graph.facebook.com/ID?access_token=... HTTP/1.1

 POST 요청을 사용해서실행하는 방법이 있습니다. method=delete 를 param 값으로 사용하면 되는데 예시는 아래와 같습니다.
https://graph.facebook.com/COMMENT_ID?method=delete.

https://graph.facebook.com/app_id/insights?access_token=...

API를 통해서 다양한 분석 데이터들을 이용할 수 있으며 다음은 앱의 캔버스 페이지에 대한 노출수에 대한 url 입니다.:

https://graph.facebook.com/app_id/insights/application_canvas_views/day?access_token=...

또한 시간 범위에 대한 데이터도 이용할 수 있ㅅ브니다.:

https://graph.facebook.com/app_id/insights?access_token=...&since=yesterday

/insights URL 을 기반으로  Insights  상품을 탐색할 수 있습니다.

• Concepts
• Objects

<html>
    <head>
      <title>My Great Website</title>
    </head>
    <body>
      <div id="fb-root"></div>
      <script src="http://connect.facebook.net/en_US/all.js">
      </script>
      <script>
         FB.init({ 
            appId:'YOUR_APP_ID', cookie:true, 
            status:true, xfbml:true 
         });

         FB.ui({ method: 'feed', 
            message: 'Facebook for Websites is super-cool'});
      </script>
     </body>
 </html> 

curl -F 'access_token=...' \
     -F 'message=Facebook for Websites is super-cool.' \
     https://graph.facebook.com/<username>/feed

 <html>
   <head>
   <title>My Great Website</title>
   </head>
   <body>
   <div id="fb-root"></div>
   <script src="http://connect.facebook.net/en_US/all.js">
   </script>
   <script>
     FB.init({ 
       appId:'YOUR_APP_ID', cookie:true, 
       status:true, xfbml:true 
     });

     FB.ui({ method: 'apprequests', 
       message: 'Here is a new Requests dialog...'});
   </script>
   </body>
 </html>

이 예제는 Request Form을 표현하기 위해서 JavaScriptSDK를 사용합니다. 위의 예제가 띄워졌을 때, 그 결과는 아래의 요청경헙과 같습니다.

 만약 당신의 앱이 사용자에게 직접적으로 요청들을 보내기를 바란다면(앱이 생성한 요청), 당신은 User Graph 객체의 apprequest 연결에 대한 요청을 보낼 수 있다.

<?php 

  $app_id = YOUR_APP_ID;
  $app_secret = YOUR_APP_SECRET;

  $token_url = "https://graph.facebook.com/oauth/access_token?" .
    "client_id=" . $app_id .
    "&client_secret=" . $app_secret .
    "&grant_type=client_credentials";

  $app_access_token = file_get_contents($token_url);

  $user_id = THE_CURRENT_USER_ID;

  $apprequest_url ="https://graph.facebook.com/" .
    $user_id .
    "/apprequests?message='INSERT_UT8_STRING_MSG'" . 
    "&data='INSERT_STRING_DATA'&"  .   
    $app_access_token . "&method=post";

  $result = file_get_contents($apprequest_url);
  echo("App Request sent?", $result);
?>

 이 메시지 매개변수는 요청을 기술하기 위해 UTF-8 문자열입니다. 데이터 매개변수는 앱이 요청을 처리하기 위해 관련된 어떤 데이터들을 저장하기위해 사용할 수 있는 한 문자열입니다.

 요청을 보냈을 때 사용자가 받은 새요청들은 당신의 애플리케이션의 북마크에 개수로 볼 수 있을 것이고 또한 해당 대시보드 옆의 숫자수가 증가할 것입니다.

 <?php 

   $app_id = 'YOUR_APP_ID';
   $app_secret = 'YOUR_APP_SECRET';

   $token_url = "https://graph.facebook.com/oauth/access_token?" .
     "client_id=" . $app_id .
     "&client_secret=" . $app_secret .
     "&grant_type=client_credentials";

   $access_token = file_get_contents($token_url);

   $signed_request = $_REQUEST["signed_request"]; 
   list($encoded_sig, $payload) = explode('.', $signed_request, 2);
   $data = json_decode(base64_decode(strtr($payload, '-_', '+/')), true);
   $user_id = $data["user_id"];

   //Get all app requests for user
   $request_url ="https://graph.facebook.com/" .
     $user_id .
     "/apprequests?" .
     $access_token;
   $requests = file_get_contents($request_url);

   //Print all outstanding app requests
   echo '<pre>';
   print_r($requests);
   echo '</pre>';

   //Process and delete app requests
   $data = json_decode($requests);
   foreach($data->data as $item) {
    $id = $item->id;
    $delete_url = "https://graph.facebook.com/" .
    $id . "?" . $access_token;

    $delete_url = $delete_url . "&method=delete";
    $result = file_get_contents($delete_url);
    echo("Requests deleted? " . $result);
   }
 ?>

• Bookmarks
  Notifications
  Dashboards
  Usage Stories
  App Profiles & Search