Add Tasks Samples and Tests (#14)

Author: averikitsch

cloud-tasks/README.md

@@ -0,0 +1,77 @@
+# Google Cloud Tasks Pull Queue Samples
+
+[![Open in Cloud Shell][shell_img]][shell_link]
+
+[shell_img]: http://gstatic.com/cloudssh/images/open-btn.png
+[shell_link]: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/nodejs-tasks&page=editor&open_in_editor=samples/README.md
+
+Sample command-line program for interacting with the Google Cloud Tasks API
+using pull queues.
+
+Pull queues let you add tasks to a queue, then programatically remove and
+interact with them. Tasks can be added or processed in any environment,
+such as on Google App Engine or Google Compute Engine.
+
+`tasks.js` is a simple command-line program to demonstrate listing queues,
+ creating tasks, and pulling and acknowledging tasks.
+
+## Before you begin
+
+ 1. Follow the steps in the
+[Before you begin section][before] of the client
+ library's README.  
+
+ 2. Install dependencies:
+
+    With **npm**:
+
+        npm install
+
+    With **yarn**:
+
+        yarn install
+
+[before]:../README.md#before-you-begin
+
+## Creating a queue
+
+To create a queue using the Cloud SDK, use the following gcloud command:
+
+    gcloud alpha tasks queues create pull my-pull-queue
+
+## Running the Samples
+
+Set the environment variables:
+
+First, your project ID:
+
+    export PROJECT_ID=my-project-id
+
+Then the queue ID, as specified at queue creation time. Queue IDs already
+created can be listed with `gcloud alpha tasks queues list`.
+
+    export QUEUE_ID=my-pull-queue
+
+And finally the location ID, which can be discovered with
+`gcloud alpha tasks queues describe $QUEUE_ID`, with the location embedded in
+the "name" value (for instance, if the name is
+"projects/my-project/locations/us-central1/queues/my-pull-queue", then the
+location is "us-central1").
+
+    export LOCATION_ID=us-central1
+
+Create a task for a queue:
+
+    node tasks.js create $PROJECT_ID $LOCATION_ID $QUEUE_ID
+
+Pull a task:
+
+    node tasks.js pull $PROJECT_ID $LOCATION_ID $QUEUE_ID
+
+Acknowledge task:
+
+    node tasks.js acknowledge <task>
+
+* where task is the output from pull task, example:  
+`'{"name":"projects/my-project-id/locations/us-central1/queues/my-queue/tasks/1234","scheduleTime":"2017-11-01T22:27:
+  53.628279Z"}'`