googleformr v0.0.3

0

Monthly downloads

0th

Percentile

Collect Data Programmatically by POST Methods to Google Forms

GET and POST data to Google Forms; an API to Google Forms, allowing users to POST data securely to Google Forms without needing authentication or permissioning.

Readme

Build
Status

googleformr is an API to Google Forms, allowing users to POST data securely to Google Forms without needing authentication or permissioning.

Installation

To download the development version of googleformr:

Download the zip ball or tar ball, decompress and run R CMD INSTALL on it, or use the pacman package to install the development version:

if (!require("pacman")) install.packages("pacman")
pacman::p_load_gh("data-steve/googleformr")

Get User Feedback with googleformr

googleformr comes with a comments_gformr function that was built with googleformr, allowing useRs to send comments to a Google Form I've created for collecting user feedback.

Not every useR has a github account for posting issues, nor do they run their own blog, nor do they have access to nearby useR groups. So finding new ways to stay accessible to my useRs is important to me.

Give it a try with something like below!

googleformr::comments_gformr(
        post_content = "It would useful for functionality to help distinguish in the data
                        between lots of comments from one useR vs. many useRs" )

Create your own comment function

You can create your own comments_pkg_name function by linking it to a Google Form using something along the lines of the code below:

  # create function
  form <- "your_google_form_url"
  comments_pkg_name <- googleformr::gformr(form
                                           , custom_reply = "Thanks for supporting pkg_name")

Note: it is recommended to call your comments function some clearly signalling a comment purpose but also something specific to your package. So a function name following the pattern comments_pkg_name should get the best of easy IntelliSense auto-complete and distinguishability from other packages using the same functionality

Once you rebuild your package and post it to github or CRAN, your useRs can send comments directly to you from the R console by simply putting their comments into your comments function.

  comments_pkg_name("useR comments")

Helper Functionality

You can test that your new comments_pkg_name function works by:

  • sending a test message to your Google Form and see if it shows up and/or
  • using the check_form_works function like so: check_form_works( comments_pkg_name("test") ). Either "All good" will appear or a specific http status message describing the error.

You can also extract Google Form question text or entry points using to make sure you can bring back the same information as is on your form:

# questions
form <- "your_google_form_url"
form %>% get_form() %>% get_form_questions()

# entry ids
form %>% get_form() %>% get_form_entry_ids()

Contact

You are welcome to:

Functions in googleformr

Name Description
comments_gformr Function to Collect Helful Comments about Googleformr
gformr Creates Function Linking Form Entries To Post Content
googleformr What the Package Does (one line)
get_form_entry_ids Get Google Form Entry Ids From Scrape
get_form_id Extract Form Id From Form URL
check_form_works Check If The Form Is Sending Correctly
make_url Make Either Get or Post Url for Google Forms
get_form_questions Extracts Google Form Question Text
get_form Scrape Google Form Content
No Results!

Last month downloads

Details

Date 2015-11-18
License GPL-2
LazyData TRUE
RoxygenNote 5.0.1
Collate 'check_form_works.R' 'get_form_id.R' 'make_url.R' 'get_form.R' 'get_form_entry_ids.R' 'gformr.R' 'comments_gformr.R' 'get_form_questions.R' 'googleformr-package.R'
NeedsCompilation no
Packaged 2016-04-29 18:43:35 UTC; ssimpson
Repository CRAN
Date/Publication 2016-04-29 23:59:27

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/googleformr)](http://www.rdocumentation.org/packages/googleformr)