Api roll 8: 2014-12-15

generated/googleapis/lib/books/v1.dart

 library googleapis.books.v1;
 
 import "dart:core" as core;
 import "dart:collection" as collection;
 import "dart:async" as async;
 import "dart:convert" as convert;
 
 import "package:crypto/crypto.dart" as crypto;
 import 'package:http/http.dart' as http;
 import '../src/common_internal.dart' as common_internal;
 import '../common/common.dart' as common_1;
 
 export '../common/common.dart' show ApiRequestError;
 export '../common/common.dart' show DetailedApiRequestError;
 
 /** Lets you search for books and manage your Google Books library. */
 class BooksApi {
   /** Manage your books */
   static const BooksScope = "https://www.googleapis.com/auth/books";
 
 
   final common_internal.ApiRequester _requester;
 
   BookshelvesResourceApi get bookshelves => new BookshelvesResourceApi(_requester);
   CloudloadingResourceApi get cloudloading => new CloudloadingResourceApi(_requester);
   DictionaryResourceApi get dictionary => new DictionaryResourceApi(_requester);
   LayersResourceApi get layers => new LayersResourceApi(_requester);
   MyconfigResourceApi get myconfig => new MyconfigResourceApi(_requester);
   MylibraryResourceApi get mylibrary => new MylibraryResourceApi(_requester);
+  OnboardingResourceApi get onboarding => new OnboardingResourceApi(_requester);
   PromoofferResourceApi get promooffer => new PromoofferResourceApi(_requester);
   VolumesResourceApi get volumes => new VolumesResourceApi(_requester);
 
-  BooksApi(http.Client client) : 
-      _requester = new common_internal.ApiRequester(client, "https://www.googleapis.com/", "books/v1/");
+  BooksApi(http.Client client, {core.String rootUrl: "https://www.googleapis.com/", core.String servicePath: "books/v1/"}) :
+      _requester = new common_internal.ApiRequester(client, rootUrl, servicePath);
 }
 
 
 /** Not documented yet. */
 class BookshelvesResourceApi {
   final common_internal.ApiRequester _requester;
 
   BookshelvesVolumesResourceApi get volumes => new BookshelvesVolumesResourceApi(_requester);
 
   BookshelvesResourceApi(common_internal.ApiRequester client) : 
@@ skipping 898 matching lines @@
 
 
 /** Not documented yet. */
 class MyconfigResourceApi {
   final common_internal.ApiRequester _requester;
 
   MyconfigResourceApi(common_internal.ApiRequester client) : 
       _requester = client;
 
   /**
+   * Gets the current settings for the user.
+   *
+   * Request parameters:
+   *
+   * Completes with a [Usersettings].
+   *
+   * Completes with a [common_1.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * If the used [http.Client] completes with an error when making a REST call,
+   * this method  will complete with the same error.
+   */
+  async.Future<Usersettings> getUserSettings() {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = common_1.DownloadOptions.Metadata;
+    var _body = null;
+
+
+
+    _url = 'myconfig/getUserSettings';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Usersettings.fromJson(data));
+  }
+
+  /**
    * Release downloaded content access restriction.
    *
    * Request parameters:
    *
    * [volumeIds] - The volume(s) to release restrictions for.
    *
    * [cpksver] - The device/version ID from which to release the restriction.
    *
    * [locale] - ISO-639-1, ISO-3166-1 codes for message localization, i.e.
    * en_US.
@@ skipping 187 matching lines @@
     var _response = _requester.request(_url,
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Volumes.fromJson(data));
   }
 
+  /**
+   * Sets the settings for the user. Unspecified sub-objects will retain the
+   * existing value.
+   *
+   * [request] - The metadata request object.
+   *
+   * Request parameters:
+   *
+   * Completes with a [Usersettings].
+   *
+   * Completes with a [common_1.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * If the used [http.Client] completes with an error when making a REST call,
+   * this method  will complete with the same error.
+   */
+  async.Future<Usersettings> updateUserSettings(Usersettings request) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = common_1.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (request != null) {
+      _body = convert.JSON.encode((request).toJson());
+    }
+
+
+    _url = 'myconfig/updateUserSettings';
+
+    var _response = _requester.request(_url,
+                                       "POST",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Usersettings.fromJson(data));
+  }
+
 }
 
 
 /** Not documented yet. */
 class MylibraryResourceApi {
   final common_internal.ApiRequester _requester;
 
   MylibraryAnnotationsResourceApi get annotations => new MylibraryAnnotationsResourceApi(_requester);
   MylibraryBookshelvesResourceApi get bookshelves => new MylibraryBookshelvesResourceApi(_requester);
   MylibraryReadingpositionsResourceApi get readingpositions => new MylibraryReadingpositionsResourceApi(_requester);
@@ skipping 872 matching lines @@
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
 }
 
 
 /** Not documented yet. */
