google-cloud-pubsub-v1 0.1.0 → 0.3.0

data/proto_docs/google/protobuf/timestamp.rb

@@ -70,7 +70,16 @@ module Google
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
     #
-    # Example 5: Compute Timestamp from current time in Python.
+    # Example 5: Compute Timestamp from Java `Instant.now()`.
+    #
+    #     Instant now = Instant.now();
+    #
+    #     Timestamp timestamp =
+    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+    #             .setNanos(now.getNano()).build();
+    #
+    #
+    # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
     #     timestamp.GetCurrentTime()

data/proto_docs/google/pubsub/v1/pubsub.rb

@@ -34,6 +34,21 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Settings for validating messages published against a schema.
+        # @!attribute [rw] schema
+        #   @return [::String]
+        #     Required. The name of the schema that messages published should be
+        #     validated against. Format is `projects/{project}/schemas/{schema}`. The
+        #     value of this field will be `_deleted-schema_` if the schema has been
+        #     deleted.
+        # @!attribute [rw] encoding
+        #   @return [::Google::Cloud::PubSub::V1::Encoding]
+        #     The encoding of messages validated against `schema`.
+        class SchemaSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A topic resource.
         # @!attribute [rw] name
         #   @return [::String]
@@ -45,8 +60,8 @@ module Google
         #     must not start with `"goog"`.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-        #     managing labels</a>.
+        #     See [Creating and managing labels]
+        #     (https://cloud.google.com/pubsub/docs/labels).
         # @!attribute [rw] message_storage_policy
         #   @return [::Google::Cloud::PubSub::V1::MessageStoragePolicy]
         #     Policy constraining the set of Google Cloud Platform regions where messages
@@ -58,6 +73,15 @@ module Google
         #     to messages published on this topic.
         #
         #     The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+        # @!attribute [rw] schema_settings
+        #   @return [::Google::Cloud::PubSub::V1::SchemaSettings]
+        #     Settings for validating messages published against a schema.
+        #
+        #     EXPERIMENTAL: Schema support is in development and may not work yet.
+        # @!attribute [rw] satisfies_pzs
+        #   @return [::Boolean]
+        #     Reserved for future use. This field is set only in responses from the
+        #     server; it is ignored if it is set in any requests.
         class Topic
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -75,11 +99,11 @@ module Google
         # A message that is published by publishers and consumed by subscribers. The
         # message must contain either a non-empty data field or at least one attribute.
         # Note that client libraries represent this object differently
-        # depending on the language. See the corresponding
-        # <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
-        # library documentation</a> for more information. See
-        # <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
-        # for more information about message limits.
+        # depending on the language. See the corresponding [client library
+        # documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
+        # more information. See [quotas and limits]
+        # (https://cloud.google.com/pubsub/quotas) for more information about message
+        # limits.
         # @!attribute [rw] data
         #   @return [::String]
         #     The message data field. If this field is empty, the message must contain
@@ -108,9 +132,6 @@ module Google
         #     delivered to subscribers in the order in which they are received by the
         #     Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
         #     must specify the same `ordering_key` value.
-        #     <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
-        #     API might be changed in backward-incompatible ways and is not recommended
-        #     for production use. It is not subject to any SLA or deprecation policy.
         class PubsubMessage
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -343,10 +364,8 @@ module Google
         #     Indicates whether to retain acknowledged messages. If true, then
         #     messages are not expunged from the subscription's backlog, even if they are
         #     acknowledged, until they fall out of the `message_retention_duration`
-        #     window. This must be true if you would like to
-        #     <a
-        #     href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
-        #     Seek to a timestamp</a>.
+        #     window. This must be true if you would like to [Seek to a timestamp]
+        #     (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time).
         # @!attribute [rw] message_retention_duration
         #   @return [::Google::Protobuf::Duration]
         #     How long to retain unacknowledged messages in the subscription's backlog,
@@ -365,9 +384,6 @@ module Google
         #     will be delivered to the subscribers in the order in which they
         #     are received by the Pub/Sub system. Otherwise, they may be delivered in
         #     any order.
