google-cloud-data_catalog-v1 0.12.0 → 0.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/AUTHENTICATION.md +1 -1
- data/README.md +1 -1
- data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +30 -24
- data/lib/google/cloud/data_catalog/v1/data_catalog.rb +1 -1
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +22 -12
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager.rb +1 -1
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +14 -0
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization.rb +1 -1
- data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
- data/lib/google/cloud/data_catalog/v1.rb +2 -2
- data/lib/google/cloud/datacatalog/v1/usage_pb.rb +1 -0
- data/proto_docs/google/api/client.rb +318 -0
- data/proto_docs/google/api/launch_stage.rb +71 -0
- data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +18 -16
- data/proto_docs/google/cloud/datacatalog/v1/usage.rb +2 -2
- data/proto_docs/google/protobuf/duration.rb +98 -0
- data/proto_docs/google/protobuf/empty.rb +0 -2
- metadata +21 -15
- data/proto_docs/google/iam/v1/iam_policy.rb +0 -87
- data/proto_docs/google/iam/v1/options.rb +0 -50
- data/proto_docs/google/iam/v1/policy.rb +0 -418
    
        checksums.yaml
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            ---
         | 
| 2 2 | 
             
            SHA256:
         | 
| 3 | 
            -
              metadata.gz:  | 
| 4 | 
            -
              data.tar.gz:  | 
| 3 | 
            +
              metadata.gz: 411fd1764f657bce89c9ed3d1b28753d8119afc7f0c460cc7b8df8aeb640a48e
         | 
| 4 | 
            +
              data.tar.gz: df455550c1154e9f84e7034129ae917e2eef020f74b6d996e772414fd9025c78
         | 
| 5 5 | 
             
            SHA512:
         | 
| 6 | 
            -
              metadata.gz:  | 
| 7 | 
            -
              data.tar.gz:  | 
| 6 | 
            +
              metadata.gz: 6ac6b7d57c7868b779b4c9de2d71ddcd783731e6d6d3b92e8ce8e90230ccb1cd064c837295b03f22d76fb5d49416e545cb10855587b96855f55d46142c310d7f
         | 
| 7 | 
            +
              data.tar.gz: 2af89f682588cafeafd8f196e1356f73709b440079dcd154d0d4b77c82d26d41ebe0f3ad6beb109ae167cb49528a71766d808e98cdedf582ba4a1302db3f29b0
         | 
    
        data/AUTHENTICATION.md
    CHANGED
    
    | @@ -114,7 +114,7 @@ credentials are discovered. | |
| 114 114 | 
             
            To configure your system for this, simply:
         | 
| 115 115 |  | 
| 116 116 | 
             
            1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
         | 
| 117 | 
            -
            2. Authenticate using OAuth 2.0 `$ gcloud auth login`
         | 
| 117 | 
            +
            2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
         | 
| 118 118 | 
             
            3. Write code as if already authenticated.
         | 
| 119 119 |  | 
| 120 120 | 
             
            **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
         | 
    
        data/README.md
    CHANGED
    
    | @@ -46,7 +46,7 @@ for general usage information. | |
| 46 46 | 
             
            ## Enabling Logging
         | 
| 47 47 |  | 
| 48 48 | 
             
            To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
         | 
| 49 | 
            -
            The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/ | 
| 49 | 
            +
            The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
         | 
| 50 50 | 
             
            or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
         | 
| 51 51 | 
             
            that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
         | 
| 52 52 | 
             
            and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
         | 
| @@ -18,6 +18,7 @@ | |
| 18 18 |  | 
| 19 19 | 
             
            require "google/cloud/errors"
         | 
| 20 20 | 
             
            require "google/cloud/datacatalog/v1/datacatalog_pb"
         | 
| 21 | 
            +
            require "google/iam/v1"
         | 
| 21 22 |  | 
| 22 23 | 
             
            module Google
         | 
| 23 24 | 
             
              module Cloud
         | 
| @@ -176,6 +177,12 @@ module Google | |
| 176 177 | 
             
                          @quota_project_id = @config.quota_project
         | 
| 177 178 | 
             
                          @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
         | 
| 178 179 |  | 
| 180 | 
            +
                          @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
         | 
| 181 | 
            +
                            config.credentials = credentials
         | 
| 182 | 
            +
                            config.quota_project = @quota_project_id
         | 
| 183 | 
            +
                            config.endpoint = @config.endpoint
         | 
| 184 | 
            +
                          end
         | 
| 185 | 
            +
             | 
| 179 186 | 
             
                          @data_catalog_stub = ::Gapic::ServiceStub.new(
         | 
| 180 187 | 
             
                            ::Google::Cloud::DataCatalog::V1::DataCatalog::Stub,
         | 
| 181 188 | 
             
                            credentials:  credentials,
         | 
| @@ -185,6 +192,13 @@ module Google | |
| 185 192 | 
             
                          )
         | 
| 186 193 | 
             
                        end
         | 