+class OnboardingResourceApi {
+  final common_internal.ApiRequester _requester;
+
+  OnboardingResourceApi(common_internal.ApiRequester client) : 
+      _requester = client;
+
+  /**
+   * List categories for onboarding experience.
+   *
+   * Request parameters:
+   *
+   * [locale] - ISO-639-1 language and ISO-3166-1 country code. Default is en-US
+   * if unset.
+   *
+   * Completes with a [Category].
+   *
+   * Completes with a [common_1.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * If the used [http.Client] completes with an error when making a REST call,
+   * this method  will complete with the same error.
+   */
+  async.Future<Category> listCategories({core.String locale}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = common_1.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (locale != null) {
+      _queryParams["locale"] = [locale];
+    }
+
+
+    _url = 'onboarding/listCategories';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Category.fromJson(data));
+  }
+
+  /**
+   * List available volumes under categories for onboarding experience.
+   *
+   * Request parameters:
+   *
+   * [categoryId] - List of category ids requested.
+   *
+   * [locale] - ISO-639-1 language and ISO-3166-1 country code. Default is en-US
+   * if unset.
+   *
+   * [pageSize] - Number of maximum results per page to be included in the
+   * response.
+   *
+   * [pageToken] - The value of the nextToken from the previous page.
+   *
+   * Completes with a [Volume2].
+   *
+   * Completes with a [common_1.ApiRequestError] if the API endpoint returned an
+   * error.
+   *
+   * If the used [http.Client] completes with an error when making a REST call,
+   * this method  will complete with the same error.
+   */
+  async.Future<Volume2> listCategoryVolumes({core.List<core.String> categoryId, core.String locale, core.int pageSize, core.String pageToken}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = common_1.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (categoryId != null) {
+      _queryParams["categoryId"] = categoryId;
+    }
+    if (locale != null) {
+      _queryParams["locale"] = [locale];
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+
+
+    _url = 'onboarding/listCategoryVolumes';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Volume2.fromJson(data));
+  }
+
+}
+
+
+/** Not documented yet. */
 class PromoofferResourceApi {
   final common_internal.ApiRequester _requester;
 
   PromoofferResourceApi(common_internal.ApiRequester client) : 
       _requester = client;
 
   /**
    * Not documented yet.
    *
    * Request parameters:
@@ skipping 1678 matching lines @@
     }
     if (kind != null) {
       _json["kind"] = kind;
     }
     return _json;
   }
 }
 
 
 /** Not documented yet. */
+class CategoryItems {
+  /** Not documented yet. */
+  core.String badgeUrl;
+
+  /** Not documented yet. */
+  core.String categoryId;
+
+  /** Not documented yet. */
+  core.String name;
+
+
+  CategoryItems();
+
+  CategoryItems.fromJson(core.Map _json) {
+    if (_json.containsKey("badgeUrl")) {
+      badgeUrl = _json["badgeUrl"];
+    }
+    if (_json.containsKey("categoryId")) {
+      categoryId = _json["categoryId"];
+    }
+    if (_json.containsKey("name")) {
+      name = _json["name"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (badgeUrl != null) {
+      _json["badgeUrl"] = badgeUrl;
+    }
+    if (categoryId != null) {
+      _json["categoryId"] = categoryId;
+    }
+    if (name != null) {
+      _json["name"] = name;
+    }
+    return _json;
+  }
+}
+
+
+/** Not documented yet. */
+class Category {
+  /** A list of onboarding categories. */
+  core.List<CategoryItems> items;
+
+  /** Resource type. */
+  core.String kind;
+
+
+  Category();
+
+  Category.fromJson(core.Map _json) {
+    if (_json.containsKey("items")) {
+      items = _json["items"].map((value) => new CategoryItems.fromJson(value)).toList();
+    }
+    if (_json.containsKey("kind")) {
+      kind = _json["kind"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (items != null) {
+      _json["items"] = items.map((value) => (value).toJson()).toList();
+    }
+    if (kind != null) {
+      _json["kind"] = kind;
+    }
+    return _json;
+  }
+}
+
+
+/** Not documented yet. */
 class ConcurrentAccessRestriction {
   /** Whether access is granted for this (user, device, volume). */
   core.bool deviceAllowed;
 
   /** Resource type. */
   core.String kind;
 
   /** The maximum number of concurrent access licenses for this volume. */
   core.int maxConcurrentDevices;
 
@@ skipping 2013 matching lines @@
       _json["type"] = type;
     }
     if (volumeId != null) {
       _json["volumeId"] = volumeId;
     }
     return _json;
   }
 }
 
 
+/** User settings in sub-objects, each for different purposes. */
+class UsersettingsNotesExport {
+  /** Not documented yet. */
+  core.String folderName;
+
+  /** Not documented yet. */
+  core.bool isEnabled;
+
+
+  UsersettingsNotesExport();
+
+  UsersettingsNotesExport.fromJson(core.Map _json) {
+    if (_json.containsKey("folderName")) {
+      folderName = _json["folderName"];
+    }
+    if (_json.containsKey("isEnabled")) {
+      isEnabled = _json["isEnabled"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (folderName != null) {
+      _json["folderName"] = folderName;
+    }
+    if (isEnabled != null) {
+      _json["isEnabled"] = isEnabled;
+    }
+    return _json;
+  }
+}
+
+
+/** Not documented yet. */
+class Usersettings {
+  /** Resource type. */
+  core.String kind;
+
+  /** User settings in sub-objects, each for different purposes. */
+  UsersettingsNotesExport notesExport;
+
+
+  Usersettings();
+
+  Usersettings.fromJson(core.Map _json) {
+    if (_json.containsKey("kind")) {
+      kind = _json["kind"];
+    }
+    if (_json.containsKey("notesExport")) {
+      notesExport = new UsersettingsNotesExport.fromJson(_json["notesExport"]);
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (kind != null) {
+      _json["kind"] = kind;
+    }
+    if (notesExport != null) {
+      _json["notesExport"] = (notesExport).toJson();
+    }
+    return _json;
+  }
+}
+
+
 /** Information about epub content. (In LITE projection.) */
 class VolumeAccessInfoEpub {
   /** URL to retrieve ACS token for epub download. (In LITE projection.) */
   core.String acsTokenLink;
 
   /** URL to download epub. (In LITE projection.) */
   core.String downloadLink;
 
   /**
    * Is a flowing text epub available either as public domain or for purchase.
@@ skipping 1455 matching lines @@
       _json["userInfo"] = (userInfo).toJson();
     }
     if (volumeInfo != null) {
       _json["volumeInfo"] = (volumeInfo).toJson();
     }
     return _json;
   }
 }
 
 
+/** Not documented yet. */
+class Volume2 {
+  /** A list of volumes. */
+  core.List<Volume> items;
+
+  /** Resource type. */
+  core.String kind;
+
+  /** Not documented yet. */
+  core.String nextPageToken;
+
+
+  Volume2();
+
+  Volume2.fromJson(core.Map _json) {
+    if (_json.containsKey("items")) {
+      items = _json["items"].map((value) => new Volume.fromJson(value)).toList();
+    }
+    if (_json.containsKey("kind")) {
+      kind = _json["kind"];
+    }
+    if (_json.containsKey("nextPageToken")) {
+      nextPageToken = _json["nextPageToken"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (items != null) {
+      _json["items"] = items.map((value) => (value).toJson()).toList();
+    }
+    if (kind != null) {
+      _json["kind"] = kind;
+    }
+    if (nextPageToken != null) {
+      _json["nextPageToken"] = nextPageToken;
+    }
+    return _json;
+  }
+}
+
+
 /** The content ranges to identify the selected text. */
 class VolumeannotationContentRanges {
   /** Range in CFI format for this annotation for version above. */
   BooksAnnotationsRange cfiRange;
 
   /** Content version applicable to ranges below. */
   core.String contentVersion;
 
   /** Range in GB image format for this annotation for version above. */
   BooksAnnotationsRange gbImageRange;
@@ skipping 288 matching lines @@
       _json["kind"] = kind;
     }
     if (totalItems != null) {
       _json["totalItems"] = totalItems;
     }
     return _json;
   }
 }