class FlickRaw::Flickr::Galleries

Public Instance Methods

addPhoto(:gallery_id => 'gallery_id',:photo_id => 'photo_id',:comment => 'comment') click to toggle source

flickr.galleries.addPhoto request.

Add a photo to a gallery.

Arguments

gallery_id (required)

The ID of the gallery to add a photo to. Note: this is the compound ID returned in methods like flickr.galleries.getList, and flickr.galleries.getListForPhoto.

photo_id (required)

The photo ID to add to the gallery

comment

A short comment or story to accompany the photo.

Error codes

  • 1: Required parameter missing

    One or more required parameters was not included with your API call.

  • 2: Invalid gallery ID

    That gallery could not be found.

  • 3: Invalid photo ID

    The requested photo could not be found.

  • 4: Invalid comment

    The comment body could not be validated.

  • 5: Failed to add photo

    Unable to add the photo to the gallery.

  • 96: Invalid signature

    The passed signature was invalid.

  • 97: Missing signature

    The call required signing but no signature was sent.

  • 98: Login failed / Invalid auth token

    The login details or auth token passed were invalid.

  • 99: User not logged in / Insufficient permissions

    The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

# Generated automatically from flickr api
  def addPhoto(*args)
    @flickr.call 'flickr.galleries.addPhoto', *args
  end
create(:title => 'title',:description => 'description',:primary_photo_id => 'primary_photo_id',:full_result => 'full_result') click to toggle source

flickr.galleries.create request.

Create a new gallery for the calling user.

Arguments

title (required)

The name of the gallery

description (required)

A short description for the gallery

primary_photo_id

The first photo to add to your gallery

full_result

Get the result in the same format as galleries.getList

Error codes

  • 1: Required parameter missing

    One or more of the required parameters was missing from your API call.

  • 2: Invalid title or description

    The title or the description could not be validated.

  • 3: Failed to add gallery

    There was a problem creating the gallery.

  • 96: Invalid signature

    The passed signature was invalid.

  • 97: Missing signature

    The call required signing but no signature was sent.

  • 98: Login failed / Invalid auth token

    The login details or auth token passed were invalid.

  • 99: User not logged in / Insufficient permissions

    The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

Returns

# Generated automatically from flickr api
  def create(*args)
    @flickr.call 'flickr.galleries.create', *args
  end
editMeta(:gallery_id => 'gallery_id',:title => 'title',:description => 'description') click to toggle source

flickr.galleries.editMeta request.

Modify the meta-data for a gallery.

Arguments

gallery_id (required)

The gallery ID to update.

title (required)

The new title for the gallery.

description

The new description for the gallery.

Error codes

  • 1: Required parameter missing

    One or more required parameters was missing from your request.

  • 2: Invalid title or description

    The title or description arguments could not be validated.

  • 96: Invalid signature

    The passed signature was invalid.

  • 97: Missing signature

    The call required signing but no signature was sent.

  • 98: Login failed / Invalid auth token

    The login details or auth token passed were invalid.

  • 99: User not logged in / Insufficient permissions

    The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

# Generated automatically from flickr api
  def editMeta(*args)
    @flickr.call 'flickr.galleries.editMeta', *args
  end
editPhoto(:gallery_id => 'gallery_id',:photo_id => 'photo_id',:comment => 'comment') click to toggle source

flickr.galleries.editPhoto request.

Edit the comment for a gallery photo.

Arguments

gallery_id (required)

The ID of the gallery to add a photo to. Note: this is the compound ID returned in methods like flickr.galleries.getList, and flickr.galleries.getListForPhoto.

photo_id (required)

The photo ID to add to the gallery.

comment (required)

The updated comment the photo.

Error codes

  • 1: Invalid gallery ID

    That gallery could not be found.

  • 96: Invalid signature

    The passed signature was invalid.

  • 97: Missing signature

    The call required signing but no signature was sent.

  • 98: Login failed / Invalid auth token

    The login details or auth token passed were invalid.

  • 99: User not logged in / Insufficient permissions

    The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

# Generated automatically from flickr api
  def editPhoto(*args)
    @flickr.call 'flickr.galleries.editPhoto', *args
  end
