flickrex v0.3.0 Flickr.Groups

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

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

Types

args()
args() :: Keyword.t
client()
client() :: Flickrex.Client.t
response()
response() :: Flickrex.Parser.response

Functions

browse(client, args \\ [])
browse(client, args) :: response

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.
get_info(client, args \\ [])
get_info(client, args) :: response

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(client, args \\ [])
join(client, args) :: response

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).

join_request(client, args \\ [])
join_request(client, args) :: response

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).

leave(client, args \\ [])
leave(client, args) :: response

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

search(client, args \\ [])
search(client, args) :: response

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.