| 187 194 |  | 
| 195 | 
            +
                        ##
         | 
| 196 | 
            +
                        # Get the associated client for mix-in of the IAMPolicy.
         | 
| 197 | 
            +
                        #
         | 
| 198 | 
            +
                        # @return [Google::Iam::V1::IAMPolicy::Client]
         | 
| 199 | 
            +
                        #
         | 
| 200 | 
            +
                        attr_reader :iam_policy_client
         | 
| 201 | 
            +
             | 
| 188 202 | 
             
                        # Service calls
         | 
| 189 203 |  | 
| 190 204 | 
             
                        ##
         | 
| @@ -284,13 +298,11 @@ module Google | |
| 284 298 | 
             
                        #   # Call the search_catalog method.
         | 
| 285 299 | 
             
                        #   result = client.search_catalog request
         | 
| 286 300 | 
             
                        #
         | 
| 287 | 
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         | 
| 288 | 
            -
                        #   #  | 
| 289 | 
            -
                        #    | 
| 290 | 
            -
                        #   # methods are also available for managing paging directly.
         | 
| 291 | 
            -
                        #   result.each do |response|
         | 
| 301 | 
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         | 
| 302 | 
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         | 
| 303 | 
            +
                        #   result.each do |item|
         | 
| 292 304 | 
             
                        #     # Each element is of type ::Google::Cloud::DataCatalog::V1::SearchCatalogResult.
         | 
| 293 | 
            -
                        #     p  | 
| 305 | 
            +
                        #     p item
         | 
| 294 306 | 
             
                        #   end
         | 
| 295 307 | 
             
                        #
         | 
| 296 308 | 
             
                        def search_catalog request, options = nil
         | 
| @@ -775,13 +787,11 @@ module Google | |
| 775 787 | 
             
                        #   # Call the list_entry_groups method.
         | 
| 776 788 | 
             
                        #   result = client.list_entry_groups request
         | 
| 777 789 | 
             
                        #
         | 
| 778 | 
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         | 
| 779 | 
            -
                        #   #  | 
| 780 | 
            -
                        #    | 
| 781 | 
            -
                        #   # methods are also available for managing paging directly.
         | 
| 782 | 
            -
                        #   result.each do |response|
         | 
| 790 | 
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         | 
| 791 | 
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         | 
| 792 | 
            +
                        #   result.each do |item|
         | 
| 783 793 | 
             
                        #     # Each element is of type ::Google::Cloud::DataCatalog::V1::EntryGroup.
         | 
| 784 | 
            -
                        #     p  | 
| 794 | 
            +
                        #     p item
         | 
| 785 795 | 
             
                        #   end
         | 
| 786 796 | 
             
                        #
         | 
| 787 797 | 
             
                        def list_entry_groups request, options = nil
         | 
| @@ -1406,13 +1416,11 @@ module Google | |
| 1406 1416 | 
             
                        #   # Call the list_entries method.
         | 
| 1407 1417 | 
             
                        #   result = client.list_entries request
         | 
| 1408 1418 | 
             
                        #
         | 
| 1409 | 
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         | 
| 1410 | 
            -
                        #   #  | 
| 1411 | 
            -
                        #    | 
| 1412 | 
            -
                        #   # methods are also available for managing paging directly.
         | 
| 1413 | 
            -
                        #   result.each do |response|
         | 
| 1419 | 
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         | 
| 1420 | 
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         | 
| 1421 | 
            +
                        #   result.each do |item|
         | 
| 1414 1422 | 
             
                        #     # Each element is of type ::Google::Cloud::DataCatalog::V1::Entry.
         | 
| 1415 | 
            -
                        #     p  | 
| 1423 | 
            +
                        #     p item
         | 
| 1416 1424 | 
             
                        #   end
         | 
| 1417 1425 | 
             
                        #
         | 
| 1418 1426 | 
             
                        def list_entries request, options = nil
         | 
| @@ -2838,13 +2846,11 @@ module Google | |
| 2838 2846 | 
             
                        #   # Call the list_tags method.
         | 
| 2839 2847 | 
             
                        #   result = client.list_tags request
         | 
| 2840 2848 | 
             
                        #
         | 
| 2841 | 
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         | 
| 2842 | 
            -
                        #   #  | 
| 2843 | 
            -
                        #    | 
| 2844 | 
            -
                        #   # methods are also available for managing paging directly.
         | 
| 2845 | 
            -
                        #   result.each do |response|
         | 
| 2849 | 
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         | 
| 2850 | 
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         | 
| 2851 | 
            +
                        #   result.each do |item|
         | 
| 2846 2852 | 
             
                        #     # Each element is of type ::Google::Cloud::DataCatalog::V1::Tag.
         | 
| 2847 | 
            -
                        #     p  | 
| 2853 | 
            +
                        #     p item
         | 
| 2848 2854 | 
             
                        #   end
         | 
| 2849 2855 | 
             
                        #
         | 
| 2850 2856 | 
             
                        def list_tags request, options = nil
         | 
