Api roll 6: 2014-11-17

generated/googleapis_beta/README.md

-# Package of Google APIs
+Auto-generated Dart libraries for accessing [Google APIs][libs].
 
-## Description
-
-This repository contains auto-generated client libraries for accessing 
-Google APIs using dart. It has the usual dart package layout.
-
 ## Usage
 
-The first step is to obtain oauth2 access credentials. This can be done using
-the `googleapis_auth` package. Your application can access APIs on behalf of a
+First, obtain OAuth 2.0 access credentials. This can be done using the
+`googleapis_auth` package. Your application can access APIs on behalf of a
 user or using a service account.
 
 After obtaining credentials, an API from the `googleapis` package can be
 accessed with an authenticated HTTP client.
 
-The following is an example of a command line application which lists files
-in Google Drive by using a service account. 
+## Example
+
+The following command line application lists files in Google Drive by using a
+service account.
 
 Create a `pubspec.yaml` file with the `googleapis_auth` and `googleapis`
 dependencies.
 
-    ...
-    dependencies:
-      googleapis: any
-      googleapis_auth: any
+```yaml
+...
+dependencies:
+  googleapis: any
+  googleapis_auth: any
+```
 
 Create a service account in the Google Cloud Console and save the credential
-information. After that the Cloud Storage API can be accessed like this:
+information.
 
-    import 'package:googleapis/storage/v1.dart';
-    import 'package:googleapis_auth/auth_io.dart';
+Then create a Dart application to list files in a spececific project. *In the
+example below, files from the `dart-on-cloud` project are listed.*
 
-    final Credentials = new ServiceAccountCredentials.fromJson(r'''
-    {
-      "private_key_id": ...,
-      "private_key": ...,
-      "client_email": ...,
-      "client_id": ...,
-      "type": "service_account"
-    }
-    ''');
+```dart
+// bin/list_files.dart
 
-    void main() {
-      clientViaServiceAccount(Credentials,
-                              [StorageApi.DevstorageReadOnlyScope]).then((http) {
-        var storage = new StorageApi(http);
-        storage.buckets.list('dart-on-cloud').then((buckets) {
-          print("Received ${buckets.items.length} bucket names:");
-          for (var file in buckets.items) {
-            print(file.name);
-          }
-        });
-      });
-    }
+import 'package:googleapis/storage/v1.dart';
+import 'package:googleapis_auth/auth_io.dart';
+
+final _credentials = new ServiceAccountCredentials.fromJson(r'''
+{
+  "private_key_id": ...,
+  "private_key": ...,
+  "client_email": ...,
+  "client_id": ...,
+  "type": "service_account"
+}
+''');
+
+const _SCOPES = const [StorageApi.DevstorageReadOnlyScope];
+
+void main() {
+  clientViaServiceAccount(_credentials, _SCOPES).then((http_client) {
+    var storage = new StorageApi(http_client);
+    storage.buckets.list('dart-on-cloud').then((buckets) {
+      print("Received ${buckets.items.length} bucket names:");
+      for (var file in buckets.items) {
+        print(file.name);
+      }
+    });
+  });
+}
+```
+
+[libs]: https://developers.google.com/discovery/libraries/
 
 ## Available Google APIs
 
 The following is a list of APIs that are currently available inside this
 package.
 
 #### ![Logo](http://www.google.com/images/icons/product/search-16.gif) Google Compute Engine Autoscaler API - autoscaler v1beta2
 
 The Google Compute Engine Autoscaler API provides autoscaling for groups of Cloud VMs.
 
@@ skipping 48 matching lines @@
 #### ![Logo](http://www.google.com/images/icons/product/search-16.gif) Google Compute Engine Instance Group Manager API - replicapool v1beta2
 
 The Google Compute Engine Instance Group Manager API provides groups of homogenous Compute Engine Instances.
 
 Official API documentation: https://developers.google.com/compute/docs/instance-groups/manager/v1beta2
 
 #### ![Logo](http://www.google.com/images/icons/product/search-16.gif) Google Compute Engine Instance Group Updater API - replicapoolupdater v1beta1
 
 The Google Compute Engine Instance Group Updater API provides services for updating groups of Compute Engine Instances.
 
-Official API documentation: 
+Official API documentation: https://developers.google.com/compute/docs/instance-groups/manager/v1beta2
 
 #### ![Logo](http://www.google.com/images/icons/product/search-16.gif) Resource Views API - resourceviews v1beta1
 
 The Resource View API allows users to create and manage logical sets of Google Compute Engine instances.
 
 Official API documentation: https://developers.google.com/compute/
 
 #### ![Logo](http://www.google.com/images/icons/product/search-16.gif) Resource Views API - resourceviews v1beta2
 
 The Resource View API allows users to create and manage logical sets of Google Compute Engine instances.
 
 Official API documentation: https://developers.google.com/compute/
 
 #### ![Logo](http://www.google.com/images/icons/product/search-16.gif) Cloud SQL Administration API - sqladmin v1beta3
 
 API for Cloud SQL database instance management.
 
 Official API documentation: https://developers.google.com/cloud-sql/docs/admin-api/
 
-#### ![Logo](http://www.google.com/images/icons/product/app_engine-16.png) TaskQueue API - taskqueue v1beta2
+#### ![Logo](https://www.google.com/images/icons/product/app_engine-16.png) TaskQueue API - taskqueue v1beta2
 
 Lets you access a Google App Engine Pull Task Queue over REST.
 
 Official API documentation: https://developers.google.com/appengine/docs/python/taskqueue/rest