Api-roll 47: 2017-03-27

generated/googleapis/lib/slides/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.slides.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 232 matching lines @@
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Page.fromJson(data));
   }
 
+  /**
+   * Generates a thumbnail of the latest version of the specified page in the
+   * presentation and returns a URL to the thumbnail image.
+   *
+   * Request parameters:
+   *
+   * [presentationId] - The ID of the presentation to retrieve.
+   *
+   * [pageObjectId] - The object ID of the page whose thumbnail to retrieve.
+   *
+   * [thumbnailProperties_mimeType] - The optional mime type of the thumbnail
+   * image.
+   *
+   * If you don't specify the mime type, the default mime type will be PNG.
+   * Possible string values are:
+   * - "PNG" : A PNG.
+   *
+   * [thumbnailProperties_thumbnailSize] - The optional thumbnail image size.
+   *
+   * If you don't specify the size, the server chooses a default size of the
+   * image.
+   * Possible string values are:
+   * - "THUMBNAIL_SIZE_UNSPECIFIED" : A THUMBNAIL_SIZE_UNSPECIFIED.
+   * - "LARGE" : A LARGE.
+   *
+   * Completes with a [Thumbnail].
+   *
+   * Completes with a [commons.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<Thumbnail> getThumbnail(core.String presentationId, core.String pageObjectId, {core.String thumbnailProperties_mimeType, core.String thumbnailProperties_thumbnailSize}) {
+    var _url = null;
+    var _queryParams = new core.Map();
+    var _uploadMedia = null;
+    var _uploadOptions = null;
+    var _downloadOptions = commons.DownloadOptions.Metadata;
+    var _body = null;
+
+    if (presentationId == null) {
+      throw new core.ArgumentError("Parameter presentationId is required.");
+    }
+    if (pageObjectId == null) {
+      throw new core.ArgumentError("Parameter pageObjectId is required.");
+    }
+    if (thumbnailProperties_mimeType != null) {
+      _queryParams["thumbnailProperties.mimeType"] = [thumbnailProperties_mimeType];
+    }
+    if (thumbnailProperties_thumbnailSize != null) {
+      _queryParams["thumbnailProperties.thumbnailSize"] = [thumbnailProperties_thumbnailSize];
+    }
+
+    _url = 'v1/presentations/' + commons.Escaper.ecapeVariable('$presentationId') + '/pages/' + commons.Escaper.ecapeVariable('$pageObjectId') + '/thumbnail';
+
+    var _response = _requester.request(_url,
+                                       "GET",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Thumbnail.fromJson(data));
+  }
+
 }
 
 
 
 /**
  * AffineTransform uses a 3x3 matrix with an implied last row of [ 0 0 1 ]
  * to transform source coordinates (x,y) into destination coordinates (x', y')
  * according to:
  *
  *       x'  x  =   shear_y  scale_y  translate_y
@@ skipping 124 matching lines @@
       _json["type"] = type;
     }
     return _json;
   }
 }
 
 /** Request message for PresentationsService.BatchUpdatePresentation. */
 class BatchUpdatePresentationRequest {
   /** A list of updates to apply to the presentation. */
   core.List<Request> requests;
+  /**
+   * Provides control over how write requests are executed, such as
+   * conditionally updating the presentation.
+   */
+  WriteControl writeControl;
 
   BatchUpdatePresentationRequest();
 
   BatchUpdatePresentationRequest.fromJson(core.Map _json) {
     if (_json.containsKey("requests")) {
       requests = _json["requests"].map((value) => new Request.fromJson(value)).toList();
     }
+    if (_json.containsKey("writeControl")) {
+      writeControl = new WriteControl.fromJson(_json["writeControl"]);
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (requests != null) {
       _json["requests"] = requests.map((value) => (value).toJson()).toList();
     }
+    if (writeControl != null) {
+      _json["writeControl"] = (writeControl).toJson();
+    }
     return _json;
   }
 }
 
 /** Response message from a batch update. */
 class BatchUpdatePresentationResponse {
   /** The presentation the updates were applied to. */
   core.String presentationId;
   /**
    * The reply of the updates.  This maps 1:1 with the updates, although
@@ skipping 2704 matching lines @@
   /**
    * The type of the page.
    * Possible string values are:
    * - "SLIDE" : A slide page.
    * - "MASTER" : A master slide page.
    * - "LAYOUT" : A layout page.
    * - "NOTES" : A notes page.
    * - "NOTES_MASTER" : A notes master page.
    */
   core.String pageType;
+  /**
+   * The revision ID of the presentation containing this page. Can be used in
+   * update requests to assert that the presentation revision hasn't changed
+   * since the last read operation. Only populated if the user has edit access
+   * to the presentation.
+   *
+   * The format of the revision ID may change over time, so it should be treated
+   * opaquely. A returned revision ID is only guaranteed to be valid for 24
+   * hours after it has been returned and cannot be shared across
+   * users. Callers can assume that if two revision IDs are equal then the
+   * presentation has not changed.
+   */
+  core.String revisionId;
   /** Slide specific properties. Only set if page_type = SLIDE. */
   SlideProperties slideProperties;
 
   Page();
 
   Page.fromJson(core.Map _json) {
     if (_json.containsKey("layoutProperties")) {
       layoutProperties = new LayoutProperties.fromJson(_json["layoutProperties"]);
     }
     if (_json.containsKey("notesProperties")) {
       notesProperties = new NotesProperties.fromJson(_json["notesProperties"]);
     }
     if (_json.containsKey("objectId")) {
       objectId = _json["objectId"];
     }
     if (_json.containsKey("pageElements")) {
       pageElements = _json["pageElements"].map((value) => new PageElement.fromJson(value)).toList();
     }
     if (_json.containsKey("pageProperties")) {
       pageProperties = new PageProperties.fromJson(_json["pageProperties"]);
     }
     if (_json.containsKey("pageType")) {
       pageType = _json["pageType"];
     }
+    if (_json.containsKey("revisionId")) {
+      revisionId = _json["revisionId"];
+    }
     if (_json.containsKey("slideProperties")) {
       slideProperties = new SlideProperties.fromJson(_json["slideProperties"]);
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (layoutProperties != null) {
       _json["layoutProperties"] = (layoutProperties).toJson();
     }
     if (notesProperties != null) {
       _json["notesProperties"] = (notesProperties).toJson();
     }
     if (objectId != null) {
       _json["objectId"] = objectId;
     }
     if (pageElements != null) {
       _json["pageElements"] = pageElements.map((value) => (value).toJson()).toList();
     }
     if (pageProperties != null) {
       _json["pageProperties"] = (pageProperties).toJson();
     }
     if (pageType != null) {
       _json["pageType"] = pageType;
     }
+    if (revisionId != null) {
+      _json["revisionId"] = revisionId;
+    }
     if (slideProperties != null) {
       _json["slideProperties"] = (slideProperties).toJson();
     }
     return _json;
   }
 }
 
 /** The page background fill. */
 class PageBackgroundFill {
   /**
@@ skipping 549 matching lines @@
    *   its layouts.
    * - Any other shapes on the master slide will appear on all slides using that
    *   master, regardless of their layout.
    */
   core.List<Page> masters;
   /**
    * The notes master in the presentation. It serves three purposes:
    *
    * - Placeholder shapes on a notes master contain the default text styles and
    *   shape properties of all placeholder shapes on notes pages. Specifically,
-   *   a SLIDE_IMAGE placeholder shape is defined to contain the slide
-   * thumbnail, and a BODY placeholder shape is defined to contain the speaker
-   *   notes.
+   *   a `SLIDE_IMAGE` placeholder shape contains the slide thumbnail, and a
+   *   `BODY` placeholder shape contains the speaker notes.
    * - The notes master page properties define the common page properties
    *   inherited by all notes pages.
    * - Any other shapes on the notes master will appear on all notes pages.
    *
    * The notes master is read-only.
    */
   Page notesMaster;
   /** The size of pages in the presentation. */
   Size pageSize;
   /** The ID of the presentation. */
   core.String presentationId;
   /**
+   * The revision ID of the presentation. Can be used in update requests
+   * to assert that the presentation revision hasn't changed since the last
+   * read operation. Only populated if the user has edit access to the
+   * presentation.
+   *
+   * The format of the revision ID may change over time, so it should be treated
+   * opaquely. A returned revision ID is only guaranteed to be valid for 24
+   * hours after it has been returned and cannot be shared across users. Callers
+   * can assume that if two revision IDs are equal then the presentation has not
+   * changed.
+   */
+  core.String revisionId;
+  /**
    * The slides in the presentation.
    * A slide inherits properties from a slide layout.
    */
   core.List<Page> slides;
   /** The title of the presentation. */
   core.String title;
 
   Presentation();
 
   Presentation.fromJson(core.Map _json) {
     if (_json.containsKey("layouts")) {
       layouts = _json["layouts"].map((value) => new Page.fromJson(value)).toList();
     }
     if (_json.containsKey("locale")) {
       locale = _json["locale"];
     }
     if (_json.containsKey("masters")) {
       masters = _json["masters"].map((value) => new Page.fromJson(value)).toList();
     }
     if (_json.containsKey("notesMaster")) {
       notesMaster = new Page.fromJson(_json["notesMaster"]);
     }
     if (_json.containsKey("pageSize")) {
       pageSize = new Size.fromJson(_json["pageSize"]);
     }
     if (_json.containsKey("presentationId")) {
       presentationId = _json["presentationId"];
     }
+    if (_json.containsKey("revisionId")) {
+      revisionId = _json["revisionId"];
+    }
     if (_json.containsKey("slides")) {
       slides = _json["slides"].map((value) => new Page.fromJson(value)).toList();
     }
     if (_json.containsKey("title")) {
       title = _json["title"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (layouts != null) {
       _json["layouts"] = layouts.map((value) => (value).toJson()).toList();
     }
     if (locale != null) {
       _json["locale"] = locale;
     }
     if (masters != null) {
       _json["masters"] = masters.map((value) => (value).toJson()).toList();
     }
     if (notesMaster != null) {
       _json["notesMaster"] = (notesMaster).toJson();
     }
     if (pageSize != null) {
       _json["pageSize"] = (pageSize).toJson();
     }
     if (presentationId != null) {
       _json["presentationId"] = presentationId;
     }
+    if (revisionId != null) {
+      _json["revisionId"] = revisionId;
+    }
     if (slides != null) {
       _json["slides"] = slides.map((value) => (value).toJson()).toList();
     }
     if (title != null) {
       _json["title"] = title;
     }
     return _json;
   }
 }
 
@@ skipping 2321 matching lines @@
    *   text is another link) unless different styles are being set in the same
    *   request.
    */
   Link link;
   /** Whether or not the text is in small capital letters. */
   core.bool smallCaps;
   /** Whether or not the text is struck through. */
   core.bool strikethrough;
   /** Whether or not the text is underlined. */
   core.bool underline;
+  /**
+   * The font family and rendered weight of the text. This property is
+   * read-only.
+   *
+   * This field is an extension of `font_family` meant to support explicit font
+   * weights without breaking backwards compatibility. As such, when reading the
+   * style of a range of text, the value of `weighted_font_family.font_family`
+   * will always be equal to that of `font_family`.
+   */
+  WeightedFontFamily weightedFontFamily;
 
   TextStyle();
 
   TextStyle.fromJson(core.Map _json) {
     if (_json.containsKey("backgroundColor")) {
       backgroundColor = new OptionalColor.fromJson(_json["backgroundColor"]);
     }
     if (_json.containsKey("baselineOffset")) {
       baselineOffset = _json["baselineOffset"];
     }
@@ skipping 17 matching lines @@
     }
     if (_json.containsKey("smallCaps")) {
       smallCaps = _json["smallCaps"];
     }
     if (_json.containsKey("strikethrough")) {
       strikethrough = _json["strikethrough"];
     }
     if (_json.containsKey("underline")) {
       underline = _json["underline"];
     }
+    if (_json.containsKey("weightedFontFamily")) {
+      weightedFontFamily = new WeightedFontFamily.fromJson(_json["weightedFontFamily"]);
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (backgroundColor != null) {
       _json["backgroundColor"] = (backgroundColor).toJson();
     }
     if (baselineOffset != null) {
       _json["baselineOffset"] = baselineOffset;
     }
@@ skipping 17 matching lines @@
     }
     if (smallCaps != null) {
       _json["smallCaps"] = smallCaps;
     }
     if (strikethrough != null) {
       _json["strikethrough"] = strikethrough;
     }
     if (underline != null) {
       _json["underline"] = underline;
     }
+    if (weightedFontFamily != null) {
+      _json["weightedFontFamily"] = (weightedFontFamily).toJson();
+    }
     return _json;
   }
 }
 
 /** A pair mapping a theme color type to the concrete color it represents. */
 class ThemeColorPair {
   /** The concrete color corresponding to the theme color type above. */
   RgbColor color;
   /**
    * The type of the theme color.
@@ skipping 36 matching lines @@
     if (color != null) {
       _json["color"] = (color).toJson();
     }
     if (type != null) {
       _json["type"] = type;
     }
     return _json;
   }
 }
 
+/** The thumbnail of a page. */
+class Thumbnail {
+  /**
+   * The content URL of the thumbnail image.
+   *
+   * The URL to the image has a default lifetime of 30 minutes.
+   * This URL is tagged with the account of the requester. Anyone with the URL
+   * effectively accesses the image as the original requester. Access to the
+   * image may be lost if the presentation's sharing settings change.
+   * The mime type of the thumbnail image is the same as specified in the
+   * `GetPageThumbnailRequest`.
+   */
+  core.String contentUrl;
+  /** The positive height in pixels of the thumbnail image. */
+  core.int height;
+  /** The positive width in pixels of the thumbnail image. */
+  core.int width;
+
+  Thumbnail();
+
+  Thumbnail.fromJson(core.Map _json) {
+    if (_json.containsKey("contentUrl")) {
+      contentUrl = _json["contentUrl"];
+    }
+    if (_json.containsKey("height")) {
+      height = _json["height"];
+    }
+    if (_json.containsKey("width")) {
+      width = _json["width"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (contentUrl != null) {
+      _json["contentUrl"] = contentUrl;
+    }
+    if (height != null) {
+      _json["height"] = height;
+    }
+    if (width != null) {
+      _json["width"] = width;
+    }
+    return _json;
+  }
+}
+
 /** Update the properties of an Image. */
 class UpdateImagePropertiesRequest {
   /**
    * The fields that should be updated.
    *
    * At least one field must be specified. The root `imageProperties` is
    * implied and should not be specified. A single `"*"` can be used as
    * short-hand for listing every field.
    *
    * For example to update the image outline color, set `fields` to
@@ skipping 184 matching lines @@
   }
 }
 
 /**
  * Updates the styling for all of the paragraphs within a Shape or Table that
  * overlap with the given text index range.
  */
 class UpdateParagraphStyleRequest {
   /**
    * The location of the cell in the table containing the paragraph(s) to
-   * style. If object_id refers to a table, cell_location must have a value.
+   * style. If `object_id` refers to a table, `cell_location` must have a value.
    * Otherwise, it must not.
    */
   TableCellLocation cellLocation;
   /**
    * The fields that should be updated.
    *
    * At least one field must be specified. The root `style` is implied and
    * should not be specified. A single `"*"` can be used as short-hand for
    * listing every field.
    *
@@ skipping 202 matching lines @@
   }
 }
 
 /**
  * Update the styling of text in a Shape or
  * Table.
  */
 class UpdateTextStyleRequest {
   /**
    * The location of the cell in the table containing the text to style. If
-   * object_id refers to a table, cell_location must have a value. Otherwise, it
-   * must not.
+   * `object_id` refers to a table, `cell_location` must have a value.
+   * Otherwise, it must not.
    */
   TableCellLocation cellLocation;
   /**
    * The fields that should be updated.
    *
    * At least one field must be specified. The root `style` is implied and
    * should not be specified. A single `"*"` can be used as short-hand for
    * listing every field.
    *
    * For example, to update the text style to bold, set `fields` to `"bold"`.
@@ skipping 191 matching lines @@
 
   core.Map toJson() {
     var _json = new core.Map();
     if (outline != null) {
       _json["outline"] = (outline).toJson();
     }
     return _json;
   }
 }
 
+/** Represents a font family and weight used to style a TextRun. */
+class WeightedFontFamily {
+  /**
+   * The font family of the text.
+   *
+   * The font family can be any font from the Font menu in Slides or from
+   * [Google Fonts] (https://fonts.google.com/). If the font name is
+   * unrecognized, the text is rendered in `Arial`.
+   */
+  core.String fontFamily;
+  /**
+   * The rendered weight of the text. This field can have any value that is a
+   * multiple of 100 between 100 and 900, inclusive. This range corresponds to
+   * only the numerical values described in the "Cascading Style Sheets Level
+   * 2 Revision 1 (CSS 2.1) Specification",
+   * [section 15.6](https://www.w3.org/TR/CSS21/fonts.html#font-boldness). The
+   * non-numerical values in the specification are disallowed. Weights greater
+   * than or equal to 700 are considered bold, and weights less than 700 are
+   * not bold. The default value is `400` ("normal").
+   */
+  core.int weight;
+
+  WeightedFontFamily();
+
+  WeightedFontFamily.fromJson(core.Map _json) {
+    if (_json.containsKey("fontFamily")) {
+      fontFamily = _json["fontFamily"];
+    }
+    if (_json.containsKey("weight")) {
+      weight = _json["weight"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (fontFamily != null) {
+      _json["fontFamily"] = fontFamily;
+    }
+    if (weight != null) {
+      _json["weight"] = weight;
+    }
+    return _json;
+  }
+}
+
 /**
  * A PageElement kind representing
  * word art.
  */
 class WordArt {
   /** The text rendered as word art. */
   core.String renderedText;
 
   WordArt();
 
   WordArt.fromJson(core.Map _json) {
     if (_json.containsKey("renderedText")) {
       renderedText = _json["renderedText"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (renderedText != null) {
       _json["renderedText"] = renderedText;
     }
     return _json;
   }
 }
+
+/** Provides control over how write requests are executed. */
+class WriteControl {
+  /**
+   * The revision ID of the presentation required for the write request. If
+   * specified and the `required_revision_id` doesn't exactly match the
+   * presentation's current `revision_id`, the request will not be processed and
+   * will return a 400 bad request error.
+   */
+  core.String requiredRevisionId;
+
+  WriteControl();
+
+  WriteControl.fromJson(core.Map _json) {
+    if (_json.containsKey("requiredRevisionId")) {
+      requiredRevisionId = _json["requiredRevisionId"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (requiredRevisionId != null) {
+      _json["requiredRevisionId"] = requiredRevisionId;
+    }
+    return _json;
+  }
+}