ruby-gemini-api 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42b86546e154705767e40dad92410df0e1be21e335ae95630d8c2213f42a8a04
-  data.tar.gz: ea10d1a8c13bf0c49ccd720c9e1c25494b9c9a4955879b15e20c2722d5f8f712
+  metadata.gz: c80fbf2cb7142ab3ff7d6a17d8b5f1e43960ec8ed398ee7f4c35286ed72ce962
+  data.tar.gz: 261f1a1e04757b93aac9c8a42263e355758bba4ec512f6c9dd408b63146e17fe
 SHA512:
-  metadata.gz: 778b3de54c33818cb7d8fc6f2adc6e3876b5db4ef6dae3c9c1e1ad0db429c4b9c3225ae0518545feaba441cea212fbff0843ee72fe095c73f5fbc3b0c3a37862
-  data.tar.gz: 07cfd038ac791757e11ea1784ba48760fd3b292b6cb5edf8434930dcd4815da89431259ca9359718dc665117630d82d70852f934ef1644130d92666d0c504e12
+  metadata.gz: 780a9684677d9bfdd8945727c9cd00e1e0ecc9e43a63a038da17a18aa8e524e43f601946bd1fbc00c9406e4a45b80d59fedfdfc85e190b973cedd9c2340a5be4
+  data.tar.gz: 399dff8bc6f6693b6267412b2fee067269125ea9b16ffd105d94b4ac9154ca1ade4246b6d3ca9aa9e7cb689e3f2d4a12ea771d4fc688de24e36688205675ab0f

data/CHANGELOG.md

@@ -10,4 +10,7 @@
 - Add function calling
 
 ## [0.1.3] - 2025-10-09
-- Add support for multi-image input
+- Add support for multi-image input
+
+## [0.1.4] - 2025-11-08
+- Add support for grounding search

data/README.md

@@ -272,6 +272,79 @@ client.files.delete(name: file_name)
 
 For more examples, check out the `demo/vision_demo.rb` and `demo/file_vision_demo.rb` files included with the gem.
 
+### Grounding with Google Search
+
+You can use Gemini API's Google Search grounding feature to retrieve real-time information.
+
+#### Basic Usage
+
+```ruby
+require 'gemini'
+
+client = Gemini::Client.new(ENV['GEMINI_API_KEY'])
+
+# Use Google Search to get real-time information
+response = client.generate_content(
+  "Who won the euro 2024?",
+  model: "gemini-2.0-flash-lite",
+  tools: [{ google_search: {} }]
+)
+
+if response.success?
+  puts response.text
+  
+  # Check grounding information
+  if response.grounded?
+    puts "\nSource references:"
+    response.grounding_chunks.each do |chunk|
+      if chunk['web']
+        puts "- #{chunk['web']['title']}"
+        puts "  #{chunk['web']['uri']}"
+      end
+    end
+  end
+end
+```
+
+#### Checking Grounding Metadata
+
+```ruby
+# Check if response is grounded
+if response.grounded?
+  # Get full grounding metadata
+  metadata = response.grounding_metadata
+  
+  # Get source chunks (references)
+  chunks = response.grounding_chunks
+  
+  # Get search entry point
+  entry_point = response.search_entry_point
+end
+```
+
+#### Example with Different Topics
+
+```ruby
+response = client.generate_content(
+  "What are the latest AI developments in 2024?",
+  model: "gemini-2.0-flash-lite",
+  tools: [{ google_search: {} }]
+)
+
+if response.success? && response.grounded?
+  puts response.text
+  puts "\nSources: #{response.grounding_chunks.length} references"
+end
+```
+
+#### Demo Application
+
+You can find a grounding search demo in:
+
+```bash
+ruby demo/grounding_search_demo_ja.rb
+```
+
 ### Image Generation
 
 ```ruby

data/lib/gemini/response.rb

@@ -99,6 +99,27 @@ module Gemini
     def safety_blocked?
       finish_reason == "SAFETY"
     end
+
+    # Get grounding metadata (for Google Search grounding)
+    def grounding_metadata
+      first_candidate&.dig("groundingMetadata")
+    end
+
+    # Check if response has grounding metadata
+    def grounded?
+      !grounding_metadata.nil? && !grounding_metadata.empty?
+    end
+
+    # Get grounding chunks (source references)
+    def grounding_chunks
+      grounding_metadata&.dig("groundingChunks") || []
+    end
+
+    # Get search entry point URL (if available)
+    def search_entry_point
+      grounding_metadata&.dig("searchEntryPoint", "renderedContent")
+    end
+    
     
     # Get token usage information
     def usage

data/lib/gemini/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gemini
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-gemini-api
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - rira100000000
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-09 00:00:00.000000000 Z
+date: 2025-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday