Graph:Group
From Facebook Developer Wiki (FbDevWiki.com)
A Facebook group
Contents |
Example
https://graph.facebook.com/2204501798 (Emacs users group)
Properties
| Name | Description | Permissions | Returns | Condition |
|---|---|---|---|---|
| id | The group ID | Publicly accessible | A JSON string | Always included |
| version | A flag which indicates if the group was created prior to launch of the current groups product in October 2010 | generic access_token, user_groups, or friends_groups | int where 0 = Old type Group, 1 = Current Group | Always included |
| icon | The URL for the group's icon. This seems to always be http://static.ak.fbcdn.net/rsrc.php/v1/y_/r/CbwcMZjMUbR.png when the version is 0. |
Publicly accessible | A JSON string containing a valid URL | Always included |
| owner | The profile that created this group | Publicly accessible | A JSON object containing the id and name fields |
|
| name | The name of the group | Publicly accessible | A JSON string | |
| description | A brief description of the group | Publicly accessible | A JSON string | |
| link | The URL for the group's website | Publicly accessible | A JSON string containing a valid URL | |
| privacy | The privacy setting of the group | Publicly accessible | A JSON string containing 'OPEN', 'CLOSED', or 'SECRET' | |
| updated_time | The last time the group was updated | Publicly accessible | A JSON string containing a IETF RFC 3339 datetime | |
| address to send messages to the entire group. It seems to always be of the form [group_id]@groups.facebook.com (Ex. https://graph.facebook.com/195466193802264 has 195466193802264@groups.facebook.com as it's email address) | string containing email address | when available |
Connections
| Name | Description | Permissions | Returns |
|---|---|---|---|
| feed | This group's wall | Publicly available | An array of Post objects. The comments on each post are limited to 2, but the rest can be retrieved by directly requesting the Post object and getting the '/comments' connection. |
| members | All of the users who are members of this group | Publicly available | An array of JSON objects containing member id, name, and administrator fields. Administrator is a JSON boolean.
|
| picture | The profile picture of this group | Publicly available | Returns a HTTP 302 with the URL of the user's profile picture |
| docs | The docs in this group | Publicly available | An array of Doc objects
|
Publishing
Requires the publish_stream permission.
To publish to the Group's feed, POST a message and optional attachment to the feed of the Group. See Post for more details and an example.
Notes/Bugs/Gotchas
Are the feed comments always contain 2 comments only?
(from the comments on the official documentation)
That is the summary of comment, just like facebook default, only 2 shows up unless you "read more" or "view all"... the graph call for "view all comments" is get the post ID of that post and append "/comment"...
example from K-On HTT group:
- FEED: https://graph.facebook.com/161439580553446/feed
- A POST FROM THE FEED: https://graph.facebook.com/161439580553446_177522428945161
- VIEW ALL COMMENTS: https://graph.facebook.com/161439580553446_177522428945161/comments