grafeas-v1 0.1.4 → 0.3.0

data/lib/grafeas/v1/grafeas/client.rb

@@ -52,13 +52,12 @@ module Grafeas
         # See {::Grafeas::V1::Grafeas::Client::Configuration}
         # for a description of the configuration fields.
         #
-        # ## Example
+        # @example
         #
-        # To modify the configuration for all Grafeas clients:
-        #
-        #     ::Grafeas::V1::Grafeas::Client.configure do |config|
-        #       config.timeout = 10.0
-        #     end
+        #   # Modify the configuration for all Grafeas clients
+        #   ::Grafeas::V1::Grafeas::Client.configure do |config|
+        #     config.timeout = 10.0
+        #   end
         #
         # @yield [config] Configure the Client client.
         # @yieldparam config [Client::Configuration]
@@ -71,33 +70,24 @@ module Grafeas
             parent_config = while namespace.any?
                               parent_name = namespace.join "::"
                               parent_const = const_get parent_name
-                              break parent_const.configure if parent_const&.respond_to? :configure
+                              break parent_const.configure if parent_const.respond_to? :configure
                               namespace.pop
                             end
             default_config = Client::Configuration.new parent_config
 
             default_config.rpcs.get_occurrence.timeout = 30.0
             default_config.rpcs.get_occurrence.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config.rpcs.list_occurrences.timeout = 30.0
             default_config.rpcs.list_occurrences.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config.rpcs.delete_occurrence.timeout = 30.0
             default_config.rpcs.delete_occurrence.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config.rpcs.create_occurrence.timeout = 30.0
@@ -108,34 +98,22 @@ module Grafeas
 
             default_config.rpcs.get_occurrence_note.timeout = 30.0
             default_config.rpcs.get_occurrence_note.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config.rpcs.get_note.timeout = 30.0
             default_config.rpcs.get_note.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config.rpcs.list_notes.timeout = 30.0
             default_config.rpcs.list_notes.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config.rpcs.delete_note.timeout = 30.0
             default_config.rpcs.delete_note.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config.rpcs.create_note.timeout = 30.0
@@ -146,10 +124,7 @@ module Grafeas
 
             default_config.rpcs.list_note_occurrences.timeout = 30.0
             default_config.rpcs.list_note_occurrences.retry_policy = {
-              initial_delay: 0.1,
-              max_delay:     60.0,
-              multiplier:    1.3,
-              retry_codes:   [14, 4]
+              initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
             }
 
             default_config
@@ -181,19 +156,15 @@ module Grafeas
         ##
         # Create a new Grafeas client object.
         #
-        # ## Examples
-        #
-        # To create a new Grafeas client with the default
-        # configuration:
+        # @example
         #
-        #     client = ::Grafeas::V1::Grafeas::Client.new
+        #   # Create a client using the default configuration
+        #   client = ::Grafeas::V1::Grafeas::Client.new
         #
-        # To create a new Grafeas client with a custom
-        # configuration:
-        #
-        #     client = ::Grafeas::V1::Grafeas::Client.new do |config|
-        #       config.timeout = 10.0
-        #     end
+        #   # Create a client using a custom configuration
+        #   client = ::Grafeas::V1::Grafeas::Client.new do |config|
+        #     config.timeout = 10.0
+        #   end
         #
         # @yield [config] Configure the Grafeas client.
         # @yieldparam config [Client::Configuration]
@@ -257,6 +228,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::GetOccurrenceRequest.new
+        #
+        #   # Call the get_occurrence method.
+        #   result = client.get_occurrence request
+        #
+        #   # The returned object is of type Grafeas::V1::Occurrence.
+        #   p result
+        #
         def get_occurrence request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -274,16 +260,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.get_occurrence.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.get_occurrence.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :get_occurrence, request, options: options do |response, operation|
@@ -331,6 +321,27 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::ListOccurrencesRequest.new
+        #
+        #   # Call the list_occurrences method.
+        #   result = client.list_occurrences request
+        #
+        #   # The returned object is of type Gapic::PagedEnumerable. You can
+        #   # iterate over all elements by calling #each, and the enumerable
+        #   # will lazily make API calls to fetch subsequent pages. Other
+        #   # methods are also available for managing paging directly.
+        #   result.each do |response|
+        #     # Each element is of type ::Grafeas::V1::Occurrence.
+        #     p response
+        #   end
+        #
         def list_occurrences request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -348,16 +359,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "parent" => request.parent