| @@ -34,7 +34,7 @@ module Google | |
| 34 34 | 
             
                    # Data Catalog API service allows you to discover, understand, and manage
         | 
| 35 35 | 
             
                    # your data.
         | 
| 36 36 | 
             
                    #
         | 
| 37 | 
            -
                    #  | 
| 37 | 
            +
                    # @example Load this service and instantiate a gRPC client
         | 
| 38 38 | 
             
                    #
         | 
| 39 39 | 
             
                    #     require "google/cloud/data_catalog/v1/data_catalog"
         | 
| 40 40 | 
             
                    #     client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
         | 
| @@ -18,6 +18,7 @@ | |
| 18 18 |  | 
| 19 19 | 
             
            require "google/cloud/errors"
         | 
| 20 20 | 
             
            require "google/cloud/datacatalog/v1/policytagmanager_pb"
         | 
| 21 | 
            +
            require "google/iam/v1"
         | 
| 21 22 |  | 
| 22 23 | 
             
            module Google
         | 
| 23 24 | 
             
              module Cloud
         | 
| @@ -140,6 +141,12 @@ module Google | |
| 140 141 | 
             
                          @quota_project_id = @config.quota_project
         | 
| 141 142 | 
             
                          @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
         | 
| 142 143 |  | 
| 144 | 
            +
                          @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
         | 
| 145 | 
            +
                            config.credentials = credentials
         | 
| 146 | 
            +
                            config.quota_project = @quota_project_id
         | 
| 147 | 
            +
                            config.endpoint = @config.endpoint
         | 
| 148 | 
            +
                          end
         | 
| 149 | 
            +
             | 
| 143 150 | 
             
                          @policy_tag_manager_stub = ::Gapic::ServiceStub.new(
         | 
| 144 151 | 
             
                            ::Google::Cloud::DataCatalog::V1::PolicyTagManager::Stub,
         | 
| 145 152 | 
             
                            credentials:  credentials,
         | 
| @@ -149,6 +156,13 @@ module Google | |
| 149 156 | 
             
                          )
         | 
| 150 157 | 
             
                        end
         | 
| 151 158 |  | 
| 159 | 
            +
                        ##
         | 
| 160 | 
            +
                        # Get the associated client for mix-in of the IAMPolicy.
         | 
| 161 | 
            +
                        #
         | 
| 162 | 
            +
                        # @return [Google::Iam::V1::IAMPolicy::Client]
         | 
| 163 | 
            +
                        #
         | 
| 164 | 
            +
                        attr_reader :iam_policy_client
         | 
| 165 | 
            +
             | 
| 152 166 | 
             
                        # Service calls
         | 
| 153 167 |  | 
| 154 168 | 
             
                        ##
         | 
| @@ -472,13 +486,11 @@ module Google | |
| 472 486 | 
             
                        #   # Call the list_taxonomies method.
         | 
| 473 487 | 
             
                        #   result = client.list_taxonomies request
         | 
| 474 488 | 
             
                        #
         | 
| 475 | 
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         | 
| 476 | 
            -
                        #   #  | 
| 477 | 
            -
                        #    | 
| 478 | 
            -
                        #   # methods are also available for managing paging directly.
         | 
| 479 | 
            -
                        #   result.each do |response|
         | 
| 489 | 
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         | 
| 490 | 
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         | 
| 491 | 
            +
                        #   result.each do |item|
         | 
| 480 492 | 
             
                        #     # Each element is of type ::Google::Cloud::DataCatalog::V1::Taxonomy.
         | 
| 481 | 
            -
                        #     p  | 
| 493 | 
            +
                        #     p item
         | 
| 482 494 | 
             
                        #   end
         | 
| 483 495 | 
             
                        #
         | 
| 484 496 | 
             
                        def list_taxonomies request, options = nil
         | 
| @@ -931,13 +943,11 @@ module Google | |
| 931 943 | 
             
                        #   # Call the list_policy_tags method.
         | 
| 932 944 | 
             
                        #   result = client.list_policy_tags request
         | 
| 933 945 | 
             
                        #
         | 
| 934 | 
            -
                        #   # The returned object is of type Gapic::PagedEnumerable. You can
         | 
| 935 | 
            -
                        #   #  | 
| 936 | 
            -
                        #    | 
| 937 | 
            -
                        #   # methods are also available for managing paging directly.
         | 
| 938 | 
            -
                        #   result.each do |response|
         | 
| 946 | 
            +
                        #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
         | 
| 947 | 
            +
                        #   # over elements, and API calls will be issued to fetch pages as needed.
         | 
| 948 | 
            +
                        #   result.each do |item|
         | 
| 939 949 | 
             
                        #     # Each element is of type ::Google::Cloud::DataCatalog::V1::PolicyTag.
         | 
| 940 | 
            -
                        #     p  | 
| 950 | 
            +
                        #     p item
         | 
| 941 951 | 
             
                        #   end
         | 
