/// <summary>
/// Returns the url to a group's page.
/// </summary>
/// <param name="groupId">The NSID of the group to fetch the url for.</param>
/// <returns>An instance of the <see cref="Uri"/> class containing the URL of the group page.</returns>
public string UrlsGetGroup(string groupId)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.urls.getGroup");
parameters.Add("group_id", groupId);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode node = response.GetXmlDocument().SelectSingleNode("*/@url");
return(node == null ? null : node.Value.Replace("http://", "https://"));
}
/// <summary>
/// Retrieve a temporary FROB from the Flickr service, to be used in redirecting the
/// user to the Flickr web site for authentication. Only required for desktop authentication.
/// </summary>
/// <remarks>
/// Pass the FROB to the <see cref="AuthCalcUrl"/> method to calculate the url.
/// </remarks>
/// <example>
/// <code>
/// string frob = flickr.AuthGetFrob();
/// string url = flickr.AuthCalcUrl(frob, AuthLevel.Read);
///
/// // redirect the user to the url above and then wait till they have authenticated and return to the app.
///
/// Auth auth = flickr.AuthGetToken(frob);
///
/// // then store the auth.Token for later use.
/// string token = auth.Token;
/// </code>
/// </example>
/// <returns>The FROB.</returns>
public string AuthGetFrob()
{
CheckSigned();
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.auth.getFrob");
UnknownResponse response = GetResponseNoCache <UnknownResponse>(parameters);
return(response.GetXmlDocument().SelectSingleNode("frob/text()").Value);
}
/// <summary>
/// Adds a new comment to a photo.
/// </summary>
/// <param name="photoId">The ID of the photo to add the comment to.</param>
/// <param name="commentText">The text of the comment. Can contain some HTML.</param>
/// <returns>The new ID of the created comment.</returns>
public string PhotosCommentsAddComment(string photoId, string commentText)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.photos.comments.addComment");
parameters.Add("photo_id", photoId);
parameters.Add("comment_text", commentText);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@id");
return(nav == null ? null : nav.Value);
}
/// <summary>
/// Returns a group NSID, given the url to a group's page or photo pool.
/// </summary>
/// <param name="urlToFind">The url to the group's page or photo pool.</param>
/// <returns>The ID of the group at the specified URL on success, a null reference (Nothing in Visual Basic) if the group cannot be found.</returns>
public string UrlsLookupGroup(string urlToFind)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.urls.lookupGroup");
parameters.Add("api_key", apiKey);
parameters.Add("url", urlToFind);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@id");
return(nav == null ? null : nav.Value.Replace("http://", "https://"));
}
/// <summary>
/// Returns the url to a user's profile.
/// </summary>
/// <param name="userId">The NSID of the user to fetch the url for. If omitted, the calling user is assumed.</param>
/// <returns>An instance of the <see cref="Uri"/> class containing the URL for the users profile.</returns>
public string UrlsGetUserProfile(string userId)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.urls.getUserProfile");
if (userId != null && userId.Length > 0)
{
parameters.Add("user_id", userId);
}
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@url");
return(nav == null ? null : nav.Value.Replace("http://", "https://"));
}
/// <summary>
/// Add a note to a picture.
/// </summary>
/// <param name="photoId">The photo id to add the note to.</param>
/// <param name="noteX">The X co-ordinate of the upper left corner of the note.</param>
/// <param name="noteY">The Y co-ordinate of the upper left corner of the note.</param>
/// <param name="noteWidth">The width of the note.</param>
/// <param name="noteHeight">The height of the note.</param>
/// <param name="noteText">The text in the note.</param>
/// <returns></returns>
public string PhotosNotesAdd(string photoId, int noteX, int noteY, int noteWidth, int noteHeight, string noteText)
{
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.photos.notes.add");
parameters.Add("photo_id", photoId);
parameters.Add("note_x", noteX.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_y", noteY.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_w", noteWidth.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_h", noteHeight.ToString(System.Globalization.NumberFormatInfo.InvariantInfo));
parameters.Add("note_text", noteText);
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode node = response.GetXmlDocument().SelectSingleNode("*/@id");
return(node == null ? null : node.Value);
}
/// <summary>
/// Gets the currently authenticated users default safety level.
/// </summary>
/// <returns></returns>
public SafetyLevel PrefsGetSafetyLevel()
{
CheckRequiresAuthentication();
var parameters = new Dictionary <string, string>();
parameters.Add("method", "flickr.prefs.getSafetyLevel");
UnknownResponse response = GetResponseCache <UnknownResponse>(parameters);
System.Xml.XmlNode nav = response.GetXmlDocument().SelectSingleNode("*/@safety_level");
if (nav == null)
{
throw new ParsingException("Unable to find safety level in returned XML.");
}
return((SafetyLevel)int.Parse(nav.Value, System.Globalization.NumberFormatInfo.InvariantInfo));
}