/// <summary>
/// Adds a new comment to the object of the given type and id, f.ex. item 1.
/// <para>Podio API Reference: https://developers.podio.com/doc/comments/add-comment-to-object-22340 </para>
/// </summary>
/// <param name="type">The type.</param>
/// <param name="id">The identifier.</param>
/// <param name="comment">The comment.</param>
/// <param name="alertInvite">True if any mentioned user should be automatically invited to the workspace if the user does not have access to the object and access cannot be granted to the object. Default value: false</param>
/// <param name="silent">If set to true, the object will not be bumped up in the stream and notifications will not be generated. Default value: false</param>
/// <returns>Task<System.Int32>.</returns>
public async Task <int> AddCommentToObject(string type, int id, CommentCreateUpdateRequest comment, bool alertInvite = false, bool silent = false)
{
string url = string.Format("/comment/{0}/{1}/", type, id);
url = _podio.PrepareUrlWithOptions(url, new CreateUpdateOptions(alertInvite, silent));
dynamic response = await _podio.PostAsync <dynamic>(url, comment);
return((int)response["comment_id"]);
}
/// <summary>
/// Adds a new comment to the object of the given type and id with no reference to other objects
/// <para>Podio API Reference: https://developers.podio.com/doc/comments/add-comment-to-object-22340 </para>
/// </summary>
/// <param name="type">The type.</param>
/// <param name="id">The identifier.</param>
/// <param name="text">The comment to be made</param>
/// <param name="externalId">The external id of the comment</param>
/// <param name="fieldIds">Temporary files that have been uploaded and should be attached to this comment</param>
/// <param name="embedUrl">The url to be attached</param>
/// <param name="embedId">The id of an embedded link that has been created with the Add an embed operation in the Embed area</param>
/// <param name="alertInvite">True if any mentioned user should be automatically invited to the workspace if the user does not have access to the object and access cannot be granted to the object. Default value: false</param>
/// <param name="silent">If set to true, the object will not be bumped up in the stream and notifications will not be generated. Default value: false</param>
/// <returns>Task<System.Int32>.</returns>
public Task <int> AddCommentToObject(string type, int id, string text, string externalId = null, List <int> fieldIds = null, string embedUrl = null, int?embedId = null, bool alertInvite = false, bool silent = false)
{
CommentCreateUpdateRequest comment = new CommentCreateUpdateRequest()
{
Value = text,
ExternalId = externalId,
FieldIds = fieldIds,
EmbedUrl = embedUrl,
EmbedId = embedId
};
return(AddCommentToObject(type, id, comment, alertInvite, silent));
}
/// <summary>
/// Updates an already created comment. This should only be used to correct spelling and grammatical mistakes in the comment.
/// <para>Podio API Reference: https://developers.podio.com/doc/comments/update-a-comment-22346 </para>
/// </summary>
/// <param name="commentId">The comment identifier.</param>
/// <param name="text">The comment to be made</param>
/// <param name="externalId">The external id of the comment</param>
/// <param name="fieldIds">Temporary files that have been uploaded and should be attached to this comment</param>
/// <param name="embedUrl">The url to be attached</param>
/// <param name="embedId">The id of an embedded link that has been created with the Add an embed operation in the Embed area</param>
/// <returns>Task.</returns>
public Task UpdateComment(int commentId, string text, string externalId = null, List <int> fieldIds = null, string embedUrl = null, int?embedId = null)
{
var requestData = new CommentCreateUpdateRequest()
{
Value = text,
ExternalId = externalId,
FieldIds = fieldIds,
EmbedUrl = embedUrl,
EmbedId = embedId
};
return(UpdateComment(commentId, requestData));
}
/// <summary>
/// Updates an already created comment. This should only be used to correct spelling and grammatical mistakes in the comment.
/// </summary>
/// <param name="commentId">The comment identifier.</param>
/// <param name="comment">The comment.</param>
/// <returns>Task.</returns>
public Task UpdateComment(int commentId, CommentCreateUpdateRequest comment)
{
string url = string.Format("/comment/{0}", commentId);
return(_podio.PutAsync <dynamic>(url, comment));
}