-        #     <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
-        #     API might be changed in backward-incompatible ways and is not recommended
-        #     for production use. It is not subject to any SLA or deprecation policy.
         # @!attribute [rw] expiration_policy
         #   @return [::Google::Cloud::PubSub::V1::ExpirationPolicy]
         #     A policy that specifies the conditions for this subscription's expiration.
@@ -893,11 +909,10 @@ module Google
         end
 
         # A snapshot resource. Snapshots are used in
-        # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-        # operations, which allow
-        # you to manage message acknowledgments in bulk. That is, you can set the
-        # acknowledgment state of messages in an existing subscription to the state
-        # captured by a snapshot.
+        # [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+        # operations, which allow you to manage message acknowledgments in bulk. That
+        # is, you can set the acknowledgment state of messages in an existing
+        # subscription to the state captured by a snapshot.
         # @!attribute [rw] name
         #   @return [::String]
         #     The name of the snapshot.
@@ -918,8 +933,8 @@ module Google
         #     snapshot that would expire in less than 1 hour after creation.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-        #     managing labels</a>.
+        #     See [Creating and managing labels]
+        #     (https://cloud.google.com/pubsub/docs/labels).
         class Snapshot
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/pubsub/v1/schema.rb

@@ -0,0 +1,216 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module PubSub
+      module V1
+        # A schema resource.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the schema.
+        #     Format is `projects/{project}/schemas/{schema}`.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::PubSub::V1::Schema::Type]
+        #     The type of the schema definition.
+        # @!attribute [rw] definition
+        #   @return [::String]
+        #     The definition of the schema. This should contain a string representing
+        #     the full definition of the schema that is a valid schema definition of
+        #     the type specified in `type`.
+        class Schema
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Possible schema definition types.
+          module Type
+            # Default value. This value is unused.
+            TYPE_UNSPECIFIED = 0
+
+            # A Protocol Buffer schema definition.
+            PROTOCOL_BUFFER = 1
+
+            # An Avro schema definition.
+            AVRO = 2
+          end
+        end
+
+        # Request for the CreateSchema method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the project in which to create the schema.
+        #     Format is `projects/{project-id}`.
+        # @!attribute [rw] schema
+        #   @return [::Google::Cloud::PubSub::V1::Schema]
+        #     Required. The schema object to create.
+        #
+        #     This schema's `name` parameter is ignored. The schema object returned
+        #     by CreateSchema will have a `name` made using the given `parent` and
+        #     `schema_id`.
+        # @!attribute [rw] schema_id
+        #   @return [::String]
+        #     The ID to use for the schema, which will become the final component of
+        #     the schema's resource name.
+        #
+        #     See https://cloud.google.com/pubsub/docs/admin#resource_names for resource
+        #     name constraints.
+        class CreateSchemaRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the GetSchema method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the schema to get.
+        #     Format is `projects/{project}/schemas/{schema}`.
+        # @!attribute [rw] view
+        #   @return [::Google::Cloud::PubSub::V1::SchemaView]
+        #     The set of fields to return in the response. If not set, returns a Schema
+        #     with `name` and `type`, but not `definition`. Set to `FULL` to retrieve all
+        #     fields.
+        class GetSchemaRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `ListSchemas` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the project in which to list schemas.
+        #     Format is `projects/{project-id}`.
+        # @!attribute [rw] view
+        #   @return [::Google::Cloud::PubSub::V1::SchemaView]
+        #     The set of Schema fields to return in the response. If not set, returns
+        #     Schemas with `name` and `type`, but not `definition`. Set to `FULL` to
+        #     retrieve all fields.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Maximum number of schemas to return.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The value returned by the last `ListSchemasResponse`; indicates that
+        #     this is a continuation of a prior `ListSchemas` call, and that the
+        #     system should return the next page of data.
+        class ListSchemasRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for the `ListSchemas` method.
+        # @!attribute [rw] schemas
+        #   @return [::Array<::Google::Cloud::PubSub::V1::Schema>]
+        #     The resulting schemas.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     If not empty, indicates that there may be more schemas that match the
+        #     request; this value should be passed in a new `ListSchemasRequest`.
+        class ListSchemasResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `DeleteSchema` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the schema to delete.
+        #     Format is `projects/{project}/schemas/{schema}`.
+        class DeleteSchemaRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `ValidateSchema` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the project in which to validate schemas.
+        #     Format is `projects/{project-id}`.
+        # @!attribute [rw] schema
+        #   @return [::Google::Cloud::PubSub::V1::Schema]
+        #     Required. The schema object to validate.
+        class ValidateSchemaRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for the `ValidateSchema` method.
+        class ValidateSchemaResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `ValidateMessage` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The name of the project in which to validate schemas.
+        #     Format is `projects/{project-id}`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Name of the schema against which to validate.
+        #
+        #     Format is `projects/{project}/schemas/{schema}`.
+        # @!attribute [rw] schema
+        #   @return [::Google::Cloud::PubSub::V1::Schema]
+        #     Ad-hoc schema against which to validate
+        # @!attribute [rw] message
+        #   @return [::String]
+        #     Message to validate against the provided `schema_spec`.
+        # @!attribute [rw] encoding
+        #   @return [::Google::Cloud::PubSub::V1::Encoding]
+        #     The encoding expected for messages
+        class ValidateMessageRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for the `ValidateMessage` method.
+        class ValidateMessageResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # View of Schema object fields to be returned by GetSchema and ListSchemas.
+        module SchemaView
+          # The default / unset value.
+          # The API will default to the BASIC view.
+          SCHEMA_VIEW_UNSPECIFIED = 0
+
+          # Include the name and type of the schema, but not the definition.
+          BASIC = 1
+
+          # Include all Schema object fields.
+          FULL = 2
+        end
+
+        # Possible encoding types for messages.
+        module Encoding
+          # Unspecified
+          ENCODING_UNSPECIFIED = 0
+
+          # JSON encoding
+          JSON = 1
+
+          # Binary encoding, as defined by the schema type. For some schema types,
+          # binary encoding may not be available.
+          BINARY = 2
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub-v1
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-03 00:00:00.000000000 Z
+date: 2021-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -171,7 +171,9 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.9'
 description: Cloud Pub/Sub is a fully-managed real-time messaging service that allows