-          }
+          header_params = {}
+          if request.parent
+            header_params["parent"] = request.parent
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.list_occurrences.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.list_occurrences.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :list_occurrences, request, options: options do |response, operation|
@@ -401,6 +416,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::DeleteOccurrenceRequest.new
+        #
+        #   # Call the delete_occurrence method.
+        #   result = client.delete_occurrence request
+        #
+        #   # The returned object is of type Google::Protobuf::Empty.
+        #   p result
+        #
         def delete_occurrence request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -418,16 +448,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.delete_occurrence.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.delete_occurrence.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :delete_occurrence, request, options: options do |response, operation|
@@ -470,6 +504,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::CreateOccurrenceRequest.new
+        #
+        #   # Call the create_occurrence method.
+        #   result = client.create_occurrence request
+        #
+        #   # The returned object is of type Grafeas::V1::Occurrence.
+        #   p result
+        #
         def create_occurrence request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -487,16 +536,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "parent" => request.parent
-          }
+          header_params = {}
+          if request.parent
+            header_params["parent"] = request.parent
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.create_occurrence.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.create_occurrence.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :create_occurrence, request, options: options do |response, operation|
@@ -539,6 +592,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::BatchCreateOccurrencesRequest.new
+        #
+        #   # Call the batch_create_occurrences method.
+        #   result = client.batch_create_occurrences request
+        #
+        #   # The returned object is of type Grafeas::V1::BatchCreateOccurrencesResponse.
+        #   p result
+        #
         def batch_create_occurrences request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -556,16 +624,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "parent" => request.parent
-          }
+          header_params = {}
+          if request.parent
+            header_params["parent"] = request.parent
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.batch_create_occurrences.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.batch_create_occurrences.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :batch_create_occurrences, request, options: options do |response, operation|
@@ -610,6 +682,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::UpdateOccurrenceRequest.new
+        #
+        #   # Call the update_occurrence method.
+        #   result = client.update_occurrence request
+        #
+        #   # The returned object is of type Grafeas::V1::Occurrence.
+        #   p result
+        #
         def update_occurrence request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -627,16 +714,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.update_occurrence.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.update_occurrence.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :update_occurrence, request, options: options do |response, operation|
@@ -678,6 +769,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::GetOccurrenceNoteRequest.new
+        #
+        #   # Call the get_occurrence_note method.
+        #   result = client.get_occurrence_note request
+        #
+        #   # The returned object is of type Grafeas::V1::Note.
+        #   p result
+        #
         def get_occurrence_note request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -695,16 +801,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.get_occurrence_note.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.get_occurrence_note.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :get_occurrence_note, request, options: options do |response, operation|
@@ -745,6 +855,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::GetNoteRequest.new
+        #
+        #   # Call the get_note method.
+        #   result = client.get_note request
+        #
+        #   # The returned object is of type Grafeas::V1::Note.
+        #   p result
+        #
         def get_note request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -762,16 +887,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.get_note.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.get_note.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :get_note, request, options: options do |response, operation|
@@ -819,6 +948,27 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::ListNotesRequest.new
+        #
+        #   # Call the list_notes method.
+        #   result = client.list_notes request
+        #
+        #   # The returned object is of type Gapic::PagedEnumerable. You can
+        #   # iterate over all elements by calling #each, and the enumerable
+        #   # will lazily make API calls to fetch subsequent pages. Other
+        #   # methods are also available for managing paging directly.
+        #   result.each do |response|
+        #     # Each element is of type ::Grafeas::V1::Note.
+        #     p response
+        #   end
+        #
         def list_notes request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -836,16 +986,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "parent" => request.parent
-          }
+          header_params = {}
+          if request.parent
+            header_params["parent"] = request.parent
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.list_notes.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.list_notes.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :list_notes, request, options: options do |response, operation|
@@ -887,6 +1041,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::DeleteNoteRequest.new
+        #
+        #   # Call the delete_note method.
+        #   result = client.delete_note request
+        #
+        #   # The returned object is of type Google::Protobuf::Empty.
+        #   p result
+        #
         def delete_note request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -904,16 +1073,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.delete_note.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.delete_note.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :delete_note, request, options: options do |response, operation|
@@ -958,6 +1131,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::CreateNoteRequest.new
+        #
+        #   # Call the create_note method.
+        #   result = client.create_note request
+        #
+        #   # The returned object is of type Grafeas::V1::Note.
+        #   p result
+        #
         def create_note request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -975,16 +1163,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "parent" => request.parent
-          }
+          header_params = {}
+          if request.parent
+            header_params["parent"] = request.parent
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.create_note.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.create_note.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :create_note, request, options: options do |response, operation|
@@ -1027,6 +1219,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::BatchCreateNotesRequest.new
+        #
+        #   # Call the batch_create_notes method.
+        #   result = client.batch_create_notes request
+        #
+        #   # The returned object is of type Grafeas::V1::BatchCreateNotesResponse.
+        #   p result
+        #
         def batch_create_notes request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1044,16 +1251,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "parent" => request.parent