editPhotos(:gallery_id => 'gallery_id',:primary_photo_id => 'primary_photo_id',:photo_ids => 'photo_ids') click to toggle source

flickr.galleries.editPhotos request.

Modify the photos in a gallery. Use this method to add, remove and re-order photos.

Arguments

gallery_id (required)

The id of the gallery to modify. The gallery must belong to the calling user.

primary_photo_id (required)

The id of the photo to use as the 'primary' photo for the gallery. This id must also be passed along in photo_ids list argument.

photo_ids (required)

A comma-delimited list of photo ids to include in the gallery. They will appear in the set in the order sent. This list must contain the primary photo id. This list of photos replaces the existing list.

Error codes

  • 96: Invalid signature

    The passed signature was invalid.

  • 97: Missing signature

    The call required signing but no signature was sent.

  • 98: Login failed / Invalid auth token

    The login details or auth token passed were invalid.

  • 99: User not logged in / Insufficient permissions

    The method requires user authentication but the user was not logged in, or the authenticated method call did not have the required permissions.

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

# Generated automatically from flickr api
  def editPhotos(*args)
    @flickr.call 'flickr.galleries.editPhotos', *args
  end
getInfo(:gallery_id => 'gallery_id') click to toggle source

flickr.galleries.getInfo request.

Arguments

gallery_id (required)

The gallery ID you are requesting information for.

Error codes

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

Returns

Cat Pictures I've Sent To Kevin Collins
# Generated automatically from flickr api
  def getInfo(*args)
    @flickr.call 'flickr.galleries.getInfo', *args
  end
getList(:user_id => 'user_id',:per_page => 'per_page',:page => 'page',:primary_photo_extras => 'primary_photo_extras') click to toggle source

flickr.galleries.getList request.

Return the list of galleries created by a user. Sorted from newest to oldest.

Arguments

user_id (required)

The NSID of the user to get a galleries list for. If none is specified, the calling user is assumed.

per_page

Number of galleries 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.

primary_photo_extras

A comma-delimited list of extra information to fetch for the primary photo. Currently supported fields are: 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_m, url_o

Error codes

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

Returns

I like me some black & whiteblack and whitesPeople Sleeping in Libraries
# Generated automatically from flickr api
  def getList(*args)
    @flickr.call 'flickr.galleries.getList', *args
  end
getListForPhoto(:photo_id => 'photo_id',:per_page => 'per_page',:page => 'page') click to toggle source

flickr.galleries.getListForPhoto request.

Return the list of galleries to which a photo has been added. Galleries are returned sorted by date which the photo was added to the gallery.

Arguments

photo_id (required)

The ID of the photo to fetch a list of galleries for.

per_page

Number of galleries 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.

Error codes

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

Returns

Vivitar Ultra Wide & Slim SelectionThe cheap and cheerful camera that isn't quite as cheap as it used to be.Awesome Pics
# Generated automatically from flickr api
  def getListForPhoto(*args)
    @flickr.call 'flickr.galleries.getListForPhoto', *args
  end
getPhotos(:gallery_id => 'gallery_id',:extras => 'extras',:per_page => 'per_page',:page => 'page') click to toggle source

flickr.galleries.getPhotos request.

Return the list of photos for a gallery

Arguments

gallery_id (required)

The ID of the gallery of photos to return

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.

Error codes

  • 100: Invalid API Key

    The API key passed was not valid or has expired.

  • 105: Service currently unavailable

    The requested service is temporarily unavailable.

  • 106: Write operation failed

    The requested operation failed due to a temporary issue.

  • 111: Format “xxx” not found

    The requested response format was not found.

  • 112: Method “xxx” not found

    The requested method was not found.

  • 114: Invalid SOAP envelope

    The SOAP envelope send in the request could not be parsed.

  • 115: Invalid XML-RPC Method Call

    The XML-RPC request document could not be parsed.

  • 116: Bad URL found

    One or more arguments contained a URL that has been used for abuse on Flickr.

Returns

best cat picture ever!
# Generated automatically from flickr api
  def getPhotos(*args)
    @flickr.call 'flickr.galleries.getPhotos', *args
  end