flickrex v0.3.0 Flickr.Groups.Pools

Summary

Functions

Add a photo to a group’s pool

Returns next and previous photos for a photo in a group pool

Returns a list of groups to which you can add photos

Returns a list of pool photos for a given group, based on the permissions of the group and the user logged in (if any)

Remove a photo from a group pool

Types

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

Functions

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

Add a photo to a group’s pool.

This method requires authentication with “write” permission.

Arguments

  • photo_id - (required) The id of the photo to add to the group pool. The photo must belong to the calling user.

  • group_id - (required) The NSID of the group who’s pool the photo is to be added to.

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

Returns next and previous photos for a photo in a group pool.

This method does not require authentication.

Arguments

  • photo_id - (required) The id of the photo to fetch the context for.

  • group_id - (required) The nsid of the group who’s pool to fetch the photo’s context for.

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

Returns a list of groups to which you can add photos.

This method requires authentication with “read” permission.

Arguments

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

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

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

Returns a list of pool photos for a given group, based on the permissions of the group and the user logged in (if any).

This method does not require authentication.

Arguments

  • group_id - (required) The id of the group who’s pool you which to get the photo list for.

  • tags - A tag to filter the pool with. At the moment only one tag at a time is supported.

  • user_id - The nsid of a user. Specifiying this parameter will retrieve for you only those photos that the user has contributed to the group pool.

  • extras - A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: description, license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags, o_dims, views, media, path_alias, url_sq, url_t, url_s, url_q, url_m, url_n, url_z, url_c, url_l, url_o

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

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

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

Remove a photo from a group pool.

This method requires authentication with “write” permission.

Arguments

  • photo_id - (required) The id of the photo to remove from the group pool. The photo must either be owned by the calling user of the calling user must be an administrator of the group.

  • group_id - (required) The NSID of the group who’s pool the photo is to removed from.