add all readmes

README.md

@@ -83,9 +83,21 @@ If you are not running this client on Google Compute Engine, you need a Google D
 1. Visit the [Google Developers Console][dev-console].
 2. Create a new project or click on an existing project.
 3. Navigate to  **APIs & auth** > **APIs section** and turn on the following APIs (you may need to enable billing in order to use these services):
+  * BigQuery API
+  * Cloud Bigtable API
+  * Cloud Bigtable Admin API
+  * Cloud Bigtable Table Admin API
   * Google Cloud Datastore API
+  * Google Cloud DNS API
+  * Google Cloud Logging API
+  * Google Cloud Natural Language API
+  * Google Cloud Pub/Sub API
   * Google Cloud Storage
   * Google Cloud Storage JSON API
+  * Google Cloud Vision API
+  * Google Compute Engine API
+  * Google Translate API
+  * Prediction API
 4. Navigate to **APIs & auth** >  **Credentials** and then:
   * If you want to use a new service account, click on **Create new Client ID** and select **Service account**. After the account is created, you will be prompted to download the JSON key file that the library uses to authenticate your requests.
   * If you want to generate a new key for an existing service account, click on **Generate new JSON key** and download the JSON key file.
@@ -464,6 +476,7 @@ var storage = require('@google-cloud/storage');
 
 ```js
 var fs = require('fs');
+
 // Authenticating on a per-API-basis. You don't need to do this if you auth on a
 // global basis (see Authentication section above).
 
@@ -1083,7 +1096,7 @@ Apache 2.0 - See [COPYING](COPYING) for more information.
 
 [cloud-bigquery-docs]: https://cloud.google.com/bigquery/what-is-bigquery
 
-[cloud-bigtable-docs]: https://cloud.google.com/bigtable/docs/
+[cloud-bigtable-docs]: https://cloud.google.com/bigtable/docs
 [cloud-bigtable-cluster]: https://cloud.google.com/bigtable/docs/creating-compute-instance
 
 [cloud-compute-docs]: https://cloud.google.com/compute/docs

packages/bigquery/README.md

@@ -60,9 +60,7 @@ If you are not running this client on Google Compute Engine, you need a Google D
 1. Visit the [Google Developers Console][dev-console].
 2. Create a new project or click on an existing project.
 3. Navigate to  **APIs & auth** > **APIs section** and turn on the following APIs (you may need to enable billing in order to use these services):
-  * Google Cloud Datastore API
-  * Google Cloud Storage
-  * Google Cloud Storage JSON API
+  * BigQuery API
 4. Navigate to **APIs & auth** >  **Credentials** and then:
   * If you want to use a new service account, click on **Create new Client ID** and select **Service account**. After the account is created, you will be prompted to download the JSON key file that the library uses to authenticate your requests.
   * If you want to generate a new key for an existing service account, click on **Generate new JSON key** and download the JSON key file.

packages/bigtable/README.md

@@ -0,0 +1,109 @@
+# @google-cloud/bigtable
+> Google Cloud Bigtable Client Library for Node.js
+
+*Looking for more Google APIs than just Bigtable? You might want to check out [`google-cloud`][google-cloud].*
+
+- [API Documentation][gcloud-bigtable-docs]
+- [Official Documentation][cloud-bigtable-docs]
+
+*You may need to [create a cluster][cloud-bigtable-cluster] to use the Google Cloud Bigtable API with your project.*
+
+
+```sh
+$ npm install --save @google-cloud/bigtable
+```
+```js
+var bigtable = require('@google-cloud/bigtable')({
+  projectId: 'grape-spaceship-123',
+  keyFilename: '/path/to/keyfile.json',
+  zone: 'my-zone',
+  cluster: 'my-cluster'
+});
+
+var table = bigtable.table('prezzy');
+
+table.getRows(function(err, rows) {});
+
+// Update a row in your table.
+var row = table.row('alincoln');
+
+row.save('follows:gwashington', 1, function(err) {
+  if (err) {
+    // Error handling omitted.
+  }
+
+  row.get('follows:gwashington', function(err, data) {
+    if (err) {
+      // Error handling omitted.
+    }
+
+    // data = {
+    //   follows: {
+    //     gwashington: [
+    //       {
+    //         value: 1
+    //       }
+    //     ]
+    //   }
+    // }
+  });
+});
+```
+
+
+## Authentication
+
+It's incredibly easy to get authenticated and start using Google's APIs. You can set your credentials on a global basis as well as on a per-API basis. See each individual API section below to see how you can auth on a per-API-basis. This is useful if you want to use different accounts for different Google Cloud services.
+
+### On Google Compute Engine
+
+If you are running this client on Google Compute Engine, we handle authentication for you with no configuration. You just need to make sure that when you [set up the GCE instance][gce-how-to], you add the correct scopes for the APIs you want to access.
+
+``` js
+// Authenticating on a global basis.
+var projectId = process.env.GCLOUD_PROJECT; // E.g. 'grape-spaceship-123'
+
+var bigtable = require('@google-cloud/bigtable')({
+  projectId: projectId
+});
+
+// ...you're good to go! See the next section to get started using the API.
+```
+
+### Elsewhere
+
+If you are not running this client on Google Compute Engine, you need a Google Developers service account. To create a service account:
+
+1. Visit the [Google Developers Console][dev-console].
+2. Create a new project or click on an existing project.
+3. Navigate to  **APIs & auth** > **APIs section** and turn on the following APIs (you may need to enable billing in order to use these services):
+  * Cloud Bigtable API
+  * Cloud Bigtable Admin API
+  * Cloud Bigtable Table Admin API
+4. Navigate to **APIs & auth** >  **Credentials** and then:
+  * If you want to use a new service account, click on **Create new Client ID** and select **Service account**. After the account is created, you will be prompted to download the JSON key file that the library uses to authenticate your requests.
+  * If you want to generate a new key for an existing service account, click on **Generate new JSON key** and download the JSON key file.
+
+``` js
+var projectId = process.env.GCLOUD_PROJECT; // E.g. 'grape-spaceship-123'
+
+var bigtable = require('@google-cloud/bigtable')({
+  projectId: projectId,
+
+  // The path to your key file:
+  keyFilename: '/path/to/keyfile.json'
+
+  // Or the contents of the key file:
+  credentials: require('./path/to/keyfile.json')
+});
+
+// ...you're good to go! See the next section to get started using the APIs.
+```
+
+
+[google-cloud]: https://github.com/GoogleCloudPlatform/gcloud-node
+[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
+[dev-console]: https://console.developers.google.com/project
+[gcloud-bigtable-docs]: https://googlecloudplatform.github.io/gcloud-node/#/docs/bigtable
+[cloud-bigtable-docs]: https://cloud.google.com/bigtable/docs
+[cloud-bigtable-cluster]: https://cloud.google.com/bigtable/docs/creating-compute-instance

packages/compute/README.md

@@ -0,0 +1,88 @@
+# @google-cloud/compute
+> Google Compute Engine Client Library for Node.js
+
+*Looking for more Google APIs than just Compute Engine? You might want to check out [`google-cloud`][google-cloud].*
+
+- [API Documentation][gcloud-compute-docs]
+- [Official Documentation][cloud-compute-docs]
+
+
+```sh
+$ npm install --save @google-cloud/compute
+```
+```js
+var gce = require('@google-cloud/compute')({
+  projectId: 'grape-spaceship-123',
+  keyFilename: '/path/to/keyfile.json'
+});
+
+// Create a new VM using the latest OS image of your choice.
+var zone = gce.zone('us-central1-a');
+var name = 'ubuntu-http';
+
+zone.createVM(name, { os: 'ubuntu' }, function(err, vm, operation) {
+  // `operation` lets you check the status of long-running tasks.
+
+  operation
+    .on('error', function(err) {})
+    .on('running', function(metadata) {})
+    .on('complete', function() {
+      // Virtual machine created!
+    });
+});
+```
+
+
+## Authentication
+
+It's incredibly easy to get authenticated and start using Google's APIs. You can set your credentials on a global basis as well as on a per-API basis. See each individual API section below to see how you can auth on a per-API-basis. This is useful if you want to use different accounts for different Google Cloud services.
+
+### On Google Compute Engine
+
+If you are running this client on Google Compute Engine, we handle authentication for you with no configuration. You just need to make sure that when you [set up the GCE instance][gce-how-to], you add the correct scopes for the APIs you want to access.
+
+``` js
+// Authenticating on a global basis.
+var projectId = process.env.GCLOUD_PROJECT; // E.g. 'grape-spaceship-123'
+
+var gce = require('@google-cloud/compute')({
+  projectId: projectId
+});
+
+// ...you're good to go! See the next section to get started using the API.
+```
+
+### Elsewhere
+
+If you are not running this client on Google Compute Engine, you need a Google Developers service account. To create a service account:
+
+1. Visit the [Google Developers Console][dev-console].
+2. Create a new project or click on an existing project.
+3. Navigate to  **APIs & auth** > **APIs section** and turn on the following APIs (you may need to enable billing in order to use these services):
+  * Google Compute Engine API
+4. Navigate to **APIs & auth** >  **Credentials** and then:
+  * If you want to use a new service account, click on **Create new Client ID** and select **Service account**. After the account is created, you will be prompted to download the JSON key file that the library uses to authenticate your requests.
+  * If you want to generate a new key for an existing service account, click on **Generate new JSON key** and download the JSON key file.
+
+``` js
+var projectId = process.env.GCLOUD_PROJECT; // E.g. 'grape-spaceship-123'
+
+var gce = require('@google-cloud/compute')({
+  projectId: projectId,
+
+  // The path to your key file:
+  keyFilename: '/path/to/keyfile.json'
+
+  // Or the contents of the key file:
+  credentials: require('./path/to/keyfile.json')
+});
+
+// ...you're good to go! See the next section to get started using the APIs.
+```
+
+
+[google-cloud]: https://github.com/GoogleCloudPlatform/gcloud-node
+[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
+[dev-console]: https://console.developers.google.com/project
+[gcloud-compute-docs]: https://googlecloudplatform.github.io/gcloud-node/#/docs/compute
+[cloud-compute-docs]: https://cloud.google.com/compute/docs

packages/datastore/README.md

@@ -0,0 +1,108 @@
+# @google-cloud/datastore
+> Google Cloud Datastore Client Library for Node.js
+
+*Looking for more Google APIs than just Datastore? You might want to check out [`google-cloud`][google-cloud].*
+
+- [API Documentation][gcloud-datastore-docs]
+- [Official Documentation][cloud-datastore-docs]
+
+*Follow the [activation instructions][cloud-datastore-activation] to use the Google Cloud Datastore API with your project.*
+
+```sh
+$ npm install --save @google-cloud/datastore
+```
+```js
+var datastore = require('@google-cloud/datastore')({
+  projectId: 'grape-spaceship-123',
+  keyFilename: '/path/to/keyfile.json'
+});
+
+var key = datastore.key(['Product', 'Computer']);
+
+datastore.get(key, function(err, entity) {
+  console.log(err || entity);
+});
+
+// Save data to Datastore.
+var blogPostData = {
+  title: 'How to make the perfect homemade pasta',
+  author: 'Andrew Chilton',
+  isDraft: true
+};
+
+var blogPostKey = datastore.key('BlogPost');
+
+datastore.save({
+  key: blogPostKey,
+  data: blogPostData
+}, function(err) {
+  // `blogPostKey` has been updated with an ID so you can do more operations
+  // with it, such as an update.
+  blogPostData.isDraft = false;
+
+  datastore.save({
+    key: blogPostKey,
+    data: blogPostData
+  }, function(err) {
+    if (!err) {
+      // The blog post is now published!
+    }
+  });
+});
+```
+
+
+## Authentication
+
+It's incredibly easy to get authenticated and start using Google's APIs. You can set your credentials on a global basis as well as on a per-API basis. See each individual API section below to see how you can auth on a per-API-basis. This is useful if you want to use different accounts for different Google Cloud services.
+
+### On Google Compute Engine
+
+If you are running this client on Google Compute Engine, we handle authentication for you with no configuration. You just need to make sure that when you [set up the GCE instance][gce-how-to], you add the correct scopes for the APIs you want to access.
+
+``` js
+// Authenticating on a global basis.
+var projectId = process.env.GCLOUD_PROJECT; // E.g. 'grape-spaceship-123'
+
+var datastore = require('@google-cloud/datastore')({
+  projectId: projectId
+});
+
+// ...you're good to go! See the next section to get started using the API.
+```
+
+### Elsewhere
+
+If you are not running this client on Google Compute Engine, you need a Google Developers service account. To create a service account:
+
+1. Visit the [Google Developers Console][dev-console].
+2. Create a new project or click on an existing project.
+3. Navigate to  **APIs & auth** > **APIs section** and turn on the following APIs (you may need to enable billing in order to use these services):
+  * Google Cloud Datastore API
+4. Navigate to **APIs & auth** >  **Credentials** and then:
+  * If you want to use a new service account, click on **Create new Client ID** and select **Service account**. After the account is created, you will be prompted to download the JSON key file that the library uses to authenticate your requests.
+  * If you want to generate a new key for an existing service account, click on **Generate new JSON key** and download the JSON key file.
+
+``` js
+var projectId = process.env.GCLOUD_PROJECT; // E.g. 'grape-spaceship-123'
+
+var datastore = require('@google-cloud/datastore')({
+  projectId: projectId,
+
+  // The path to your key file:
+  keyFilename: '/path/to/keyfile.json'
+
+  // Or the contents of the key file:
+  credentials: require('./path/to/keyfile.json')
+});
+
+// ...you're good to go! See the next section to get started using the APIs.
+```
+
+
+[google-cloud]: https://github.com/GoogleCloudPlatform/gcloud-node
+[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
+[dev-console]: https://console.developers.google.com/project
+[gcloud-datastore-docs]: https://googlecloudplatform.github.io/gcloud-node/#/docs/datastore
+[cloud-datastore-docs]: https://cloud.google.com/datastore/docs
+[cloud-datastore-activation]: https://cloud.google.com/datastore/docs/activate