-          }
+          header_params = {}
+          if request.parent
+            header_params["parent"] = request.parent
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.batch_create_notes.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.batch_create_notes.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :batch_create_notes, request, options: options do |response, operation|
@@ -1098,6 +1309,21 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::UpdateNoteRequest.new
+        #
+        #   # Call the update_note method.
+        #   result = client.update_note request
+        #
+        #   # The returned object is of type Grafeas::V1::Note.
+        #   p result
+        #
         def update_note request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1115,16 +1341,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.update_note.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.update_note.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :update_note, request, options: options do |response, operation|
@@ -1173,6 +1403,27 @@ module Grafeas
         #
         # @raise [::Google::Cloud::Error] if the RPC is aborted.
         #
+        # @example Basic example
+        #   require "grafeas/v1"
+        #
+        #   # Create a client object. The client can be reused for multiple calls.
+        #   client = Grafeas::V1::Grafeas::Client.new
+        #
+        #   # Create a request. To set request fields, pass in keyword arguments.
+        #   request = Grafeas::V1::ListNoteOccurrencesRequest.new
+        #
+        #   # Call the list_note_occurrences method.
+        #   result = client.list_note_occurrences request
+        #
+        #   # The returned object is of type Gapic::PagedEnumerable. You can
+        #   # iterate over all elements by calling #each, and the enumerable
+        #   # will lazily make API calls to fetch subsequent pages. Other
+        #   # methods are also available for managing paging directly.
+        #   result.each do |response|
+        #     # Each element is of type ::Grafeas::V1::Occurrence.
+        #     p response
+        #   end
+        #
         def list_note_occurrences request, options = nil
           raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1190,16 +1441,20 @@ module Grafeas
             gapic_version: ::Grafeas::V1::VERSION
           metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-          header_params = {
-            "name" => request.name
-          }
+          header_params = {}
+          if request.name
+            header_params["name"] = request.name
+          end
+
           request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
           metadata[:"x-goog-request-params"] ||= request_params_header
 
           options.apply_defaults timeout:      @config.rpcs.list_note_occurrences.timeout,
                                  metadata:     metadata,
                                  retry_policy: @config.rpcs.list_note_occurrences.retry_policy
-          options.apply_defaults metadata:     @config.metadata,
+
+          options.apply_defaults timeout:      @config.timeout,
+                                 metadata:     @config.metadata,
                                  retry_policy: @config.retry_policy
 
           @grafeas_stub.call_rpc :list_note_occurrences, request, options: options do |response, operation|
@@ -1224,22 +1479,21 @@ module Grafeas
         # Configuration can be applied globally to all clients, or to a single client
         # on construction.
         #
-        # # Examples
-        #
-        # To modify the global config, setting the timeout for get_occurrence
-        # to 20 seconds, and all remaining timeouts to 10 seconds:
-        #
-        #     ::Grafeas::V1::Grafeas::Client.configure do |config|
-        #       config.timeout = 10.0
-        #       config.rpcs.get_occurrence.timeout = 20.0
-        #     end
+        # @example
         #
-        # To apply the above configuration only to a new client:
+        #   # Modify the global config, setting the timeout for
+        #   # get_occurrence to 20 seconds,
+        #   # and all remaining timeouts to 10 seconds.
+        #   ::Grafeas::V1::Grafeas::Client.configure do |config|
+        #     config.timeout = 10.0
+        #     config.rpcs.get_occurrence.timeout = 20.0
+        #   end
         #
-        #     client = ::Grafeas::V1::Grafeas::Client.new do |config|
-        #       config.timeout = 10.0
-        #       config.rpcs.get_occurrence.timeout = 20.0
-        #     end
+        #   # Apply the above configuration only to a new client.
+        #   client = ::Grafeas::V1::Grafeas::Client.new do |config|
+        #     config.timeout = 10.0
+        #     config.rpcs.get_occurrence.timeout = 20.0
+        #   end
         #
         # @!attribute [rw] endpoint
         #   The hostname or hostname:port of the service endpoint.
@@ -1303,7 +1557,7 @@ module Grafeas
           config_attr :scope,         nil, ::String, ::Array, nil
           config_attr :lib_name,      nil, ::String, nil
           config_attr :lib_version,   nil, ::String, nil
-          config_attr(:channel_args,  { "grpc.service_config_disable_resolution"=>1 }, ::Hash, nil)
+          config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
           config_attr :interceptors,  nil, ::Array, nil
           config_attr :timeout,       nil, ::Numeric, nil
           config_attr :metadata,      nil, ::Hash, nil
@@ -1324,7 +1578,7 @@ module Grafeas
           def rpcs
             @rpcs ||= begin
               parent_rpcs = nil
