expand samples section

Author: JustinBeckwith

README.md

@@ -138,7 +138,7 @@ In the following examples, you may need a `CLIENT_ID`, `CLIENT_SECRET` and
 For more information about OAuth2 and how it works, [see here][oauth].
 
 A complete sample application that authorizes and authenticates with the OAuth2
-client is available at [`examples/oauth2.js`][oauthexample].
+client is available at [`samples/oauth2.js`][oauthexample].
 
 ##### Generating an authentication URL
 
@@ -296,7 +296,7 @@ jwtClient.authorize(function(err, tokens) {
 });
 ```
 
-The parameters for the JWT auth client including how to use it with a `.pem` file are explained in [examples/jwt.js](examples/jwt.js)
+The parameters for the JWT auth client including how to use it with a `.pem` file are explained in [samples/jwt.js](samples/jwt.js)
 
 #### Choosing the correct credential type automatically
 
@@ -391,7 +391,7 @@ drive.files.insert({
 ```
 
 For more examples of creation and modification requests with media attachments,
-take a look at the `examples/mediaupload.js` sample.
+take a look at the `samples/mediaupload.js` sample.
 
 ### Exposing request object
 
@@ -508,7 +508,7 @@ See [CONTRIBUTING][contributing].
 [overflowimg]: https://googledrive.com/host/0ByfSjdPVs9MZbkhjeUhMYzRTeEE/stackoveflow-tag.png
 [devconsole]: https://console.developer.google.com
 [oauth]: https://developers.google.com/accounts/docs/OAuth2
-[oauthexample]: https://github.com/google/google-api-nodejs-client/tree/master/examples/oauth2.js
+[oauthexample]: https://github.com/google/google-api-nodejs-client/tree/master/samples/oauth2.js
 [options]: https://github.com/google/google-api-nodejs-client/tree/master#options
 [gcloud]: https://github.com/GoogleCloudPlatform/gcloud-node
 [gcloudapis]: https://googlecloudplatform.github.io/gcloud-node/#/docs/gcloud

samples/README.md

@@ -0,0 +1,59 @@
+# Samples by API
+
+The following samples show basic usage of various APIs. 
+
+## ![](http://www.google.com/images/icons/product/analytics-32.png) Google Analytics API
+
+View and manage your Google Analytics data.
+
+Documentation for the Google Analytics API in
+[JSDoc](http://google.github.io/google-api-nodejs-client/2.1.7/analytics.html).
+
+<table>
+  <tr>
+    <td><a href="analytics">samples/analytics</a></td>
+    <td>Command-line samples for producing reports with the Analytics API</td>
+  </tr>
+</table>
+
+## ![](https://www.google.com/images/icons/product/compute_engine-32.png) Google Compute Engine Metadata API
+
+Lets you set key/value pairs using the GCE metadata service. 
+
+Documentation for the Google Compute Engine Metadata API in
+[JSDoc](http://google.github.io/google-api-nodejs-client/2.1.7/compute.html).
+
+<table>
+  <tr>
+    <td><a href="coordinate">samples/compute</a></td>
+    <td>Demonstrates how to use the Google Compute Engine Metadata API</td>
+  </tr>
+</table>
+
+## ![](http://www.google.com/images/icons/product/customsearch-32.png) CustomSearch API
+
+Lets you search over a website or collection of websites.
+
+Documentation for the CustomSearch API in
+[JSDoc](http://google.github.io/google-api-nodejs-client/2.1.7/customsearch.html).
+
+<table>
+  <tr>
+    <td><a href="customsearch">samples/customsearch</a></td>
+    <td>Search from the command-line</td>
+  </tr>
+</table>
+
+## ![](http://www.google.com/images/icons/product/shortlinks-32.png) URL Shortener API
+
+Lets you create, inspect, and manage `goo.gl` short URLs.
+
+Documentation for the URL Shortener API in
+[JSDoc](http://google.github.io/google-api-nodejs-client/2.1.7/urlshortener.html).
+
+<table>
+  <tr>
+    <td><a href="urlshortener">samples/urlshortener</a></td>
+    <td>Shortens a URL with the URL Shortener API</td>
+  </tr>
+</table>

samples/analytics/README.md

@@ -0,0 +1,9 @@
+# Analytics Samples
+
+The Google Analytics API lets you collect, configure, and analyze your data to reach the right audience.
+
+[Getting Started](https://developers.google.com/analytics/)
+
+## Running the sample
+
+`node analytics.js`

examples/analyticswrite.js renamed to samples/analytics/analytics.js

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-var google = require('../lib/googleapis.js');
+var google = require('../../lib/googleapis.js');
 var analytics = google.analytics('v3');
 var OAuth2Client = google.auth.OAuth2;
 

samples/compute/README.md

@@ -15,7 +15,7 @@
  */
 
 var request = require('request');
-var google = require('../lib/googleapis.js');
+var google = require('../../lib/googleapis.js');
 var compute = google.compute('v1');
 var uri = 'http://metadata/computeMetadata/v1/project/project-id';
 var headers = { 'Metadata-Flavor': 'Google' };

examples/compute.js renamed to samples/compute/compute.js

@@ -0,0 +1,9 @@
+# Custom Search API Samples
+
+Google Custom Search enables you to create a search engine for your website, your blog, or a collection of websites.
+
+[Getting Started](https://developers.google.com/custom-search/)
+
+## Running the sample
+
+`node customsearch.js`

samples/customsearch/README.md

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-var google = require('../lib/googleapis.js');
+var google = require('../../lib/googleapis.js');
 var customsearch = google.customsearch('v1');
 
 // You can get a custom search engine id at