| 942 952 | 
             
                        #
         | 
| 943 953 | 
             
                        def list_policy_tags request, options = nil
         | 
| @@ -38,7 +38,7 @@ module Google | |
| 38 38 | 
             
                    # control policies. A taxonomy is a hierarchical grouping of policy tags that
         | 
| 39 39 | 
             
                    # classify data along a common axis.
         | 
| 40 40 | 
             
                    #
         | 
| 41 | 
            -
                    #  | 
| 41 | 
            +
                    # @example Load this service and instantiate a gRPC client
         | 
| 42 42 | 
             
                    #
         | 
| 43 43 | 
             
                    #     require "google/cloud/data_catalog/v1/policy_tag_manager"
         | 
| 44 44 | 
             
                    #     client = ::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client.new
         | 
| @@ -18,6 +18,7 @@ | |
| 18 18 |  | 
| 19 19 | 
             
            require "google/cloud/errors"
         | 
| 20 20 | 
             
            require "google/cloud/datacatalog/v1/policytagmanagerserialization_pb"
         | 
| 21 | 
            +
            require "google/iam/v1"
         | 
| 21 22 |  | 
| 22 23 | 
             
            module Google
         | 
| 23 24 | 
             
              module Cloud
         | 
| @@ -138,6 +139,12 @@ module Google | |
| 138 139 | 
             
                          @quota_project_id = @config.quota_project
         | 
| 139 140 | 
             
                          @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
         | 
| 140 141 |  | 
| 142 | 
            +
                          @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
         | 
| 143 | 
            +
                            config.credentials = credentials
         | 
| 144 | 
            +
                            config.quota_project = @quota_project_id
         | 
| 145 | 
            +
                            config.endpoint = @config.endpoint
         | 
| 146 | 
            +
                          end
         | 
| 147 | 
            +
             | 
| 141 148 | 
             
                          @policy_tag_manager_serialization_stub = ::Gapic::ServiceStub.new(
         | 
| 142 149 | 
             
                            ::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Stub,
         | 
| 143 150 | 
             
                            credentials:  credentials,
         | 
| @@ -147,6 +154,13 @@ module Google | |
| 147 154 | 
             
                          )
         | 
| 148 155 | 
             
                        end
         | 
| 149 156 |  | 
| 157 | 
            +
                        ##
         | 
| 158 | 
            +
                        # Get the associated client for mix-in of the IAMPolicy.
         | 
| 159 | 
            +
                        #
         | 
| 160 | 
            +
                        # @return [Google::Iam::V1::IAMPolicy::Client]
         | 
| 161 | 
            +
                        #
         | 
| 162 | 
            +
                        attr_reader :iam_policy_client
         | 
| 163 | 
            +
             | 
| 150 164 | 
             
                        # Service calls
         | 
| 151 165 |  | 
| 152 166 | 
             
                        ##
         | 
| @@ -36,7 +36,7 @@ module Google | |
| 36 36 | 
             
                    #
         | 
| 37 37 | 
             
                    # Taxonomy is a hierarchical group of policy tags.
         | 
| 38 38 | 
             
                    #
         | 
| 39 | 
            -
                    #  | 
| 39 | 
            +
                    # @example Load this service and instantiate a gRPC client
         | 
| 40 40 | 
             
                    #
         | 
| 41 41 | 
             
                    #     require "google/cloud/data_catalog/v1/policy_tag_manager_serialization"
         | 
| 42 42 | 
             
                    #     client = ::Google::Cloud::DataCatalog::V1::PolicyTagManagerSerialization::Client.new
         | 
| @@ -25,9 +25,9 @@ module Google | |
| 25 25 | 
             
              module Cloud
         | 
| 26 26 | 
             
                module DataCatalog
         | 
| 27 27 | 
             
                  ##
         | 
| 28 | 
            -
                  #  | 
| 28 | 
            +
                  # API client module.
         | 
| 29 29 | 
             
                  #
         | 
| 30 | 
            -
                  # @example
         | 
| 30 | 
            +
                  # @example Load this package, including all its services, and instantiate a gRPC client
         | 
| 31 31 | 
             
                  #
         | 
| 32 32 | 
             
                  #     require "google/cloud/data_catalog/v1"
         | 
| 33 33 | 
             
                  #     client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
         | 
| @@ -0,0 +1,318 @@ | |
| 1 | 
            +
            # frozen_string_literal: true
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            # Copyright 2022 Google LLC
         | 
| 4 | 
            +
            #
         | 
| 5 | 
            +
            # Licensed under the Apache License, Version 2.0 (the "License");
         | 
| 6 | 
            +
            # you may not use this file except in compliance with the License.
         | 
| 7 | 
            +
            # You may obtain a copy of the License at
         | 
| 8 | 
            +
            #
         | 
| 9 | 
            +
            #     https://www.apache.org/licenses/LICENSE-2.0
         | 
| 10 | 
            +
            #
         | 
| 11 | 
            +
            # Unless required by applicable law or agreed to in writing, software
         | 
