/// <summary> /// lets logged-in user report spam /// </summary> /// <param name="userID">user id of alleged spammer</param> /// <param name="screenName">screen name of alleged spammer</param> /// <param name="callback">Async Callback used in Silverlight queries</param> /// <returns>Alleged spammer user info</returns> public static User ReportSpam(this TwitterContext ctx, string userID, string screenName, Action<TwitterAsyncResponse<User>> callback) { if (string.IsNullOrEmpty(userID) && string.IsNullOrEmpty(screenName)) { throw new ArgumentException("Either userID or screenName is a required parameter."); } string reportSpamUrl = ctx.BaseUrl + "users/report_spam.json"; var createParams = new Dictionary<string, string> { { "user_id", userID }, { "screen_name", screenName } }; var reqProc = new UserRequestProcessor<User>(); ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostToTwitter( reportSpamUrl, createParams, response => reqProc.ProcessActionResult(response, UserAction.SingleUser)); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
/// <summary> /// Update Twitter colors /// </summary> /// <remarks> /// The # character prefix is optional. At least one color argument must be provided. /// </remarks> /// <param name="background">background color</param> /// <param name="text">text color</param> /// <param name="link">link color</param> /// <param name="sidebarFill">sidebar color</param> /// <param name="sidebarBorder">sidebar border color</param> /// <param name="includeEntities">Set to false to not include entities. (default: true)</param> /// <param name="skipStatus">Don't include status with response.</param> /// <returns>User info with new colors</returns> public async Task<User> UpdateAccountColorsAsync(string background, string text, string link, string sidebarFill, string sidebarBorder, bool includeEntities, bool skipStatus, CancellationToken cancelToken = default(CancellationToken)) { var accountUrl = BaseUrl + "account/update_profile_colors.json"; if (string.IsNullOrWhiteSpace(background) && string.IsNullOrWhiteSpace(text) && string.IsNullOrWhiteSpace(link) && string.IsNullOrWhiteSpace(sidebarFill) && string.IsNullOrWhiteSpace(sidebarBorder)) throw new ArgumentException("At least one of the colors (background, text, link, sidebarFill, or sidebarBorder) must be provided as arguments, but none are specified.", NoInputParam); var reqProc = new UserRequestProcessor<User>(); RawResult = await TwitterExecutor.PostToTwitterAsync<User>( accountUrl, new Dictionary<string, string> { { "profile_background_color", string.IsNullOrWhiteSpace(background) ? null : background.TrimStart('#') }, { "profile_text_color", string.IsNullOrWhiteSpace(text) ? null : text.TrimStart('#') }, { "profile_link_color", string.IsNullOrWhiteSpace(link) ? null : link.TrimStart('#') }, { "profile_sidebar_fill_color", string.IsNullOrWhiteSpace(sidebarFill) ? null : sidebarFill.TrimStart('#') }, { "profile_sidebar_border_color", string.IsNullOrWhiteSpace(sidebarBorder) ? null : sidebarBorder.TrimStart('#') }, { "include_entities", includeEntities.ToString().ToLower() }, { "skip_status", skipStatus.ToString().ToLower() } }, cancelToken) .ConfigureAwait(false); return reqProc.ProcessActionResult(RawResult, UserAction.SingleUser); }
/// <summary> /// Removes banner from authenticated user's profile. /// </summary> /// <param name="callback">Async Callback.</param> /// <returns>Empty User instance.</returns> public static User RemoveProfileBanner(this TwitterContext ctx, Action<TwitterAsyncResponse<User>> callback) { var accountUrl = ctx.BaseUrl + "account/remove_profile_banner.json"; var reqProc = new UserRequestProcessor<User>(); ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostToTwitter( accountUrl, new Dictionary<string, string>(), response => reqProc.ProcessActionResult(response, UserAction.SingleUser)); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
public void ProcessActionResult_Parses_SingleUser_Response() { var reqProc = new UserRequestProcessor <User>(); User user = reqProc.ProcessActionResult(SingleUserResponse, UserAction.SingleUser); VerifySingleUserResponse(user); }
async Task<User> MuteAsync(IDictionary<string, string> muteParams, CancellationToken cancelToken = default(CancellationToken)) { var muteUrl = BaseUrl + "mutes/users/create.json"; var reqProc = new UserRequestProcessor<User>(); RawResult = await TwitterExecutor .PostToTwitterAsync<User>(muteUrl, muteParams, cancelToken) .ConfigureAwait(false); return reqProc.ProcessActionResult(RawResult, UserAction.SingleUser); }
public void ProcessActionResult_Parses_SingleUser_Response() { var reqProc = new UserRequestProcessor<User>(); User user = reqProc.ProcessActionResult(SingleUserResponse, UserAction.SingleUser); VerifySingleUserResponse(user); }
/// <summary> /// Sends an image to Twitter to be placed as the user's profile banner. /// </summary> /// <param name="banner">byte[] containing image data.</param> /// <param name="width">Pixel width to clip image.</param> /// <param name="height">Pixel height to clip image.</param> /// <param name="offsetLeft">Pixels to offset start of image from the left.</param> /// <param name="offsetTop">Pixels to offset start of image from the top.</param> /// <param name="callback">Async callback routine.</param> /// <returns> /// Account of authenticated user who's profile banner will be updated. /// Url of new banner will appear in ProfileBannerUrl property. /// </returns> public static User UpdateProfileBanner(this TwitterContext ctx, byte[] banner, string fileName, string imageType, int width, int height, int offsetLeft, int offsetTop, Action<TwitterAsyncResponse<User>> callback) { var accountUrl = ctx.BaseUrl + "account/update_profile_banner.json"; if (banner == null || banner.Length == 0) { throw new ArgumentException("banner is required.", "banner"); } if (string.IsNullOrEmpty(fileName)) { throw new ArgumentException("fileName is required.", "fileName"); } if (string.IsNullOrEmpty(imageType)) { throw new ArgumentException("imageType is required.", "imageType"); } var parameters = new Dictionary<string, string> { { "width", width.ToString() }, { "height", height.ToString() }, { "offset_left", offsetLeft.ToString() }, { "offset_top", offsetTop.ToString() }, { "banner", "IMAGE_DATA" } }; var reqProc = new UserRequestProcessor<User>(); ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostTwitterImage(accountUrl, parameters, banner, fileName, imageType, reqProc); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
/// <summary> /// Sends an image file to Twitter to replace user image. /// </summary> /// <param name="image">byte array of image to upload</param> /// <param name="fileName">name to pass to Twitter for the file</param> /// <param name="imageType">type of image: must be one of jpg, gif, or png</param> /// <param name="includeEntities">Set to false to not include entities. (default: true)</param> /// <param name="skipStatus">Don't include status with response.</param> /// <returns>User with new image info</returns> public async Task<User> UpdateAccountImageAsync(byte[] image, string fileName, string imageType, bool includeEntities, bool skipStatus, CancellationToken cancelToken = default(CancellationToken)) { var accountUrl = BaseUrl + "account/update_profile_image.json"; if (image == null || image.Length == 0) throw new ArgumentException("image is required.", "image"); if (string.IsNullOrWhiteSpace(fileName)) throw new ArgumentException("fileName is required.", "fileName"); if (string.IsNullOrWhiteSpace(imageType)) throw new ArgumentException("imageType is required.", "imageType"); var reqProc = new UserRequestProcessor<User>(); var parameters = new Dictionary<string, string> { { "include_entities", includeEntities.ToString().ToLower() }, { "skip_status", skipStatus.ToString().ToLower() } }; string name = "image"; string imageMimeType = "image/" + imageType; RawResult = await TwitterExecutor.PostMediaAsync(accountUrl, parameters, image, name, fileName, imageMimeType, cancelToken).ConfigureAwait(false); return reqProc.ProcessActionResult(RawResult, UserAction.SingleUser); }
/// <summary> /// Update account profile info /// </summary> /// <param name="name">User Name</param> /// <param name="url">Web Address</param> /// <param name="location">Geographic Location</param> /// <param name="description">Personal Description</param> /// <param name="includeEntities">Set to false to not include entities. (default: true)</param> /// <param name="skipStatus">Don't include status with response.</param> /// <param name="callback">Async Callback used in Silverlight queries</param> /// <returns>User with new info</returns> public static User UpdateAccountProfile(this TwitterContext ctx, string name, string url, string location, string description, bool includeEntities, bool skipStatus, Action<TwitterAsyncResponse<User>> callback) { var accountUrl = ctx.BaseUrl + "account/update_profile.json"; if (string.IsNullOrEmpty(name) && string.IsNullOrEmpty(url) && string.IsNullOrEmpty(location) && string.IsNullOrEmpty(description)) { throw new ArgumentException("At least one of the text fields (name, email, url, location, or description) must be provided as arguments, but none are specified.", NoInputParam); } if (!string.IsNullOrEmpty(name) && name.Length > 20) { throw new ArgumentException("name must be no longer than 20 characters", "name"); } if (!string.IsNullOrEmpty(url) && url.Length > 100) { throw new ArgumentException("url must be no longer than 100 characters", "url"); } if (!string.IsNullOrEmpty(location) && location.Length > 30) { throw new ArgumentException("location must be no longer than 30 characters", "location"); } if (!string.IsNullOrEmpty(description) && description.Length > 160) { throw new ArgumentException("description must be no longer than 160 characters", "description"); } var reqProc = new UserRequestProcessor<User>(); ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostToTwitter( accountUrl, new Dictionary<string, string> { { "name", name }, { "url", url }, { "location", location }, { "description", description }, { "include_entities", includeEntities.ToString().ToLower() }, { "skip_status", skipStatus.ToString().ToLower() } }, response => reqProc.ProcessActionResult(response, UserAction.SingleUser)); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
/// <summary> /// Update Twitter colors /// </summary> /// <remarks> /// The # character prefix is optional. At least one color argument must be provided. /// </remarks> /// <param name="background">background color</param> /// <param name="text">text color</param> /// <param name="link">link color</param> /// <param name="sidebarFill">sidebar color</param> /// <param name="sidebarBorder">sidebar border color</param> /// <param name="includeEntities">Set to false to not include entities. (default: true)</param> /// <param name="skipStatus">Don't include status with response.</param> /// <param name="callback">Async Callback used in Silverlight queries</param> /// <returns>User info with new colors</returns> public static User UpdateAccountColors(this TwitterContext ctx, string background, string text, string link, string sidebarFill, string sidebarBorder, bool includeEntities, bool skipStatus, Action<TwitterAsyncResponse<User>> callback) { var accountUrl = ctx.BaseUrl + "account/update_profile_colors.json"; if (string.IsNullOrEmpty(background) && string.IsNullOrEmpty(text) && string.IsNullOrEmpty(link) && string.IsNullOrEmpty(sidebarFill) && string.IsNullOrEmpty(sidebarBorder)) { throw new ArgumentException("At least one of the colors (background, text, link, sidebarFill, or sidebarBorder) must be provided as arguments, but none are specified.", NoInputParam); } var reqProc = new UserRequestProcessor<User>(); ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostToTwitter( accountUrl, new Dictionary<string, string> { { "profile_background_color", string.IsNullOrEmpty(background) ? (string)null : background.TrimStart('#') }, { "profile_text_color", string.IsNullOrEmpty(text) ? (string)null : text.TrimStart('#') }, { "profile_link_color", string.IsNullOrEmpty(link) ? (string)null : link.TrimStart('#') }, { "profile_sidebar_fill_color", string.IsNullOrEmpty(sidebarFill) ? (string)null : sidebarFill.TrimStart('#') }, { "profile_sidebar_border_color", string.IsNullOrEmpty(sidebarBorder) ? (string)null : sidebarBorder.TrimStart('#') }, { "include_entities", includeEntities.ToString().ToLower() }, { "skip_status", skipStatus.ToString().ToLower() } }, response => reqProc.ProcessActionResult(response, UserAction.SingleUser)); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
/// <summary> /// sends an image file to Twitter to replace background image /// </summary> /// <param name="image">full path to file, including file name</param> /// <param name="fileName">name to pass to Twitter for the file</param> /// <param name="imageType">type of image: must be one of jpg, gif, or png</param> /// <param name="tile">Tile image across background.</param> /// <param name="use">Whether to use uploaded background image or not</param> /// <param name="callback">Async Callback used in Silverlight queries</param> /// <param name="includeEntities">Set to false to not include entities. (default: true)</param> /// <param name="skipStatus">Don't include status with response.</param> /// <returns>User with new image info</returns> public static User UpdateAccountBackgroundImage(this TwitterContext ctx, byte[] image, string fileName, string imageType, bool tile, bool use, bool includeEntities, bool skipStatus, Action<TwitterAsyncResponse<User>> callback) { var accountUrl = ctx.BaseUrl + "account/update_profile_background_image.json"; if (image == null || image.Length == 0) { throw new ArgumentException("image is required.", "image"); } if (string.IsNullOrEmpty(fileName)) { throw new ArgumentException("fileName is required.", "fileName"); } if (string.IsNullOrEmpty(imageType)) { throw new ArgumentException("imageType is required.", "imageType"); } var parameters = new Dictionary<string, string> { { "include_entities", includeEntities.ToString().ToLower() }, { "skip_status", skipStatus.ToString().ToLower() } }; if (tile) { parameters.Add("tile", true.ToString().ToLower()); parameters.Add("use", use.ToString().ToLower()); } var reqProc = new UserRequestProcessor<User>(); ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostTwitterImage(accountUrl, parameters, image, fileName, imageType, reqProc); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
/// <summary> /// Allows removal of background image by setting back to the default background. Once the background image is removed /// it can not be turned back on. /// </summary> /// <param name="ctx"></param> /// <param name="skipStatus">Don't include status with response.</param> /// <returns></returns> public static User RemoveBackgroundImage(this TwitterContext ctx, bool skipStatus, Action<TwitterAsyncResponse<User>> callback) { var accountUrl = ctx.BaseUrl + "account/update_profile_background_image.json"; var reqProc = new UserRequestProcessor<User>(); ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostToTwitter( accountUrl, new Dictionary<string, string> { { "use", "false" }, { "skip_status", skipStatus.ToString()} }, response => reqProc.ProcessActionResult(response, UserAction.SingleUser)); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
/// <summary> /// sends an image file to Twitter to replace user image /// </summary> /// <remarks> /// You can only run this method with a period of time between executions; /// otherwise you get WebException errors from Twitter /// </remarks> /// <param name="imageFilePath">full path to file, including file name</param> /// <param name="skipStatus">Don't include status with response.</param> /// <param name="callback">Async Callback used in Silverlight queries</param> /// <returns>User with new image info</returns> public static User UpdateAccountImage(this TwitterContext ctx, string imageFilePath, bool skipStatus, Action<TwitterAsyncResponse<User>> callback) { var accountUrl = ctx.BaseUrl + "account/update_profile_image.json"; if (string.IsNullOrEmpty(imageFilePath)) { throw new ArgumentException("imageFilePath is required.", "imageFilePath"); } var reqProc = new UserRequestProcessor<User>(); var parameters = new Dictionary<string, string> { { "skip_status", skipStatus.ToString().ToLower() } }; ITwitterExecute exec = ctx.TwitterExecutor; exec.AsyncCallback = callback; var resultsJson = exec.PostTwitterFile(accountUrl, parameters, imageFilePath, reqProc); User user = reqProc.ProcessActionResult(resultsJson, UserAction.SingleUser); return user; }
/// <summary> /// Sends an image file to Twitter to replace background image. /// </summary> /// <param name="image">full path to file, including file name</param> /// <param name="mediaID">ID of media to use (posted via UploadMediaAsync)</param> /// <param name="fileName">name to pass to Twitter for the file</param> /// <param name="imageType">type of image: must be one of jpg, gif, or png</param> /// <param name="tile">Tile image across background.</param> /// <param name="includeEntities">Set to false to not include entities. (default: true)</param> /// <param name="skipStatus">Don't include status with response.</param> /// <returns>User with new image info</returns> public async Task<User> UpdateAccountBackgroundImageAsync(byte[] image, ulong mediaID, string fileName, string imageType, bool tile, bool includeEntities, bool skipStatus, CancellationToken cancelToken = default(CancellationToken)) { var accountUrl = BaseUrl + "account/update_profile_background_image.json"; if (mediaID == NoMediaID && image == NoImage) throw new ArgumentException("Either image or mediaID must be provided, but you haven't specified one.", nameof(image) + "Or" + nameof(mediaID)); if (mediaID == NoMediaID && image.Length == 0) throw new ArgumentException("Invalid image", nameof(image)); if (image != NoImage && mediaID != NoMediaID) throw new ArgumentException("Either image or mediaID must be provided, but not both", nameof(image) + "Or" + nameof(mediaID)); if (string.IsNullOrWhiteSpace(fileName)) throw new ArgumentException("fileName is required.", nameof(fileName)); if (string.IsNullOrWhiteSpace(imageType)) throw new ArgumentException("imageType is required.", nameof(imageType)); var parameters = new Dictionary<string, string> { { "include_entities", includeEntities.ToString().ToLower() }, { "skip_status", skipStatus.ToString().ToLower() } }; if (tile) parameters.Add("tile", true.ToString().ToLower()); if (mediaID != NoMediaID) parameters.Add("media_id", mediaID.ToString()); var reqProc = new UserRequestProcessor<User>(); string name = "image"; string imageMimeType = "image/" + imageType; if (image != NoImage) RawResult = await TwitterExecutor.PostMediaAsync(accountUrl, parameters, image, name, fileName, imageMimeType, cancelToken).ConfigureAwait(false); else RawResult = await TwitterExecutor.PostToTwitterAsync<User>(accountUrl, parameters, cancelToken).ConfigureAwait(false); return reqProc.ProcessActionResult(RawResult, UserAction.SingleUser); }
/// <summary> /// Update account profile info /// </summary> /// <param name="name">User Name</param> /// <param name="url">Web Address</param> /// <param name="location">Geographic Location</param> /// <param name="description">Personal Description</param> /// <param name="includeEntities">Set to false to not include entities. (default: true)</param> /// <param name="skipStatus">Don't include status with response.</param> /// <returns>User with new info</returns> public async Task<User> UpdateAccountProfileAsync(string name, string url, string location, string description, bool includeEntities, bool skipStatus, CancellationToken cancelToken = default(CancellationToken)) { var accountUrl = BaseUrl + "account/update_profile.json"; if (string.IsNullOrWhiteSpace(name) && string.IsNullOrWhiteSpace(url) && string.IsNullOrWhiteSpace(location) && string.IsNullOrWhiteSpace(description)) throw new ArgumentException("At least one of the text fields (name, email, url, location, or description) must be provided as arguments, but none are specified.", NoInputParam); if (!string.IsNullOrWhiteSpace(name) && name.Length > 20) throw new ArgumentException("name must be no longer than 20 characters", "name"); if (!string.IsNullOrWhiteSpace(url) && url.Length > 100) throw new ArgumentException("url must be no longer than 100 characters", "url"); if (!string.IsNullOrWhiteSpace(location) && location.Length > 30) throw new ArgumentException("location must be no longer than 30 characters", "location"); if (!string.IsNullOrWhiteSpace(description) && description.Length > 160) throw new ArgumentException("description must be no longer than 160 characters", "description"); var reqProc = new UserRequestProcessor<User>(); RawResult = await TwitterExecutor.PostToTwitterAsync<User>( accountUrl, new Dictionary<string, string> { { "name", name }, { "url", url }, { "location", location }, { "description", description }, { "include_entities", includeEntities.ToString().ToLower() }, { "skip_status", skipStatus.ToString().ToLower() } }, cancelToken) .ConfigureAwait(false); return reqProc.ProcessActionResult(RawResult, UserAction.SingleUser); }
/// <summary> /// Removes banner from authenticated user's profile. /// </summary> /// <returns>Empty User instance.</returns> public async Task<User> RemoveProfileBannerAsync(CancellationToken cancelToken = default(CancellationToken)) { var accountUrl = BaseUrl + "account/remove_profile_banner.json"; var reqProc = new UserRequestProcessor<User>(); RawResult = await TwitterExecutor.PostToTwitterAsync<User>( accountUrl, new Dictionary<string, string>(), cancelToken) .ConfigureAwait(false); return reqProc.ProcessActionResult(RawResult, UserAction.SingleUser); }
/// <summary> /// Sends an image to Twitter to be placed as the user's profile banner. /// </summary> /// <param name="banner">byte[] containing image data.</param> /// <param name="fileName">Name of file.</param> /// <param name="imageType">Type of file (e.g. png or jpg)</param> /// <param name="width">Pixel width to clip image.</param> /// <param name="height">Pixel height to clip image.</param> /// <param name="offsetLeft">Pixels to offset start of image from the left.</param> /// <param name="offsetTop">Pixels to offset start of image from the top.</param> /// <returns> /// Account of authenticated user who's profile banner will be updated. /// Url of new banner will appear in ProfileBannerUrl property. /// </returns> public async Task<User> UpdateProfileBannerAsync(byte[] banner, string fileName, string imageType, int width, int height, int offsetLeft, int offsetTop, CancellationToken cancelToken = default(CancellationToken)) { var accountUrl = BaseUrl + "account/update_profile_banner.json"; if (banner == null || banner.Length == 0) throw new ArgumentException("banner is required.", "banner"); if (string.IsNullOrWhiteSpace(fileName)) throw new ArgumentException("fileName is required.", "fileName"); if (string.IsNullOrWhiteSpace(imageType)) throw new ArgumentException("imageType is required.", "imageType"); var parameters = new Dictionary<string, string> { { "width", width.ToString() }, { "height", height.ToString() }, { "offset_left", offsetLeft.ToString() }, { "offset_top", offsetTop.ToString() }, //{ "banner", "FILE_DATA" } }; var reqProc = new UserRequestProcessor<User>(); string name = "banner"; string imageMimeType = "image/" + imageType; RawResult = await TwitterExecutor.PostMediaAsync(accountUrl, parameters, banner, name, fileName, imageMimeType, cancelToken).ConfigureAwait(false); return reqProc.ProcessActionResult(RawResult, UserAction.SingleUser); }