-              parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
+              parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
               Rpcs.new parent_rpcs
             end
           end
@@ -1420,33 +1674,33 @@ module Grafeas
 
             # @private
             def initialize parent_rpcs = nil
-              get_occurrence_config = parent_rpcs&.get_occurrence if parent_rpcs&.respond_to? :get_occurrence
+              get_occurrence_config = parent_rpcs.get_occurrence if parent_rpcs.respond_to? :get_occurrence
               @get_occurrence = ::Gapic::Config::Method.new get_occurrence_config
-              list_occurrences_config = parent_rpcs&.list_occurrences if parent_rpcs&.respond_to? :list_occurrences
+              list_occurrences_config = parent_rpcs.list_occurrences if parent_rpcs.respond_to? :list_occurrences
               @list_occurrences = ::Gapic::Config::Method.new list_occurrences_config
-              delete_occurrence_config = parent_rpcs&.delete_occurrence if parent_rpcs&.respond_to? :delete_occurrence
+              delete_occurrence_config = parent_rpcs.delete_occurrence if parent_rpcs.respond_to? :delete_occurrence
               @delete_occurrence = ::Gapic::Config::Method.new delete_occurrence_config
-              create_occurrence_config = parent_rpcs&.create_occurrence if parent_rpcs&.respond_to? :create_occurrence
+              create_occurrence_config = parent_rpcs.create_occurrence if parent_rpcs.respond_to? :create_occurrence
               @create_occurrence = ::Gapic::Config::Method.new create_occurrence_config
-              batch_create_occurrences_config = parent_rpcs&.batch_create_occurrences if parent_rpcs&.respond_to? :batch_create_occurrences
+              batch_create_occurrences_config = parent_rpcs.batch_create_occurrences if parent_rpcs.respond_to? :batch_create_occurrences
               @batch_create_occurrences = ::Gapic::Config::Method.new batch_create_occurrences_config
-              update_occurrence_config = parent_rpcs&.update_occurrence if parent_rpcs&.respond_to? :update_occurrence
+              update_occurrence_config = parent_rpcs.update_occurrence if parent_rpcs.respond_to? :update_occurrence
               @update_occurrence = ::Gapic::Config::Method.new update_occurrence_config
-              get_occurrence_note_config = parent_rpcs&.get_occurrence_note if parent_rpcs&.respond_to? :get_occurrence_note
+              get_occurrence_note_config = parent_rpcs.get_occurrence_note if parent_rpcs.respond_to? :get_occurrence_note
               @get_occurrence_note = ::Gapic::Config::Method.new get_occurrence_note_config
-              get_note_config = parent_rpcs&.get_note if parent_rpcs&.respond_to? :get_note
+              get_note_config = parent_rpcs.get_note if parent_rpcs.respond_to? :get_note
               @get_note = ::Gapic::Config::Method.new get_note_config
-              list_notes_config = parent_rpcs&.list_notes if parent_rpcs&.respond_to? :list_notes
+              list_notes_config = parent_rpcs.list_notes if parent_rpcs.respond_to? :list_notes
               @list_notes = ::Gapic::Config::Method.new list_notes_config
-              delete_note_config = parent_rpcs&.delete_note if parent_rpcs&.respond_to? :delete_note
+              delete_note_config = parent_rpcs.delete_note if parent_rpcs.respond_to? :delete_note
               @delete_note = ::Gapic::Config::Method.new delete_note_config
-              create_note_config = parent_rpcs&.create_note if parent_rpcs&.respond_to? :create_note
+              create_note_config = parent_rpcs.create_note if parent_rpcs.respond_to? :create_note
               @create_note = ::Gapic::Config::Method.new create_note_config
-              batch_create_notes_config = parent_rpcs&.batch_create_notes if parent_rpcs&.respond_to? :batch_create_notes
+              batch_create_notes_config = parent_rpcs.batch_create_notes if parent_rpcs.respond_to? :batch_create_notes
               @batch_create_notes = ::Gapic::Config::Method.new batch_create_notes_config
-              update_note_config = parent_rpcs&.update_note if parent_rpcs&.respond_to? :update_note
+              update_note_config = parent_rpcs.update_note if parent_rpcs.respond_to? :update_note
               @update_note = ::Gapic::Config::Method.new update_note_config
-              list_note_occurrences_config = parent_rpcs&.list_note_occurrences if parent_rpcs&.respond_to? :list_note_occurrences
+              list_note_occurrences_config = parent_rpcs.list_note_occurrences if parent_rpcs.respond_to? :list_note_occurrences
               @list_note_occurrences = ::Gapic::Config::Method.new list_note_occurrences_config
 
               yield self if block_given?