| 12 | 
            +
            # distributed under the License is distributed on an "AS IS" BASIS,
         | 
| 13 | 
            +
            # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
         | 
| 14 | 
            +
            # See the License for the specific language governing permissions and
         | 
| 15 | 
            +
            # limitations under the License.
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
         | 
| 18 | 
            +
             | 
| 19 | 
            +
             | 
| 20 | 
            +
            module Google
         | 
| 21 | 
            +
              module Api
         | 
| 22 | 
            +
                # Required information for every language.
         | 
| 23 | 
            +
                # @!attribute [rw] reference_docs_uri
         | 
| 24 | 
            +
                #   @return [::String]
         | 
| 25 | 
            +
                #     Link to automatically generated reference documentation.  Example:
         | 
| 26 | 
            +
                #     https://cloud.google.com/nodejs/docs/reference/asset/latest
         | 
| 27 | 
            +
                # @!attribute [rw] destinations
         | 
| 28 | 
            +
                #   @return [::Array<::Google::Api::ClientLibraryDestination>]
         | 
| 29 | 
            +
                #     The destination where API teams want this client library to be published.
         | 
| 30 | 
            +
                class CommonLanguageSettings
         | 
| 31 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 32 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 33 | 
            +
                end
         | 
| 34 | 
            +
             | 
| 35 | 
            +
                # Details about how and where to publish client libraries.
         | 
| 36 | 
            +
                # @!attribute [rw] version
         | 
| 37 | 
            +
                #   @return [::String]
         | 
| 38 | 
            +
                #     Version of the API to apply these settings to.
         | 
| 39 | 
            +
                # @!attribute [rw] launch_stage
         | 
| 40 | 
            +
                #   @return [::Google::Api::LaunchStage]
         | 
| 41 | 
            +
                #     Launch stage of this version of the API.
         | 
| 42 | 
            +
                # @!attribute [rw] rest_numeric_enums
         | 
| 43 | 
            +
                #   @return [::Boolean]
         | 
| 44 | 
            +
                #     When using transport=rest, the client request will encode enums as
         | 
| 45 | 
            +
                #     numbers rather than strings.
         | 
| 46 | 
            +
                # @!attribute [rw] java_settings
         | 
| 47 | 
            +
                #   @return [::Google::Api::JavaSettings]
         | 
| 48 | 
            +
                #     Settings for legacy Java features, supported in the Service YAML.
         | 
| 49 | 
            +
                # @!attribute [rw] cpp_settings
         | 
| 50 | 
            +
                #   @return [::Google::Api::CppSettings]
         | 
| 51 | 
            +
                #     Settings for C++ client libraries.
         | 
| 52 | 
            +
                # @!attribute [rw] php_settings
         | 
| 53 | 
            +
                #   @return [::Google::Api::PhpSettings]
         | 
| 54 | 
            +
                #     Settings for PHP client libraries.
         | 
| 55 | 
            +
                # @!attribute [rw] python_settings
         | 
| 56 | 
            +
                #   @return [::Google::Api::PythonSettings]
         | 
| 57 | 
            +
                #     Settings for Python client libraries.
         | 
| 58 | 
            +
                # @!attribute [rw] node_settings
         | 
| 59 | 
            +
                #   @return [::Google::Api::NodeSettings]
         | 
| 60 | 
            +
                #     Settings for Node client libraries.
         | 
| 61 | 
            +
                # @!attribute [rw] dotnet_settings
         | 
| 62 | 
            +
                #   @return [::Google::Api::DotnetSettings]
         | 
| 63 | 
            +
                #     Settings for .NET client libraries.
         | 
| 64 | 
            +
                # @!attribute [rw] ruby_settings
         | 
| 65 | 
            +
                #   @return [::Google::Api::RubySettings]
         | 
| 66 | 
            +
                #     Settings for Ruby client libraries.
         | 
| 67 | 
            +
                # @!attribute [rw] go_settings
         | 
| 68 | 
            +
                #   @return [::Google::Api::GoSettings]
         | 
| 69 | 
            +
                #     Settings for Go client libraries.
         | 
| 70 | 
            +
                class ClientLibrarySettings
         | 
| 71 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 72 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 73 | 
            +
                end
         | 
| 74 | 
            +
             | 
| 75 | 
            +
                # This message configures the settings for publishing [Google Cloud Client
         | 
| 76 | 
            +
                # libraries](https://cloud.google.com/apis/docs/cloud-client-libraries)
         | 
| 77 | 
            +
                # generated from the service config.
         | 
| 78 | 
            +
                # @!attribute [rw] method_settings
         | 
| 79 | 
            +
                #   @return [::Array<::Google::Api::MethodSettings>]
         | 
| 80 | 
            +
                #     A list of API method settings, e.g. the behavior for methods that use the
         | 
| 81 | 
            +
                #     long-running operation pattern.
         | 
| 82 | 
            +
                # @!attribute [rw] new_issue_uri
         | 
