1\name{updateStatus} 2\Rdversion{1.1} 3\alias{updateStatus} 4\alias{deleteStatus} 5\alias{tweet} 6\title{ 7 Functions to manipulate Twitter status 8} 9\description{ 10 These functions can be used to set or delete a user's Twitter status 11} 12\usage{ 13tweet(text, ...) 14updateStatus(text, lat=NULL, long=NULL, placeID=NULL, 15 displayCoords=NULL, inReplyTo=NULL, mediaPath=NULL, 16 bypassCharLimit=FALSE, ...) 17deleteStatus(status, ...) 18} 19\arguments{ 20 \item{text}{The text to use for a new status } 21 \item{status}{An object of class \code{\link{status}}} 22 \item{lat}{If not \code{NULL}, the latitude the status refers to. Ignored if no \code{long} 23 parameter is provideded} 24 \item{long}{If not \code{NULL}, the longitude the status refers to. Ignored if no \code{lat} 25 parameter is provideded} 26 \item{placeID}{If not \code{NULL}, provideds a place in the world. See Twitter documentation for details} 27 \item{displayCoords}{Whether or not to put a pin on the exact coordinates a tweet has been sent from, 28 \code{true} or \code{false} if not \code{NULL}} 29 \item{inReplyTo}{If not \code{NULL}, denotes the status this is in reply to. Either an object of 30 class \code{\link{status}} or an ID value} 31 \item{mediaPath}{If not \code{NULL}, file path to a supported media format (PNG, JPG and GIF) to be included in the status update} 32 \item{bypassCharLimit}{If \code{TRUE} will not enforce the incoming tweet is less than 140 characters. This can be useful when dealing with autoshortened links} 33 \item{...}{Optional arguments to be passed to \code{\link{GET}}} 34} 35\details{ 36 These messages will only operate properly if the user is authenticated 37 via \code{OAuth} 38 39 The \code{tweet} and \code{updateStatus} functions are the same. 40 41 To delete a status message, pass in an object of class 42 \code{\link{status}}, such as from the return value of \code{updateStatus}. 43} 44\value{ 45 The \code{updateStatus} function will return an object of class 46 \code{\link{status}}. 47 48 The \code{deleteStatus} returns \code{TRUE} on success and an error if 49 failure occurs. 50} 51\author{ 52 Jeff Gentry 53} 54\examples{ 55 \dontrun{ 56 ns <- updateStatus('this is my new status message') 57 ## ooops, we want to remove it! 58 deleteStatus(ns) 59 } 60} 61\keyword{ interface } 62