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