| 83 | 
            +
                #   @return [::String]
         | 
| 84 | 
            +
                #     Link to a place that API users can report issues.  Example:
         | 
| 85 | 
            +
                #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
         | 
| 86 | 
            +
                # @!attribute [rw] documentation_uri
         | 
| 87 | 
            +
                #   @return [::String]
         | 
| 88 | 
            +
                #     Link to product home page.  Example:
         | 
| 89 | 
            +
                #     https://cloud.google.com/asset-inventory/docs/overview
         | 
| 90 | 
            +
                # @!attribute [rw] api_short_name
         | 
| 91 | 
            +
                #   @return [::String]
         | 
| 92 | 
            +
                #     Used as a tracking tag when collecting data about the APIs developer
         | 
| 93 | 
            +
                #     relations artifacts like docs, packages delivered to package managers,
         | 
| 94 | 
            +
                #     etc.  Example: "speech".
         | 
| 95 | 
            +
                # @!attribute [rw] github_label
         | 
| 96 | 
            +
                #   @return [::String]
         | 
| 97 | 
            +
                #     GitHub label to apply to issues and pull requests opened for this API.
         | 
| 98 | 
            +
                # @!attribute [rw] codeowner_github_teams
         | 
| 99 | 
            +
                #   @return [::Array<::String>]
         | 
| 100 | 
            +
                #     GitHub teams to be added to CODEOWNERS in the directory in GitHub
         | 
| 101 | 
            +
                #     containing source code for the client libraries for this API.
         | 
| 102 | 
            +
                # @!attribute [rw] doc_tag_prefix
         | 
| 103 | 
            +
                #   @return [::String]
         | 
| 104 | 
            +
                #     A prefix used in sample code when demarking regions to be included in
         | 
| 105 | 
            +
                #     documentation.
         | 
| 106 | 
            +
                # @!attribute [rw] organization
         | 
| 107 | 
            +
                #   @return [::Google::Api::ClientLibraryOrganization]
         | 
| 108 | 
            +
                #     For whom the client library is being published.
         | 
| 109 | 
            +
                # @!attribute [rw] library_settings
         | 
| 110 | 
            +
                #   @return [::Array<::Google::Api::ClientLibrarySettings>]
         | 
| 111 | 
            +
                #     Client library settings.  If the same version string appears multiple
         | 
| 112 | 
            +
                #     times in this list, then the last one wins.  Settings from earlier
         | 
| 113 | 
            +
                #     settings with the same version string are discarded.
         | 
| 114 | 
            +
                class Publishing
         | 
| 115 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 116 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 117 | 
            +
                end
         | 
| 118 | 
            +
             | 
| 119 | 
            +
                # Settings for Java client libraries.
         | 
| 120 | 
            +
                # @!attribute [rw] library_package
         | 
| 121 | 
            +
                #   @return [::String]
         | 
| 122 | 
            +
                #     The package name to use in Java. Clobbers the java_package option
         | 
| 123 | 
            +
                #     set in the protobuf. This should be used **only** by APIs
         | 
| 124 | 
            +
                #     who have already set the language_settings.java.package_name" field
         | 
| 125 | 
            +
                #     in gapic.yaml. API teams should use the protobuf java_package option
         | 
| 126 | 
            +
                #     where possible.
         | 
| 127 | 
            +
                #
         | 
| 128 | 
            +
                #     Example of a YAML configuration::
         | 
| 129 | 
            +
                #
         | 
| 130 | 
            +
                #      publishing:
         | 
| 131 | 
            +
                #        java_settings:
         | 
| 132 | 
            +
                #          library_package: com.google.cloud.pubsub.v1
         | 
| 133 | 
            +
                # @!attribute [rw] service_class_names
         | 
| 134 | 
            +
                #   @return [::Google::Protobuf::Map{::String => ::String}]
         | 
| 135 | 
            +
                #     Configure the Java class name to use instead of the service's for its
         | 
| 136 | 
            +
                #     corresponding generated GAPIC client. Keys are fully-qualified
         | 
| 137 | 
            +
                #     service names as they appear in the protobuf (including the full
         | 
| 138 | 
            +
                #     the language_settings.java.interface_names" field in gapic.yaml. API
         | 
| 139 | 
            +
                #     teams should otherwise use the service name as it appears in the
         | 
| 140 | 
            +
                #     protobuf.
         | 
| 141 | 
            +
                #
         | 
| 142 | 
            +
                #     Example of a YAML configuration::
         | 
| 143 | 
            +
                #
         | 
| 144 | 
            +
                #      publishing:
         | 
| 145 | 
            +
                #        java_settings:
         | 
| 146 | 
            +
                #          service_class_names:
         | 
| 147 | 
            +
                #            - google.pubsub.v1.Publisher: TopicAdmin
         | 
| 148 | 
            +
                #            - google.pubsub.v1.Subscriber: SubscriptionAdmin
         | 
| 149 | 
            +
                # @!attribute [rw] common
         | 
| 150 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 151 | 
            +
                #     Some settings.
         | 
| 152 | 
            +
                class JavaSettings
         | 
| 153 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 154 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 155 | 
            +
             | 
| 156 | 
            +
                  # @!attribute [rw] key
         | 
| 157 | 
            +
                  #   @return [::String]
         | 
| 158 | 
            +
                  # @!attribute [rw] value
         | 
| 159 | 
            +
                  #   @return [::String]
         | 
| 160 | 
            +
                  class ServiceClassNamesEntry
         | 
| 161 | 
            +
                    include ::Google::Protobuf::MessageExts
         | 
| 162 | 
            +
                    extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 163 | 
            +
                  end
         | 
| 164 | 
            +
                end
         | 
| 165 | 
            +
             | 
| 166 | 
            +
                # Settings for C++ client libraries.
         | 
| 167 | 
            +
                # @!attribute [rw] common
         | 
| 168 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 169 | 
            +
                #     Some settings.
         | 
| 170 | 
            +
                class CppSettings
         | 
| 171 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 172 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 173 | 
            +
                end
         | 
| 174 | 
            +
             | 
| 175 | 
            +
                # Settings for Php client libraries.
         | 
| 176 | 
            +
                # @!attribute [rw] common
         | 
| 177 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 178 | 
            +
                #     Some settings.
         | 
| 179 | 
            +
                class PhpSettings
         | 
| 180 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 181 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 182 | 
            +
                end
         | 
| 183 | 
            +
             | 
| 184 | 
            +
                # Settings for Python client libraries.
         | 
| 185 | 
            +
                # @!attribute [rw] common
         | 
| 186 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 187 | 
            +
                #     Some settings.
         | 
| 188 | 
            +
                class PythonSettings
         | 
| 189 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 190 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 191 | 
            +
                end
         | 
| 192 | 
            +
             | 
| 193 | 
            +
                # Settings for Node client libraries.
         | 
| 194 | 
            +
                # @!attribute [rw] common
         | 
| 195 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 196 | 
            +
                #     Some settings.
         | 
| 197 | 
            +
                class NodeSettings
         | 
| 198 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 199 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 200 | 
            +
                end
         | 
| 201 | 
            +
             | 
| 202 | 
            +
                # Settings for Dotnet client libraries.
         | 
| 203 | 
            +
                # @!attribute [rw] common
         | 
| 204 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 205 | 
            +
                #     Some settings.
         | 
| 206 | 
            +
                class DotnetSettings
         | 
| 207 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 208 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 209 | 
            +
                end
         | 
| 210 | 
            +
             | 
| 211 | 
            +
                # Settings for Ruby client libraries.
         | 
| 212 | 
            +
                # @!attribute [rw] common
         | 
| 213 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 214 | 
            +
                #     Some settings.
         | 
| 215 | 
            +
                class RubySettings
         | 
| 216 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 217 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 218 | 
            +
                end
         | 
| 219 | 
            +
             | 
| 220 | 
            +
                # Settings for Go client libraries.
         | 
| 221 | 
            +
                # @!attribute [rw] common
         | 
| 222 | 
            +
                #   @return [::Google::Api::CommonLanguageSettings]
         | 
| 223 | 
            +
                #     Some settings.
         | 
| 224 | 
            +
                class GoSettings
         | 
| 225 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 226 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 227 | 
            +
                end
         | 
| 228 | 
            +
             | 
| 229 | 
            +
                # Describes the generator configuration for a method.
         | 
| 230 | 
            +
                # @!attribute [rw] selector
         | 
| 231 | 
            +
                #   @return [::String]
         | 
| 232 | 
            +
                #     The fully qualified name of the method, for which the options below apply.
         | 
| 233 | 
            +
                #     This is used to find the method to apply the options.
         | 
| 234 | 
            +
                # @!attribute [rw] long_running
         | 
| 235 | 
            +
                #   @return [::Google::Api::MethodSettings::LongRunning]
         | 
| 236 | 
            +
                #     Describes settings to use for long-running operations when generating
         | 
| 237 | 
            +
                #     API methods for RPCs. Complements RPCs that use the annotations in
         | 
| 238 | 
            +
                #     google/longrunning/operations.proto.
         | 
| 239 | 
            +
                #
         | 
| 240 | 
            +
                #     Example of a YAML configuration::
         | 
| 241 | 
            +
                #
         | 
| 242 | 
            +
                #      publishing:
         | 
| 243 | 
            +
                #        method_behavior:
         | 
| 244 | 
            +
                #          - selector: CreateAdDomain
         | 
| 245 | 
            +
                #            long_running:
         | 
| 246 | 
            +
                #              initial_poll_delay:
         | 
| 247 | 
            +
                #                seconds: 60 # 1 minute
         | 
| 248 | 
            +
                #              poll_delay_multiplier: 1.5
         | 
| 249 | 
            +
                #              max_poll_delay:
         | 
