Api-roll 45: 2017-02-13

generated/googleapis_beta/lib/toolresults/v1beta3.dart

Index: generated/googleapis_beta/lib/toolresults/v1beta3.dart
diff --git a/generated/googleapis_beta/lib/toolresults/v1beta3.dart b/generated/googleapis_beta/lib/toolresults/v1beta3.dart
index efa06f84f4b04f03e912086b339e46804c7b0b49..fe4d99d8d02aeffde5111239d750ee7e725ca717 100644
--- a/generated/googleapis_beta/lib/toolresults/v1beta3.dart
+++ b/generated/googleapis_beta/lib/toolresults/v1beta3.dart
@@ -3808,6 +3808,8 @@ class Thumbnail {
  * strings. See
  * [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.txt).
  *
+ * # Examples
+ *
  * Example 1: Compute Timestamp from POSIX `time()`.
  *
  * Timestamp timestamp; timestamp.set_seconds(time(NULL));
@@ -3842,6 +3844,31 @@ class Thumbnail {
  * Example 5: Compute Timestamp from current time in Python.
  *
  * timestamp = Timestamp() timestamp.GetCurrentTime()
+ *
+ * # JSON Mapping
+ *
+ * In JSON format, the Timestamp type is encoded as a string in the [RFC
+ * 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the format is
+ * "{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z" where {year} is
+ * always expressed using four digits while {month}, {day}, {hour}, {min}, and
+ * {sec} are zero-padded to two digits each. The fractional seconds, which can
+ * go up to 9 digits (i.e. up to 1 nanosecond resolution), are optional. The "Z"
+ * suffix indicates the timezone ("UTC"); the timezone is required, though only
+ * UTC (as indicated by "Z") is presently supported.
+ *
+ * For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past 01:30 UTC
+ * on January 15, 2017.
+ *
+ * In JavaScript, one can convert a Date object to this format using the
+ * standard
+ * [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString]
+ * method. In Python, a standard `datetime.datetime` object can be converted to
+ * this format using
+ * [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
+ * the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+ * the Joda Time's [`ISODateTimeFormat.dateTime()`](
+ * http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime())
+ * to obtain a formatter capable of generating timestamps in this format.
  */
 class Timestamp {
   /**