flickrex v0.6.0 Flickrex.Flickr.Groups View Source

Link to this section Summary

Functions

Browse the group category tree, finding groups and sub-categories

Get information about a group

Join a public group as a member

Request to join a group that is invitation-only

Leave a group

Search for groups. 18+ groups will only be returned for authenticated calls where the authenticated user is over 18

Link to this section Types

Link to this section Functions

Link to this function browse(args \\ []) View Source
browse(args()) :: operation()

Browse the group category tree, finding groups and sub-categories.

This method requires authentication with “read” permission.

Arguments

  • cat_id - The category id to fetch a list of groups and sub-categories for. If not specified, it defaults to zero, the root of the category tree.
Link to this function get_info(args \\ []) View Source
get_info(args()) :: operation()

Get information about a group.

This method does not require authentication.

Arguments

  • group_id - (required) The NSID of the group to fetch information for.

  • group_path_alias - The path alias of the group. One of this or the group_id param is required

  • lang - The language of the group name and description to fetch. If the language is not found, the primary language of the group will be returned. Valid values are the same as in feeds.

Join a public group as a member.

This method requires authentication with “write” permission.

Arguments

  • group_id - (required) The NSID of the Group in question

  • accept_rules - If the group has rules, they must be displayed to the user prior to joining. Passing a true value for this argument specifies that the application has displayed the group rules to the user, and that the user has agreed to them. (See flickr.groups.getInfo).

Link to this function join_request(args \\ []) View Source
join_request(args()) :: operation()

Request to join a group that is invitation-only.

This method requires authentication with “write” permission.

Arguments

  • group_id - (required) The NSID of the group to request joining.

  • message - (required) Message to the administrators.

  • accept_rules - (required) If the group has rules, they must be displayed to the user prior to joining. Passing a true value for this argument specifies that the application has displayed the group rules to the user, and that the user has agreed to them. (See flickr.groups.getInfo).

Link to this function leave(args \\ []) View Source
leave(args()) :: operation()

Leave a group.



If the user is the only administrator left, and there are other members, the oldest member will be promoted to administrator.

If the user is the last person in the group, the group will be deleted.

This method requires authentication with “delete” permission.

Arguments

  • group_id - (required) The NSID of the Group to leave

  • delete_photos - Delete all photos by this user from the group

Link to this function search(args \\ []) View Source
search(args()) :: operation()

Search for groups. 18+ groups will only be returned for authenticated calls where the authenticated user is over 18.

This method does not require authentication.

Arguments

  • text - (required) The text to search for.

  • per_page - Number of groups to return per page. If this argument is ommited, it defaults to 100. The maximum allowed value is 500.

  • page - The page of results to return. If this argument is ommited, it defaults to 1.