| 250 | 
            +
                #                seconds: 360 # 6 minutes
         | 
| 251 | 
            +
                #              total_poll_timeout:
         | 
| 252 | 
            +
                #                 seconds: 54000 # 90 minutes
         | 
| 253 | 
            +
                class MethodSettings
         | 
| 254 | 
            +
                  include ::Google::Protobuf::MessageExts
         | 
| 255 | 
            +
                  extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 256 | 
            +
             | 
| 257 | 
            +
                  # Describes settings to use when generating API methods that use the
         | 
| 258 | 
            +
                  # long-running operation pattern.
         | 
| 259 | 
            +
                  # All default values below are from those used in the client library
         | 
| 260 | 
            +
                  # generators (e.g.
         | 
| 261 | 
            +
                  # [Java](https://github.com/googleapis/gapic-generator-java/blob/04c2faa191a9b5a10b92392fe8482279c4404803/src/main/java/com/google/api/generator/gapic/composer/common/RetrySettingsComposer.java)).
         | 
| 262 | 
            +
                  # @!attribute [rw] initial_poll_delay
         | 
| 263 | 
            +
                  #   @return [::Google::Protobuf::Duration]
         | 
| 264 | 
            +
                  #     Initial delay after which the first poll request will be made.
         | 
| 265 | 
            +
                  #     Default value: 5 seconds.
         | 
| 266 | 
            +
                  # @!attribute [rw] poll_delay_multiplier
         | 
| 267 | 
            +
                  #   @return [::Float]
         | 
| 268 | 
            +
                  #     Multiplier to gradually increase delay between subsequent polls until it
         | 
| 269 | 
            +
                  #     reaches max_poll_delay.
         | 
| 270 | 
            +
                  #     Default value: 1.5.
         | 
| 271 | 
            +
                  # @!attribute [rw] max_poll_delay
         | 
| 272 | 
            +
                  #   @return [::Google::Protobuf::Duration]
         | 
| 273 | 
            +
                  #     Maximum time between two subsequent poll requests.
         | 
| 274 | 
            +
                  #     Default value: 45 seconds.
         | 
| 275 | 
            +
                  # @!attribute [rw] total_poll_timeout
         | 
| 276 | 
            +
                  #   @return [::Google::Protobuf::Duration]
         | 
| 277 | 
            +
                  #     Total polling timeout.
         | 
| 278 | 
            +
                  #     Default value: 5 minutes.
         | 
| 279 | 
            +
                  class LongRunning
         | 
| 280 | 
            +
                    include ::Google::Protobuf::MessageExts
         | 
| 281 | 
            +
                    extend ::Google::Protobuf::MessageExts::ClassMethods
         | 
| 282 | 
            +
                  end
         | 
| 283 | 
            +
                end
         | 
| 284 | 
            +
             | 
| 285 | 
            +
                # The organization for which the client libraries are being published.
         | 
| 286 | 
            +
                # Affects the url where generated docs are published, etc.
         | 
| 287 | 
            +
                module ClientLibraryOrganization
         | 
| 288 | 
            +
                  # Not useful.
         | 
| 289 | 
            +
                  CLIENT_LIBRARY_ORGANIZATION_UNSPECIFIED = 0
         | 
| 290 | 
            +
             | 
| 291 | 
            +
                  # Google Cloud Platform Org.
         | 
| 292 | 
            +
                  CLOUD = 1
         | 
| 293 | 
            +
             | 
| 294 | 
            +
                  # Ads (Advertising) Org.
         | 
| 295 | 
            +
                  ADS = 2
         | 
| 296 | 
            +
             | 
| 297 | 
            +
                  # Photos Org.
         | 
| 298 | 
            +
                  PHOTOS = 3
         | 
| 299 | 
            +
             | 
| 300 | 
            +
                  # Street View Org.
         | 
| 301 | 
            +
                  STREET_VIEW = 4
         | 
| 302 | 
            +
                end
         | 
| 303 | 
            +
             | 
| 304 | 
            +
                # To where should client libraries be published?
         | 
| 305 | 
            +
                module ClientLibraryDestination
         | 
| 306 | 
            +
                  # Client libraries will neither be generated nor published to package
         | 
| 307 | 
            +
                  # managers.
         | 
| 308 | 
            +
                  CLIENT_LIBRARY_DESTINATION_UNSPECIFIED = 0
         | 
| 309 | 
            +
             | 
| 310 | 
            +
                  # Generate the client library in a repo under github.com/googleapis,
         | 
| 311 | 
            +
                  # but don't publish it to package managers.
         | 
| 312 | 
            +
                  GITHUB = 10
         | 
| 313 | 
            +
             | 
| 314 | 
            +
                  # Publish the library to package managers like nuget.org and npmjs.com.
         | 
| 315 | 
            +
                  PACKAGE_MANAGER = 20
         | 
| 316 | 
            +
                end
         | 
| 317 | 
            +
              end
         | 
| 318 | 
            +
            end
         |