Api-roll 21: 2015-08-04

generated/googleapis_beta/lib/pubsub/v1beta2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.pubsub.v1beta2;
 
 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:crypto/crypto.dart' as crypto;
@@ skipping 95 matching lines @@
    * subscription already exists, returns ALREADY_EXISTS. If the corresponding
    * topic doesn't exist, returns NOT_FOUND. If the name is not provided in the
    * request, the server will assign a random name for this subscription on the
    * same project as the topic.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [name] - The name of the subscription. It must have the format
-   * "projects/{project}/subscriptions/{subscription}" for Google Cloud Pub/Sub
-   * API v1 and v1beta2. {subscription} must start with a letter, and contain
-   * only letters ([A-Za-z]), numbers ([0-9], dashes (-), underscores (_),
-   * periods (.), tildes (~), plus (+) or percent signs (%). It must be between
-   * 3 and 255 characters in length, and it must not start with "goog".
+   * `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+   * start with a letter, and contain only letters (`[A-Za-z]`), numbers
+   * (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+   * plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+   * in length, and it must not start with `"goog"`.
    * Value must have pattern "^projects/[^/] * / subscriptions/[^/]*$".
    *
    * Completes with a [Subscription].
    *
    * 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.
    */
@@ skipping 454 matching lines @@
       _requester = client;
 
   /**
    * Creates the given topic with the given name.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [name] - The name of the topic. It must have the format
-   * "projects/{project}/topics/{topic}" for Google Cloud Pub/Sub API v1 and
-   * v1beta2. {topic} must start with a letter, and contain only letters
-   * ([A-Za-z]), numbers ([0-9], dashes (-), underscores (_), periods (.),
-   * tildes (~), plus (+) or percent signs (%). It must be between 3 and 255
-   * characters in length, and it must not start with "goog".
+   * `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+   * and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+   * underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs
+   * (`%`). It must be between 3 and 255 characters in length, and it must not
+   * start with `"goog"`.
    * Value must have pattern "^projects/[^/] * / topics/[^/]*$".
    *
    * Completes with a [Topic].
    *
    * 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.
    */
@@ skipping 197 matching lines @@
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListTopicsResponse.fromJson(data));
   }
 
   /**
    * Adds one or more messages to the topic. Returns NOT_FOUND if the topic does
-   * not exist.
+   * not exist. The message payload must not be empty; it must contain either a
+   * non-empty data field, or at least one attribute.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [topic] - The messages in the request will be published on this topic.
    * Value must have pattern "^projects/[^/] * / topics/[^/]*$".
    *
    * Completes with a [PublishResponse].
    *
@@ skipping 761 matching lines @@
 
   core.Map toJson() {
     var _json = new core.Map();
     if (messageIds != null) {
       _json["messageIds"] = messageIds;
     }
     return _json;
   }
 }
 
-/** A message data and its attributes. */
+/**
+ * A message data and its attributes. The message payload must not be empty; it
+ * must contain either a non-empty data field, or at least one attribute.
+ */
 class PubsubMessage {
   /** Optional attributes for this message. */
   core.Map<core.String, core.String> attributes;
   /**
    * The message payload. For JSON requests, the value of this field must be
    * base64-encoded.
    */
   core.String data;
   core.List<core.int> get dataAsBytes {
     return crypto.CryptoUtils.base64StringToBytes(data);
@@ skipping 303 matching lines @@
 }
 
 /** A subscription resource. */
 class Subscription {
   /**
    * This value is the maximum time after a subscriber receives a message before
    * the subscriber should acknowledge the message. After message delivery but
    * before the ack deadline expires and before the message is acknowledged, it
    * is an outstanding message and will not be delivered again during that time
    * (on a best-effort basis). For pull delivery this value is used as the
-   * initial value for the ack deadline. It may be overridden for each message
-   * using its corresponding ack_id by calling ModifyAckDeadline. For push
+   * initial value for the ack deadline. To override this value for a given
+   * message, call ModifyAckDeadline with the corresponding ack_id. For push
    * delivery, this value is also used to set the request timeout for the call
    * to the push endpoint. If the subscriber never acknowledges the message, the
    * Pub/Sub system will eventually redeliver the message. If this parameter is
-   * not set, the default value of 60 seconds is used.
+   * not set, the default value of 10 seconds is used.
    */
   core.int ackDeadlineSeconds;
   /**
    * The name of the subscription. It must have the format
-   * "projects/{project}/subscriptions/{subscription}" for Google Cloud Pub/Sub
-   * API v1 and v1beta2. {subscription} must start with a letter, and contain
-   * only letters ([A-Za-z]), numbers ([0-9], dashes (-), underscores (_),
-   * periods (.), tildes (~), plus (+) or percent signs (%). It must be between
-   * 3 and 255 characters in length, and it must not start with "goog".
+   * `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
+   * start with a letter, and contain only letters (`[A-Za-z]`), numbers
+   * (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
+   * plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
+   * in length, and it must not start with `"goog"`.
    */
   core.String name;
   /**
    * If push delivery is used with this subscription, this field is used to
    * configure it. An empty pushConfig signifies that the subscriber will pull
    * and ack messages using API methods.
    */
   PushConfig pushConfig;
   /**
    * The name of the topic from which this subscription is receiving messages.
@@ skipping 84 matching lines @@
       _json["permissions"] = permissions;
     }
     return _json;
   }
 }
 
 /** A topic resource. */
 class Topic {
   /**
    * The name of the topic. It must have the format
-   * "projects/{project}/topics/{topic}" for Google Cloud Pub/Sub API v1 and
-   * v1beta2. {topic} must start with a letter, and contain only letters
-   * ([A-Za-z]), numbers ([0-9], dashes (-), underscores (_), periods (.),
-   * tildes (~), plus (+) or percent signs (%). It must be between 3 and 255
-   * characters in length, and it must not start with "goog".
+   * `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
+   * and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+   * underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs
+   * (`%`). It must be between 3 and 255 characters in length, and it must not
+   * start with `"goog"`.
    */
   core.String name;
 
   Topic();
 
   Topic.fromJson(core.Map _json) {
     if (_json.containsKey("name")) {
       name = _json["name"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (name != null) {
       _json["name"] = name;
     }
     return _json;
   }
 }