DocsToolsSupportNewsApps

group

API Reference › FQL › group

Description

A group which users can join as represented in FQL.

Columns

NameDescription

creator

number

The user ID of the user who created the group being queried.

description

string

The description of the group being queried.

email

string

The email address to upload content to the group being queried. Note that only an existing members of the group will be able to use this email address to upload content.)

gid

number

The group ID of the group being queried.

icon

string

The URL of the bookmark icon for the group being queried. The maximum dimensions will be 16px height and 16px width.

icon34

string

The URL of the bookmark icon for the group being queried. The maximum dimensions will be 34px height and 34px width. If a 34x34 size icon is unavailable this field will have the same value as icon)

icon50

string

The URL of the bookmark icon for the group being queried. The maximum dimensions will be 50px height and 50px width. If a 50x50 size icon is unavailable this field will have the same value as icon)

icon68

string

The URL of the bookmark icon for the group being queried. The maximum dimensions will be 68px height and 68px width. If a 68x68 size icon is unavailable this field will have the same value as icon)

name

string

The name of the group being queried.

nid

number

The network ID for the network to which the group being queried belongs, if any.

office

string

The location of the office of the group being queried.

parent_id

numeric string

The parent id of the group.

pic

string

The medium-sized photo for the group being queried. The image can have a maximum width of 100px and a maximum height of 300px. This URL may be blank.

pic_big

string

The largest-sized photo for the group being queried. The image can have a maximum width of 200px and a maximum height of 600px. This URL may be blank.

pic_cover

struct

The cover picture of the group.

cover_id

id

The ID of the cover photo

source

string

The source of the cover photo

offset_y

float

When non-zero, cover image overflows vertically. Value indicates the offset percentage of the total image height from top [0-100]

offset_x

float

When non-zero, cover image overflows horizontally. Value indicates the offset percentage of the total image width from left [0-100]

pic_small

string

The URL to the smallest-sized photo for the group being queried. The image can have a maximum width of 50px and a maximum height of 150px. This URL may be blank.

pic_square

string

The URL to the square profile picture for the groupbeing queried. The image can have a maximum widdth of 50px and amaximum height of 50px. This URL may be blank.

privacy

string

The privacy setting of the group being queried, indicating whether the group is OPEN, CLOSED, or SECRET.

recent_news

string

The contents of the Recent News field of the group being queried.

update_time

number

The last time the group being queried was updated.

venue

struct

The venue of the group being queried. This is an object containing street, city, state, country, zip, latitude, and longitude fields.

street

string

Street of the location

city

string

City of the location

state

string

State of the location

country

string

Country of the location

zip

string

Zip code of the location

latitude

float

Latitude of the location

longitude

float

Longitude of the location

id

id

ID of the location

name

string

Name of the location

located_in

id

ID of the parent location of this location

website

string

The URL for the Web site of the group being queried.

group_subtype

string

The group type for the group being queried. This field has been DEPRECATED AND REMOVED and is no longer supported. Please see the deprecation announcement.

group_type

string

The category of the group being queried. This field has been DEPRECATED AND REMOVED and is no longer supported. Please see the deprecation announcement.

Examples

  • SELECT ... FROM group WHERE gid = A
Note: Additional filters on other columns can be specified but they may make the query less efficient.

Permissions

To read the group table you need

  • any valid access_token if the group is public (i.e. the group's privacy setting is OPEN)
  • user_groups permission for a user's non-public groups or to see the bookmark_order or unread fields for a user's groups
  • friends_groups permission to see a user's friend's group membership
Facebook © 2013 · English (US)
AboutAdvertisingCareersPlatform PoliciesPrivacy Policy