-  you to send and receive messages between independent applications.
+  you to send and receive messages between independent applications. Note that google-cloud-pubsub-v1
+  is a version-specific client library. For most uses, we recommend installing the
+  main client library google-cloud-pubsub instead. See the readme for more details.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
@@ -191,6 +193,10 @@ files:
 - lib/google/cloud/pubsub/v1/publisher/credentials.rb
 - lib/google/cloud/pubsub/v1/publisher/helpers.rb
 - lib/google/cloud/pubsub/v1/publisher/paths.rb
+- lib/google/cloud/pubsub/v1/schema_service.rb
+- lib/google/cloud/pubsub/v1/schema_service/client.rb
+- lib/google/cloud/pubsub/v1/schema_service/credentials.rb
+- lib/google/cloud/pubsub/v1/schema_service/paths.rb
 - lib/google/cloud/pubsub/v1/subscriber.rb
 - lib/google/cloud/pubsub/v1/subscriber/client.rb
 - lib/google/cloud/pubsub/v1/subscriber/credentials.rb
@@ -200,6 +206,8 @@ files:
 - lib/google/iam/v1/iam_policy_services_pb.rb
 - lib/google/pubsub/v1/pubsub_pb.rb
 - lib/google/pubsub/v1/pubsub_services_pb.rb
+- lib/google/pubsub/v1/schema_pb.rb
+- lib/google/pubsub/v1/schema_services_pb.rb
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/resource.rb
@@ -211,6 +219,7 @@ files:
 - proto_docs/google/protobuf/field_mask.rb
 - proto_docs/google/protobuf/timestamp.rb
 - proto_docs/google/pubsub/v1/pubsub.rb
+- proto_docs/google/pubsub/v1/schema.rb
 - proto_docs/google/type/expr.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
@@ -231,7 +240,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.3
+rubygems_version: 3.2.6
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Pub/Sub V1 API