grafeas-v1 0.2.1 → 0.4.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]
@@ -78,26 +77,17 @@ module Grafeas
 
             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
-        #
-        # To 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
+        # @example
+        #
+        #   # 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
+        #
+        #   # 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.