Gemini API

Gemini Interactions API เป็น API เวอร์ชันทดลองที่ช่วยให้นักพัฒนาซอฟต์แวร์สร้างแอปพลิเคชัน Generative AI โดยใช้โมเดล Gemini ได้ Gemini เป็นโมเดลที่มีความสามารถมากที่สุดของเรา ซึ่งสร้างขึ้นมาใหม่ให้ทำงานกับข้อมูลหลายรูปแบบ สามารถสรุปและทำความเข้าใจ ทำงานท่ามกลางความหลากของข้อมูล และรวมข้อมูลประเภทต่างๆ เข้าด้วยกันได้อย่างราบรื่น ทั้งภาษา รูปภาพ เสียง วิดีโอ และโค้ด คุณสามารถใช้ Gemini API สำหรับ Use Case ต่างๆ เช่น การให้เหตุผลในข้อความและรูปภาพ การสร้างเนื้อหา เอเจนต์โต้ตอบ ระบบสรุปและจัดประเภท และอื่นๆ

ดูเป็นมาร์กดาวน์ ดูข้อกำหนด OpenAPI

การสร้างการโต้ตอบ

post https://generativelanguage.googleapis.com/v1beta/interactions

สร้างการโต้ตอบใหม่

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

model ModelOption  (ไม่บังคับ)

ชื่อของ `Model` ที่ใช้ในการสร้างการโต้ตอบ
ต้องระบุหากไม่ได้ระบุ `agent`

ค่าที่เป็นไปได้ มีดังนี้

  • gemini-2.5-flash

    โมเดลการให้เหตุผลแบบไฮบริดรุ่นแรกของเราซึ่งรองรับหน้าต่างบริบทขนาด 1 ล้านโทเค็นและมีงบประมาณสำหรับการคิด

  • gemini-2.5-flash-image

    โมเดลการสร้างรูปภาพในตัวของเราได้รับการเพิ่มประสิทธิภาพเพื่อความเร็ว ความยืดหยุ่น และความเข้าใจบริบท ระบบจะคิดราคาอินพุตและเอาต์พุตข้อความเหมือนกับ 2.5 Flash

  • gemini-2.5-flash-lite

    โมเดลที่มีขนาดเล็กที่สุดและคุ้มค่าที่สุดของเรา สร้างขึ้นเพื่อการใช้งานในวงกว้าง

  • gemini-2.5-flash-lite-preview-09-2025

    โมเดลล่าสุดที่อิงตาม Gemini 2.5 Flash lite ซึ่งได้รับการเพิ่มประสิทธิภาพเพื่อความคุ้มค่า ปริมาณงานสูง และคุณภาพสูง

  • gemini-2.5-flash-native-audio-preview-12-2025

    โมเดลเสียงดั้งเดิมของเราได้รับการเพิ่มประสิทธิภาพเพื่อเอาต์พุตเสียงคุณภาพสูงขึ้น โดยมีจังหวะที่ดีขึ้น ความเป็นธรรมชาติของเสียง ความละเอียด และอารมณ์

  • gemini-2.5-flash-preview-09-2025

    โมเดลล่าสุดที่อิงตามโมเดล 2.5 Flash 2.5 Flash Preview เหมาะที่สุดสำหรับการประมวลผลขนาดใหญ่ งานที่มีเวลาในการตอบสนองต่ำและมีปริมาณมากซึ่งต้องใช้ความคิด และกรณีการใช้งานแบบเอเจนต์

  • gemini-2.5-flash-preview-tts

    โมเดลข้อความเป็นคำพูด 2.5 Flash ของเราได้รับการเพิ่มประสิทธิภาพเพื่อการสร้างคำพูดที่ควบคุมได้ซึ่งมีประสิทธิภาพและมีความหน่วงต่ำ

  • gemini-2.5-pro

    โมเดลอเนกประสงค์ที่ล้ำสมัยของเรา ซึ่งโดดเด่นในด้านการเขียนโค้ดและงานการให้เหตุผลที่ซับซ้อน

  • gemini-2.5-pro-preview-tts

    โมเดลเสียงอ่านออกเสียงข้อความ 2.5 Pro ของเราได้รับการเพิ่มประสิทธิภาพเพื่อการสร้างเสียงพูดที่ทรงพลังและมีเวลาในการตอบสนองต่ำ เพื่อให้ได้ผลลัพธ์ที่เป็นธรรมชาติมากขึ้นและควบคุมพรอมต์ได้ง่ายขึ้น

  • gemini-3-flash-preview

    โมเดลที่ชาญฉลาดที่สุดของเราสร้างขึ้นเพื่อเน้นความเร็ว โดยผสานความชาญฉลาดระดับแนวหน้าเข้ากับการค้นหาและการอ้างอิงที่เหนือกว่า

  • gemini-3-pro-image-preview

    โมเดลการสร้างและแก้ไขรูปภาพที่ล้ำสมัย

  • gemini-3-pro-preview

    โมเดลที่ชาญฉลาดที่สุดของเราซึ่งมีการให้เหตุผลและทำความเข้าใจข้อมูลหลายรูปแบบระดับ SOTA รวมถึงความสามารถในการเขียนโค้ดแบบเป็น Agent และการเขียนโค้ดที่สร้างความรู้สึกที่ทรงพลัง

  • gemini-3.1-pro-preview

    โมเดลการให้เหตุผล SOTA ล่าสุดของเราที่มีความลึกซึ้งและเฉดสีที่ไม่เคยมีมาก่อน รวมถึงความสามารถในการทำความเข้าใจข้อมูลหลายรูปแบบและการเขียนโค้ดที่ทรงพลัง

  • gemini-3.1-flash-image-preview

    ความสามารถด้านภาพระดับมืออาชีพที่มีประสิทธิภาพระดับ Flash และความสามารถในการสร้างที่อิงตามความเป็นจริง

โมเดลที่จะเติมข้อความพรอมต์ของคุณ\n\nดูรายละเอียดเพิ่มเติมได้ที่ [models](https://ai.google.dev/gemini-api/docs/models)

agent AgentOption  (ไม่บังคับ)

ชื่อของ `Agent` ที่ใช้สร้างการโต้ตอบ
ต้องระบุหากไม่ได้ระบุ `model`

ค่าที่เป็นไปได้ มีดังนี้

  • deep-research-pro-preview-12-2025

    เอเจนต์ Deep Research ของ Gemini

ตัวแทนที่จะโต้ตอบด้วย

input Content หรืออาร์เรย์ (Content) หรืออาร์เรย์ (Turn) หรือสตริง  (ต้องระบุ)

อินพุตสำหรับการโต้ตอบ (ใช้ได้ทั้งโมเดลและเอเจนต์)

system_instruction string  (ไม่บังคับ)

คำสั่งของระบบสำหรับการโต้ตอบ

เครื่องมือ อาร์เรย์ (เครื่องมือ)  (ไม่บังคับ)

รายการการประกาศเครื่องมือที่โมเดลอาจเรียกใช้ระหว่างการโต้ตอบ

response_format object  (ไม่บังคับ)

บังคับให้การตอบกลับที่สร้างขึ้นเป็นออบเจ็กต์ JSON ที่เป็นไปตาม รูปแบบ JSON ที่ระบุในฟิลด์นี้

response_mime_type string  (ไม่บังคับ)

ประเภท MIME ของการตอบกลับ ต้องระบุหากตั้งค่า response_format

stream boolean  (ไม่บังคับ)

อินพุตเท่านั้น จะมีการสตรีมการโต้ตอบหรือไม่

store boolean  (ไม่บังคับ)

อินพุตเท่านั้น ว่าจะจัดเก็บคำตอบและคำขอเพื่อเรียกข้อมูลในภายหลังหรือไม่

background boolean  (ไม่บังคับ)

อินพุตเท่านั้น ว่าจะเรียกใช้การโต้ตอบกับโมเดลในเบื้องหลังหรือไม่

generation_config GenerationConfig  (ไม่บังคับ)

การกำหนดค่าโมเดล
พารามิเตอร์การกำหนดค่าสำหรับการโต้ตอบกับโมเดล
ทางเลือกแทน `agent_config` ใช้ได้เฉพาะเมื่อตั้งค่า `model`

พารามิเตอร์การกำหนดค่าสำหรับการโต้ตอบกับโมเดล

ช่อง

temperature number  (ไม่บังคับ)

ควบคุมความสุ่มของเอาต์พุต

top_p number  (ไม่บังคับ)

ความน่าจะเป็นสะสมสูงสุดของโทเค็นที่ต้องพิจารณาเมื่อทำการสุ่มตัวอย่าง

seed integer  (ไม่บังคับ)

Seed ที่ใช้ในการถอดรหัสเพื่อความสามารถในการทำซ้ำ

stop_sequences array (string)  (ไม่บังคับ)

รายการลำดับอักขระที่จะหยุดการโต้ตอบเอาต์พุต

thinking_level ThinkingLevel  (ไม่บังคับ)

ระดับโทเค็นความคิดที่โมเดลควรสร้าง

ค่าที่เป็นไปได้ มีดังนี้

  • minimal
  • low
  • medium
  • high

thinking_summaries ThinkingSummaries  (ไม่บังคับ)

จะรวมสรุปความคิดในคำตอบหรือไม่

ค่าที่เป็นไปได้ มีดังนี้

  • auto
  • none

max_output_tokens integer  (ไม่บังคับ)

จำนวนโทเค็นสูงสุดที่จะรวมไว้ในการตอบกลับ

speech_config SpeechConfig  (ไม่บังคับ)

การกำหนดค่าสำหรับการโต้ตอบด้วยเสียง

การกำหนดค่าสำหรับการโต้ตอบด้วยคำพูด

ช่อง

เสียง สตริง  (ไม่บังคับ)

เสียงของผู้พูด

language string  (ไม่บังคับ)

ภาษาของคำพูด

speaker string  (ไม่บังคับ)

ชื่อผู้พูดควรตรงกับชื่อผู้พูดที่ระบุในพรอมต์

image_config ImageConfig  (ไม่บังคับ)

การกำหนดค่าสำหรับการโต้ตอบกับรูปภาพ

การกำหนดค่าสำหรับการโต้ตอบกับรูปภาพ

ช่อง

aspect_ratio enum (string)  (ไม่บังคับ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • 1:1
  • 2:3
  • 3:2
  • 3:4
  • 4:3
  • 4:5
  • 5:4
  • 9:16
  • 16:9
  • 21:9
  • 1:8
  • 8:1
  • 1:4
  • 4:1
image_size enum (string)  (ไม่บังคับ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • 1K
  • 2K
  • 4K
  • 512
tool_choice ToolChoiceConfig หรือ ToolChoiceType  (ไม่บังคับ)

เครื่องมือที่เลือกใช้สำหรับการโต้ตอบ

agent_config object  (ไม่บังคับ)

การกำหนดค่า Agent
การกำหนดค่าสำหรับ Agent
ทางเลือกแทน `generation_config` ใช้ได้เฉพาะเมื่อตั้งค่า `agent`

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

DynamicAgentConfig

การกำหนดค่าสำหรับเอเจนต์แบบไดนามิก

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "dynamic" เสมอ

DeepResearchAgentConfig

การกำหนดค่าสำหรับตัวแทน Deep Research

thinking_summaries ThinkingSummaries  (ไม่บังคับ)

จะรวมสรุปความคิดในคำตอบหรือไม่

ค่าที่เป็นไปได้ มีดังนี้

  • auto
  • none

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "deep-research" เสมอ

previous_interaction_id string  (ไม่บังคับ)

รหัสของการโต้ตอบก่อนหน้า (หากมี)

response_modalities ResponseModality  (ไม่บังคับ)

รูปแบบการตอบกลับที่ขอ (TEXT, IMAGE, AUDIO)

ค่าที่เป็นไปได้ มีดังนี้

  • text
  • image
  • audio

การตอบกลับ

แสดงผลทรัพยากร Interaction

คำขอแบบง่าย

ตัวอย่างการตอบกลับ

{
  "created": "2025-11-26T12:25:15Z",
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm functioning perfectly and ready to assist you.\n\nHow are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-11-26T12:25:15Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tokens": 49,
    "total_tool_use_tokens": 0
  }
}

หลายรอบ

ตัวอย่างการตอบกลับ

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "The capital of France is Paris."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 50
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 50,
    "total_output_tokens": 10,
    "total_thought_tokens": 0,
    "total_tokens": 60,
    "total_tool_use_tokens": 0
  }
}

อินพุตรูปภาพ

ตัวอย่างการตอบกลับ

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "A white humanoid robot with glowing blue eyes stands holding a red skateboard."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 10
      },
      {
        "modality": "image",
        "tokens": 258
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 268,
    "total_output_tokens": 20,
    "total_thought_tokens": 0,
    "total_tokens": 288,
    "total_tool_use_tokens": 0
  }
}

การเรียกใช้ฟังก์ชัน

ตัวอย่างการตอบกลับ

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "requires_action",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "model",
  "outputs": [
    {
      "type": "function_call",
      "id": "gth23981",
      "name": "get_weather",
      "arguments": {
        "location": "Boston, MA"
      }
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 100
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 100,
    "total_output_tokens": 25,
    "total_thought_tokens": 0,
    "total_tokens": 125,
    "total_tool_use_tokens": 50
  }
}

Deep Research

ตัวอย่างการตอบกลับ

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:22:47Z",
  "updated": "2025-11-26T12:22:47Z",
  "role": "agent",
  "outputs": [
    {
      "type": "text",
      "text": "Here is a comprehensive research report on the current state of cancer research..."
    }
  ],
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 20
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 20,
    "total_output_tokens": 1000,
    "total_thought_tokens": 500,
    "total_tokens": 1520,
    "total_tool_use_tokens": 0
  }
}

การดึงข้อมูลการโต้ตอบ

get https://generativelanguage.googleapis.com/v1beta/interactions/{id}

เรียกข้อมูลแบบละเอียดทั้งหมดของการโต้ตอบรายการเดียวตาม `Interaction.id`

พารามิเตอร์เส้นทาง / การค้นหา

id string  (ต้องระบุ)

ตัวระบุที่ไม่ซ้ำกันของการโต้ตอบที่จะดึงข้อมูล

stream boolean  (ไม่บังคับ)

หากตั้งค่าเป็น "จริง" ระบบจะสตรีมเนื้อหาที่สร้างขึ้นทีละส่วน

ค่าเริ่มต้นคือ False

last_event_id string  (ไม่บังคับ)

ไม่บังคับ หากตั้งค่าไว้ จะดำเนินการต่อในสตรีมการโต้ตอบจากก้อนข้อมูลถัดไปหลังจากเหตุการณ์ที่ทำเครื่องหมายด้วยรหัสเหตุการณ์ ใช้ได้เฉพาะในกรณีที่ `stream` เป็นจริง

include_input boolean  (ไม่บังคับ)

หากตั้งค่าเป็น "จริง" จะรวมอินพุตไว้ในการตอบกลับ

ค่าเริ่มต้นคือ False

api_version string  (ไม่บังคับ)

เวอร์ชันของ API ที่จะใช้

การตอบกลับ

แสดงผลทรัพยากร Interaction

รับการโต้ตอบ

ตัวอย่างการตอบกลับ

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "model": "gemini-3-flash-preview",
  "status": "completed",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "model",
  "outputs": [
    {
      "type": "text",
      "text": "I'm doing great, thank you for asking! How can I help you today?"
    }
  ]
}

การลบการโต้ตอบ

delete https://generativelanguage.googleapis.com/v1beta/interactions/{id}

ลบการโต้ตอบตามรหัส

พารามิเตอร์เส้นทาง / การค้นหา

id string  (ต้องระบุ)

ตัวระบุที่ไม่ซ้ำกันของการโต้ตอบที่จะลบ

api_version string  (ไม่บังคับ)

เวอร์ชันของ API ที่จะใช้

การตอบกลับ

หากทำสำเร็จ การตอบกลับจะว่างเปล่า

ลบการโต้ตอบ

การยกเลิกการโต้ตอบ

post https://generativelanguage.googleapis.com/v1beta/interactions/{id}/cancel

ยกเลิกการโต้ตอบตามรหัส โดยจะมีผลกับการโต้ตอบในเบื้องหลังที่ยังทำงานอยู่เท่านั้น

พารามิเตอร์เส้นทาง / การค้นหา

id string  (ต้องระบุ)

ตัวระบุที่ไม่ซ้ำกันของการโต้ตอบที่จะยกเลิก

api_version string  (ไม่บังคับ)

เวอร์ชันของ API ที่จะใช้

การตอบกลับ

แสดงผลทรัพยากร Interaction

ยกเลิกการโต้ตอบ

ตัวอย่างการตอบกลับ

{
  "id": "v1_ChdPU0F4YWFtNkFwS2kxZThQZ05lbXdROBIXT1NBeGFhbTZBcEtpMWU4UGdOZW13UTg",
  "agent": "deep-research-pro-preview-12-2025",
  "status": "cancelled",
  "object": "interaction",
  "created": "2025-11-26T12:25:15Z",
  "updated": "2025-11-26T12:25:15Z",
  "role": "agent"
}

แหล่งข้อมูล

การโต้ตอบ

ทรัพยากรการโต้ตอบ

ช่อง

model ModelOption  (ไม่บังคับ)

ชื่อของ `Model` ที่ใช้ในการสร้างการโต้ตอบ

ค่าที่เป็นไปได้ มีดังนี้

  • gemini-2.5-flash

    โมเดลการให้เหตุผลแบบไฮบริดรุ่นแรกของเราซึ่งรองรับหน้าต่างบริบทขนาด 1 ล้านโทเค็นและมีงบประมาณสำหรับการคิด

  • gemini-2.5-flash-image

    โมเดลการสร้างรูปภาพในตัวของเราได้รับการเพิ่มประสิทธิภาพเพื่อความเร็ว ความยืดหยุ่น และความเข้าใจบริบท ระบบจะคิดราคาอินพุตและเอาต์พุตข้อความเหมือนกับ 2.5 Flash

  • gemini-2.5-flash-lite

    โมเดลที่มีขนาดเล็กที่สุดและคุ้มค่าที่สุดของเรา สร้างขึ้นเพื่อการใช้งานในวงกว้าง

  • gemini-2.5-flash-lite-preview-09-2025

    โมเดลล่าสุดที่อิงตาม Gemini 2.5 Flash lite ซึ่งได้รับการเพิ่มประสิทธิภาพเพื่อความคุ้มค่า ปริมาณงานสูง และคุณภาพสูง

  • gemini-2.5-flash-native-audio-preview-12-2025

    โมเดลเสียงดั้งเดิมของเราได้รับการเพิ่มประสิทธิภาพเพื่อเอาต์พุตเสียงคุณภาพสูงขึ้น โดยมีจังหวะที่ดีขึ้น ความเป็นธรรมชาติของเสียง ความละเอียด และอารมณ์

  • gemini-2.5-flash-preview-09-2025

    โมเดลล่าสุดที่อิงตามโมเดล 2.5 Flash 2.5 Flash Preview เหมาะที่สุดสำหรับการประมวลผลขนาดใหญ่ งานที่มีเวลาในการตอบสนองต่ำและมีปริมาณมากซึ่งต้องใช้ความคิด และกรณีการใช้งานแบบเอเจนต์

  • gemini-2.5-flash-preview-tts

    โมเดลข้อความเป็นคำพูด 2.5 Flash ของเราได้รับการเพิ่มประสิทธิภาพเพื่อการสร้างคำพูดที่ควบคุมได้ซึ่งมีประสิทธิภาพและมีความหน่วงต่ำ

  • gemini-2.5-pro

    โมเดลอเนกประสงค์ที่ล้ำสมัยของเรา ซึ่งโดดเด่นในด้านการเขียนโค้ดและงานการให้เหตุผลที่ซับซ้อน

  • gemini-2.5-pro-preview-tts

    โมเดลเสียงอ่านออกเสียงข้อความ 2.5 Pro ของเราได้รับการเพิ่มประสิทธิภาพเพื่อการสร้างเสียงพูดที่ทรงพลังและมีเวลาในการตอบสนองต่ำ เพื่อให้ได้ผลลัพธ์ที่เป็นธรรมชาติมากขึ้นและควบคุมพรอมต์ได้ง่ายขึ้น

  • gemini-3-flash-preview

    โมเดลที่ชาญฉลาดที่สุดของเราสร้างขึ้นเพื่อเน้นความเร็ว โดยผสานความชาญฉลาดระดับแนวหน้าเข้ากับการค้นหาและการอ้างอิงที่เหนือกว่า

  • gemini-3-pro-image-preview

    โมเดลการสร้างและแก้ไขรูปภาพที่ล้ำสมัย

  • gemini-3-pro-preview

    โมเดลที่ชาญฉลาดที่สุดของเราซึ่งมีการให้เหตุผลและทำความเข้าใจข้อมูลหลายรูปแบบระดับ SOTA รวมถึงความสามารถในการเขียนโค้ดแบบเป็น Agent และการเขียนโค้ดที่สร้างความรู้สึกที่ทรงพลัง

  • gemini-3.1-pro-preview

    โมเดลการให้เหตุผล SOTA ล่าสุดของเราที่มีความลึกซึ้งและเฉดสีที่ไม่เคยมีมาก่อน รวมถึงความสามารถในการทำความเข้าใจข้อมูลหลายรูปแบบและการเขียนโค้ดที่ทรงพลัง

  • gemini-3.1-flash-image-preview

    ความสามารถด้านภาพระดับมืออาชีพที่มีประสิทธิภาพระดับ Flash และความสามารถในการสร้างที่อิงตามความเป็นจริง

โมเดลที่จะเติมข้อความพรอมต์ของคุณ\n\nดูรายละเอียดเพิ่มเติมได้ที่ [models](https://ai.google.dev/gemini-api/docs/models)

agent AgentOption  (ไม่บังคับ)

ชื่อของ `Agent` ที่ใช้สร้างการโต้ตอบ

ค่าที่เป็นไปได้ มีดังนี้

  • deep-research-pro-preview-12-2025

    เอเจนต์ Deep Research ของ Gemini

ตัวแทนที่จะโต้ตอบด้วย

id string  (ไม่บังคับ)

เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันสำหรับการโต้ตอบที่เสร็จสมบูรณ์

status enum (string)  (ไม่บังคับ)

เอาต์พุตเท่านั้น สถานะของการโต้ตอบ

ค่าที่เป็นไปได้ มีดังนี้

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
created string  (ไม่บังคับ)

เอาต์พุตเท่านั้น เวลาที่สร้างคำตอบในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ssZ)

updated string  (ไม่บังคับ)

เอาต์พุตเท่านั้น เวลาที่อัปเดตคำตอบครั้งล่าสุดในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ssZ)

role string  (ไม่บังคับ)

เอาต์พุตเท่านั้น บทบาทของการโต้ตอบ

outputs อาร์เรย์ (Content)  (ไม่บังคับ)

เอาต์พุตเท่านั้น คำตอบจากโมเดล

system_instruction string  (ไม่บังคับ)

คำสั่งของระบบสำหรับการโต้ตอบ

เครื่องมือ อาร์เรย์ (เครื่องมือ)  (ไม่บังคับ)

รายการการประกาศเครื่องมือที่โมเดลอาจเรียกใช้ระหว่างการโต้ตอบ

usage Usage  (ไม่บังคับ)

เอาต์พุตเท่านั้น สถิติการใช้โทเค็นของคำขอโต้ตอบ

สถิติการใช้โทเค็นของคำขอโต้ตอบ

ช่อง

total_input_tokens integer  (ไม่บังคับ)

จำนวนโทเค็นในพรอมต์ (บริบท)

input_tokens_by_modality ModalityTokens  (ไม่บังคับ)

รายละเอียดการใช้โทเค็นอินพุตตามรูปแบบ

จำนวนโทเค็นสำหรับรูปแบบการตอบกลับเดียว

ช่อง

modality ResponseModality  (ไม่บังคับ)

รูปแบบที่เชื่อมโยงกับจำนวนโทเค็น

ค่าที่เป็นไปได้ มีดังนี้

  • text
  • image
  • audio

โทเค็น จำนวนเต็ม  (ไม่บังคับ)

จำนวนโทเค็นสำหรับรูปแบบ

total_cached_tokens integer  (ไม่บังคับ)

จํานวนโทเค็นในส่วนที่แคชของพรอมต์ (เนื้อหาที่แคช)

cached_tokens_by_modality ModalityTokens  (ไม่บังคับ)

รายละเอียดการใช้งานโทเค็นที่แคชไว้ตามรูปแบบ

จำนวนโทเค็นสำหรับรูปแบบการตอบกลับเดียว

ช่อง

modality ResponseModality  (ไม่บังคับ)

รูปแบบที่เชื่อมโยงกับจำนวนโทเค็น

ค่าที่เป็นไปได้ มีดังนี้

  • text
  • image
  • audio

โทเค็น จำนวนเต็ม  (ไม่บังคับ)

จำนวนโทเค็นสำหรับรูปแบบ

total_output_tokens integer  (ไม่บังคับ)

จำนวนโทเค็นทั้งหมดในการตอบกลับที่สร้างขึ้นทั้งหมด

output_tokens_by_modality ModalityTokens  (ไม่บังคับ)

รายละเอียดการใช้โทเค็นเอาต์พุตตามรูปแบบ

จำนวนโทเค็นสำหรับรูปแบบการตอบกลับเดียว

ช่อง

modality ResponseModality  (ไม่บังคับ)

รูปแบบที่เชื่อมโยงกับจำนวนโทเค็น

ค่าที่เป็นไปได้ มีดังนี้

  • text
  • image
  • audio

โทเค็น จำนวนเต็ม  (ไม่บังคับ)

จำนวนโทเค็นสำหรับรูปแบบ

total_tool_use_tokens integer  (ไม่บังคับ)

จำนวนโทเค็นที่อยู่ในพรอมต์การใช้เครื่องมือ

tool_use_tokens_by_modality ModalityTokens  (ไม่บังคับ)

รายละเอียดการใช้โทเค็นการใช้เครื่องมือตามรูปแบบ

จำนวนโทเค็นสำหรับรูปแบบการตอบกลับเดียว

ช่อง

modality ResponseModality  (ไม่บังคับ)

รูปแบบที่เชื่อมโยงกับจำนวนโทเค็น

ค่าที่เป็นไปได้ มีดังนี้

  • text
  • image
  • audio

โทเค็น จำนวนเต็ม  (ไม่บังคับ)

จำนวนโทเค็นสำหรับรูปแบบ

total_thought_tokens integer  (ไม่บังคับ)

จำนวนโทเค็นของความคิดสำหรับโมเดลการคิด

total_tokens integer  (ไม่บังคับ)

จำนวนโทเค็นทั้งหมดสำหรับคำขอการโต้ตอบ (พรอมต์ + คำตอบ + โทเค็นภายในอื่นๆ )

response_modalities ResponseModality  (ไม่บังคับ)

รูปแบบการตอบกลับที่ขอ (TEXT, IMAGE, AUDIO)

ค่าที่เป็นไปได้ มีดังนี้

  • text
  • image
  • audio

response_format object  (ไม่บังคับ)

บังคับให้การตอบกลับที่สร้างขึ้นเป็นออบเจ็กต์ JSON ที่เป็นไปตาม รูปแบบ JSON ที่ระบุในฟิลด์นี้

response_mime_type string  (ไม่บังคับ)

ประเภท MIME ของการตอบกลับ ต้องระบุหากตั้งค่า response_format

previous_interaction_id string  (ไม่บังคับ)

รหัสของการโต้ตอบก่อนหน้า (หากมี)

input Content หรืออาร์เรย์ (Content) หรืออาร์เรย์ (Turn) หรือสตริง  (ต้องระบุ)

อินพุตสำหรับการโต้ตอบ (ใช้ได้ทั้งโมเดลและเอเจนต์)

agent_config object  (ไม่บังคับ)

พารามิเตอร์การกำหนดค่าสำหรับการโต้ตอบของตัวแทน

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

DynamicAgentConfig

การกำหนดค่าสำหรับเอเจนต์แบบไดนามิก

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "dynamic" เสมอ

DeepResearchAgentConfig

การกำหนดค่าสำหรับตัวแทน Deep Research

thinking_summaries ThinkingSummaries  (ไม่บังคับ)

จะรวมสรุปความคิดในคำตอบหรือไม่

ค่าที่เป็นไปได้ มีดังนี้

  • auto
  • none

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "deep-research" เสมอ

ตัวอย่าง

ตัวอย่าง

{
  "created": "2025-12-04T15:01:45Z",
  "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
  "model": "gemini-3-flash-preview",
  "object": "interaction",
  "outputs": [
    {
      "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?",
      "type": "text"
    }
  ],
  "role": "model",
  "status": "completed",
  "updated": "2025-12-04T15:01:45Z",
  "usage": {
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 7
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 7,
    "total_output_tokens": 23,
    "total_thought_tokens": 49,
    "total_tokens": 79,
    "total_tool_use_tokens": 0
  }
}

โมเดลข้อมูล

เนื้อหา

เนื้อหาของการตอบกลับ

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

TextContent

บล็อกเนื้อหาข้อความ

ข้อความ สตริง  (ต้องระบุ)

เนื้อหาข้อความ

annotations Annotation  (ไม่บังคับ)

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

UrlCitation

คำอธิบายประกอบการอ้างอิง URL

url string  (ไม่บังคับ)

URL

title string  (ไม่บังคับ)

ชื่อของ URL

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

FileCitation

คำอธิบายประกอบการอ้างอิงไฟล์

document_uri string  (ไม่บังคับ)

URI ของไฟล์

file_name string  (ไม่บังคับ)

ชื่อไฟล์

แหล่งที่มา สตริง  (ไม่บังคับ)

แหล่งที่มาของข้อความบางส่วน

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

PlaceCitation

คำอธิบายประกอบการอ้างอิงสถานที่

place_id string  (ไม่บังคับ)

รหัสของสถานที่ในรูปแบบ `places/{place_id}`

name string  (ไม่บังคับ)

ชื่อสถานที่

url string  (ไม่บังคับ)

การอ้างอิง URI ของสถานที่

review_snippets ReviewSnippet  (ไม่บังคับ)

ข้อมูลรีวิวที่ใช้ในการสร้างคำตอบเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

แคปซูลข้อมูลรีวิวของผู้ใช้ที่ตอบคำถามเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

ช่อง

title string  (ไม่บังคับ)

ชื่อของรีวิว

url string  (ไม่บังคับ)

ลิงก์ที่สอดคล้องกับรีวิวของผู้ใช้ใน Google Maps

review_id string  (ไม่บังคับ)

รหัสของตัวอย่างรีวิว

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "place_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "text" เสมอ

ImageContent

บล็อกเนื้อหารูปภาพ

data string  (ไม่บังคับ)

เนื้อหารูปภาพ

uri สตริง  (ไม่บังคับ)

URI ของรูปภาพ

mime_type enum (string)  (ไม่บังคับ)

ประเภท MIME ของรูปภาพ

ค่าที่เป็นไปได้ มีดังนี้

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (ไม่บังคับ)

ความละเอียดของสื่อ

ค่าที่เป็นไปได้ มีดังนี้

  • low
  • medium
  • high
  • ultra_high

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "image" เสมอ

AudioContent

บล็อกเนื้อหาเสียง

data string  (ไม่บังคับ)

เนื้อหาเสียง

uri สตริง  (ไม่บังคับ)

URI ของเสียง

mime_type enum (string)  (ไม่บังคับ)

ประเภท MIME ของเสียง

ค่าที่เป็นไปได้ มีดังนี้

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "audio" เสมอ

DocumentContent

บล็อกเนื้อหาของเอกสาร

data string  (ไม่บังคับ)

เนื้อหาเอกสาร

uri สตริง  (ไม่บังคับ)

URI ของเอกสาร

mime_type enum (string)  (ไม่บังคับ)

ประเภท MIME ของเอกสาร

ค่าที่เป็นไปได้ มีดังนี้

  • application/pdf
type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "document" เสมอ

VideoContent

บล็อกเนื้อหาวิดีโอ

data string  (ไม่บังคับ)

เนื้อหาวิดีโอ

uri สตริง  (ไม่บังคับ)

URI ของวิดีโอ

mime_type enum (string)  (ไม่บังคับ)

ประเภท MIME ของวิดีโอ

ค่าที่เป็นไปได้ มีดังนี้

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (ไม่บังคับ)

ความละเอียดของสื่อ

ค่าที่เป็นไปได้ มีดังนี้

  • low
  • medium
  • high
  • ultra_high

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "video" เสมอ

ThoughtContent

บล็อกเนื้อหาความคิด

ลายเซ็น สตริง  (ไม่บังคับ)

ลายเซ็นที่ตรงกับแหล่งข้อมูลแบ็กเอนด์เพื่อเป็นส่วนหนึ่งของการสร้าง

summary ThoughtSummaryContent  (ไม่บังคับ)

สรุปความคิด

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

TextContent

บล็อกเนื้อหาข้อความ

ข้อความ สตริง  (ต้องระบุ)

เนื้อหาข้อความ

annotations Annotation  (ไม่บังคับ)

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

UrlCitation

คำอธิบายประกอบการอ้างอิง URL

url string  (ไม่บังคับ)

URL

title string  (ไม่บังคับ)

ชื่อของ URL

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

FileCitation

คำอธิบายประกอบการอ้างอิงไฟล์

document_uri string  (ไม่บังคับ)

URI ของไฟล์

file_name string  (ไม่บังคับ)

ชื่อไฟล์

แหล่งที่มา สตริง  (ไม่บังคับ)

แหล่งที่มาของข้อความบางส่วน

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

PlaceCitation

คำอธิบายประกอบการอ้างอิงสถานที่

place_id string  (ไม่บังคับ)

รหัสของสถานที่ในรูปแบบ `places/{place_id}`

name string  (ไม่บังคับ)

ชื่อสถานที่

url string  (ไม่บังคับ)

การอ้างอิง URI ของสถานที่

review_snippets ReviewSnippet  (ไม่บังคับ)

ข้อมูลรีวิวที่ใช้ในการสร้างคำตอบเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

แคปซูลข้อมูลรีวิวของผู้ใช้ที่ตอบคำถามเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

ช่อง

title string  (ไม่บังคับ)

ชื่อของรีวิว

url string  (ไม่บังคับ)

ลิงก์ที่สอดคล้องกับรีวิวของผู้ใช้ใน Google Maps

review_id string  (ไม่บังคับ)

รหัสของตัวอย่างรีวิว

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "place_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "text" เสมอ

ImageContent

บล็อกเนื้อหารูปภาพ

data string  (ไม่บังคับ)

เนื้อหารูปภาพ

uri สตริง  (ไม่บังคับ)

URI ของรูปภาพ

mime_type enum (string)  (ไม่บังคับ)

ประเภท MIME ของรูปภาพ

ค่าที่เป็นไปได้ มีดังนี้

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (ไม่บังคับ)

ความละเอียดของสื่อ

ค่าที่เป็นไปได้ มีดังนี้

  • low
  • medium
  • high
  • ultra_high

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "image" เสมอ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "thought" เสมอ

FunctionCallContent

บล็อกเนื้อหาการเรียกใช้เครื่องมือฟังก์ชัน

name string  (ต้องระบุ)

ชื่อของเครื่องมือที่จะเรียกใช้

อาร์กิวเมนต์ object  (ต้องระบุ)

อาร์กิวเมนต์ที่จะส่งไปยังฟังก์ชัน

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "function_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

FunctionResultContent

บล็อกเนื้อหาผลลัพธ์ของเครื่องมือฟังก์ชัน

name string  (ไม่บังคับ)

ชื่อของเครื่องมือที่เรียกใช้

is_error boolean  (ไม่บังคับ)

การเรียกใช้เครื่องมือทำให้เกิดข้อผิดพลาดหรือไม่

result array (FunctionResultSubcontent) หรือสตริง  (ต้องระบุ)

ผลลัพธ์ของการเรียกใช้เครื่องมือ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "function_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

CodeExecutionCallContent

เนื้อหาการรันโค้ด

arguments CodeExecutionCallArguments  (ต้องระบุ)

อาร์กิวเมนต์ที่จะส่งผ่านไปยังการเรียกใช้โค้ด

อาร์กิวเมนต์ที่จะส่งผ่านไปยังการเรียกใช้โค้ด

ช่อง

language enum (string)  (ไม่บังคับ)

ภาษาโปรแกรมของ `code`

ค่าที่เป็นไปได้ มีดังนี้

  • python
รหัส สตริง  (ไม่บังคับ)

โค้ดที่จะดำเนินการ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "code_execution_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

CodeExecutionResultContent

เนื้อหาผลการเรียกใช้โค้ด

result string  (ต้องระบุ)

เอาต์พุตของการเรียกใช้โค้ด

is_error boolean  (ไม่บังคับ)

การดำเนินการโค้ดส่งผลให้เกิดข้อผิดพลาดหรือไม่

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "code_execution_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้โค้ด

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

UrlContextCallContent

เนื้อหาบริบท URL

arguments UrlContextCallArguments  (ต้องระบุ)

อาร์กิวเมนต์ที่จะส่งไปยังบริบท URL

อาร์กิวเมนต์ที่จะส่งไปยังบริบท URL

ช่อง

urls array (string)  (ไม่บังคับ)

URL ที่จะดึงข้อมูล

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_context_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

UrlContextResultContent

เนื้อหาผลลัพธ์ของบริบท URL

result UrlContextResult  (ต้องระบุ)

ผลลัพธ์ของบริบท URL

ผลลัพธ์ของบริบท URL

ช่อง

url string  (ไม่บังคับ)

URL ที่ดึงข้อมูล

status enum (string)  (ไม่บังคับ)

สถานะของการดึงข้อมูล URL

ค่าที่เป็นไปได้ มีดังนี้

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (ไม่บังคับ)

ไม่ว่าบริบท URL จะทำให้เกิดข้อผิดพลาดหรือไม่

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_context_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกบริบท URL

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleSearchCallContent

เนื้อหาของ Google Search

arguments GoogleSearchCallArguments  (ต้องระบุ)

อาร์กิวเมนต์ที่จะส่งไปยัง Google Search

อาร์กิวเมนต์ที่จะส่งไปยัง Google Search

ช่อง

queries อาร์เรย์ (สตริง)  (ไม่บังคับ)

คำค้นหาใน Web Search สำหรับการค้นหาเว็บเพิ่มเติม

search_type enum (string)  (ไม่บังคับ)

ประเภทการอ้างอิงการค้นหาที่เปิดใช้

ค่าที่เป็นไปได้ มีดังนี้

  • web_search
  • image_search
type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_search_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleSearchResultContent

เนื้อหาผลการค้นหาของ Google

result GoogleSearchResult  (ต้องระบุ)

ผลการค้นหาของ Google Search

ผลการค้นหาของ Google Search

ช่อง

search_suggestions string  (ไม่บังคับ)

ข้อมูลโค้ดเนื้อหาเว็บที่ฝังในหน้าเว็บหรือ WebView ของแอปได้

is_error boolean  (ไม่บังคับ)

ไม่ว่า Google Search จะทำให้เกิดข้อผิดพลาดหรือไม่

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_search_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากการบล็อกการโทรของ Google Search

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

McpServerToolCallContent

เนื้อหาการเรียกใช้เครื่องมือ MCPServer

name string  (ต้องระบุ)

ชื่อของเครื่องมือที่เรียกใช้

server_name string  (ต้องระบุ)

ชื่อเซิร์ฟเวอร์ MCP ที่ใช้

อาร์กิวเมนต์ object  (ต้องระบุ)

ออบเจ็กต์ JSON ของอาร์กิวเมนต์สำหรับฟังก์ชัน

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "mcp_server_tool_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

McpServerToolResultContent

เนื้อหาผลลัพธ์ของเครื่องมือ MCPServer

name string  (ไม่บังคับ)

ชื่อของเครื่องมือที่เรียกใช้สำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

server_name string  (ไม่บังคับ)

ชื่อเซิร์ฟเวอร์ MCP ที่ใช้

result array (FunctionResultSubcontent) หรือสตริง  (ต้องระบุ)

เอาต์พุตจากการเรียกเซิร์ฟเวอร์ MCP อาจเป็นข้อความธรรมดาหรือเนื้อหาที่สมบูรณ์

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "mcp_server_tool_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้เครื่องมือเซิร์ฟเวอร์ MCP

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

FileSearchCallContent

เนื้อหาการค้นหาไฟล์

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_search_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

FileSearchResultContent

เนื้อหาผลการค้นหาของ File Search

result FileSearchResult  (ไม่บังคับ)

ผลการค้นหาไฟล์

ผลการค้นหาไฟล์

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_search_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกค้นหาไฟล์

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleMapsCallContent

เนื้อหาของ Google Maps

arguments GoogleMapsCallArguments  (ไม่บังคับ)

อาร์กิวเมนต์ที่จะส่งไปยังเครื่องมือ Google Maps

อาร์กิวเมนต์ที่จะส่งไปยังเครื่องมือ Google Maps

ช่อง

queries อาร์เรย์ (สตริง)  (ไม่บังคับ)

คำค้นหาที่จะดำเนินการ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_maps_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleMapsResultContent

เนื้อหาผลการค้นหาของ Google Maps

result GoogleMapsResult  (ต้องระบุ)

ผลลัพธ์ของ Google Maps

ผลลัพธ์ของ Google Maps

ช่อง

places Places  (ไม่บังคับ)

สถานที่ที่พบ

ช่อง

place_id string  (ไม่บังคับ)

รหัสของสถานที่ในรูปแบบ `places/{place_id}`

name string  (ไม่บังคับ)

ชื่อสถานที่

url string  (ไม่บังคับ)

การอ้างอิง URI ของสถานที่

review_snippets ReviewSnippet  (ไม่บังคับ)

ข้อมูลรีวิวที่ใช้ในการสร้างคำตอบเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

แคปซูลข้อมูลรีวิวของผู้ใช้ที่ตอบคำถามเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

ช่อง

title string  (ไม่บังคับ)

ชื่อของรีวิว

url string  (ไม่บังคับ)

ลิงก์ที่สอดคล้องกับรีวิวของผู้ใช้ใน Google Maps

review_id string  (ไม่บังคับ)

รหัสของตัวอย่างรีวิว

widget_context_token string  (ไม่บังคับ)

ชื่อทรัพยากรของโทเค็นบริบทของวิดเจ็ต Google Maps

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_maps_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ Google Maps

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

ตัวอย่าง

ข้อความ

{
  "type": "text",
  "text": "Hello, how are you?"
}

รูปภาพ

{
  "type": "image",
  "data": "BASE64_ENCODED_IMAGE",
  "mime_type": "image/png"
}

เสียง

{
  "type": "audio",
  "data": "BASE64_ENCODED_AUDIO",
  "mime_type": "audio/wav"
}

เอกสาร

{
  "type": "document",
  "data": "BASE64_ENCODED_DOCUMENT",
  "mime_type": "application/pdf"
}

วิดีโอ

{
  "type": "video",
  "uri": "https://www.youtube.com/watch?v=9hE5-98ZeCg"
}

ความคิด

{
  "type": "thought",
  "summary": [
    {
      "type": "text",
      "text": "The user is asking about the weather. I should use the get_weather tool."
    }
  ],
  "signature": "CoMDAXLI2nynRYojJIy6B1Jh9os2crpWLfB0+19xcLsGG46bd8wjkF/6RNlRUdvHrXyjsHkG0BZFcuO/bPOyA6Xh5jANNgx82wPHjGExN8A4ZQn56FlMwyZoqFVQz0QyY1lfibFJ2zU3J87uw26OewzcuVX0KEcs+GIsZa3EA6WwqhbsOd3wtZB3Ua2Qf98VAWZTS5y/tWpql7jnU3/CU7pouxQr/Bwft3hwnJNesQ9/dDJTuaQ8Zprh9VRWf1aFFjpIueOjBRrlT3oW6/y/eRl/Gt9BQXCYTqg/38vHFUU4Wo/d9dUpvfCe/a3o97t2Jgxp34oFKcsVb4S5WJrykIkw+14DzVnTpCpbQNFckqvFLuqnJCkL0EQFtunBXI03FJpPu3T1XU6id8S7ojoJQZSauGUCgmaLqUGdMrd08oo81ecoJSLs51Re9N/lISGmjWFPGpqJLoGq6uo4FHz58hmeyXCgHG742BHz2P3MiH1CXHUT2J8mF6zLhf3SR9Qb3lkrobAh"
}

Function Call

{
  "type": "function_call",
  "name": "get_weather",
  "id": "gth23981",
  "arguments": {
    "location": "Boston, MA"
  }
}

ผลลัพธ์ของฟังก์ชัน

{
  "type": "function_result",
  "name": "get_weather",
  "call_id": "gth23981",
  "result": [
    {
      "type": "text",
      "text": "{\"weather\":\"sunny\"}"
    }
  ]
}

การเรียกใช้โค้ด

{
  "type": "code_execution_call",
  "id": "call_123456",
  "arguments": {
    "language": "python",
    "code": "print('hello world')"
  }
}

ผลการรันโค้ด

{
  "type": "code_execution_result",
  "call_id": "call_123456",
  "result": "hello world"
}

การเรียกบริบท URL

{
  "type": "url_context_call",
  "id": "call_123456",
  "arguments": {
    "urls": [
      "https://www.example.com"
    ]
  }
}

ผลลัพธ์บริบท URL

{
  "type": "url_context_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.example.com",
      "status": "SUCCESS"
    }
  ]
}

การโทรผ่าน Google Search

{
  "type": "google_search_call",
  "id": "call_123456",
  "arguments": {
    "queries": [
      "weather in Boston"
    ]
  }
}

ผลการค้นหาของ Google

{
  "type": "google_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "url": "https://www.google.com/search?q=weather+in+Boston",
      "title": "Weather in Boston"
    }
  ]
}

การเรียกใช้เครื่องมือเซิร์ฟเวอร์ MCP

{
  "type": "mcp_server_tool_call",
  "id": "call_123456",
  "name": "get_forecast",
  "server_name": "weather_server",
  "arguments": {
    "city": "London"
  }
}

ผลลัพธ์ของเครื่องมือเซิร์ฟเวอร์ MCP

{
  "type": "mcp_server_tool_result",
  "name": "get_forecast",
  "server_name": "weather_server",
  "call_id": "call_123456",
  "result": "sunny"
}

การเรียกค้นหาไฟล์

{
  "type": "file_search_call",
  "id": "call_123456"
}

ผลการค้นหาไฟล์

{
  "type": "file_search_result",
  "call_id": "call_123456",
  "result": [
    {
      "text": "search result chunk",
      "file_search_store": "file_search_store"
    }
  ]
}

การโทรผ่าน Google Maps

{
  "type": "google_maps_call",
  "id": "call_123456",
  "arguments": {
    "query": "best food near me"
  }
}

ผลการค้นหาของ Google Maps

{
  "type": "google_maps_result",
  "call_id": "call_123456",
  "result": [
    {
      "places": [
        {
          "url": "https://www.google.com/maps/search/best+food+near+me",
          "name": "Tasty Restaurant"
        }
      ]
    }
  ]
}

เครื่องมือ

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

ฟังก์ชัน

เครื่องมือที่โมเดลใช้ได้

name string  (ไม่บังคับ)

ชื่อฟังก์ชัน

description string  (ไม่บังคับ)

คำอธิบายฟังก์ชัน

พารามิเตอร์ ออบเจ็กต์  (ไม่บังคับ)

สคีมา JSON สำหรับพารามิเตอร์ของฟังก์ชัน

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "function" เสมอ

GoogleSearch

เครื่องมือที่โมเดลใช้ค้นหาใน Google ได้

search_types array (enum (string))  (ไม่บังคับ)

ประเภทของการอ้างอิงการค้นหาที่จะเปิดใช้

ค่าที่เป็นไปได้ มีดังนี้

  • web_search
  • image_search
ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_search" เสมอ

CodeExecution

เครื่องมือที่โมเดลใช้ดำเนินการกับโค้ดได้

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "code_execution" เสมอ

UrlContext

เครื่องมือที่โมเดลใช้เพื่อดึงบริบท URL ได้

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_context" เสมอ

ComputerUse

เครื่องมือที่โมเดลใช้โต้ตอบกับคอมพิวเตอร์ได้

environment enum (string)  (ไม่บังคับ)

สภาพแวดล้อมที่ดำเนินการ

ค่าที่เป็นไปได้ มีดังนี้

  • browser
excludedPredefinedFunctions array (string)  (ไม่บังคับ)

รายการฟังก์ชันที่กำหนดไว้ล่วงหน้าซึ่งยกเว้นจากการเรียกใช้โมเดล

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "computer_use" เสมอ

McpServer

MCPServer คือเซิร์ฟเวอร์ที่โมเดลเรียกใช้เพื่อดำเนินการได้

name string  (ไม่บังคับ)

ชื่อของ MCPServer

url string  (ไม่บังคับ)

URL แบบเต็มสำหรับปลายทาง MCPServer ตัวอย่างเช่น "https://api.example.com/mcp"

ส่วนหัว ออบเจ็กต์  (ไม่บังคับ)

ไม่บังคับ: ช่องสำหรับส่วนหัวการตรวจสอบสิทธิ์ การหมดเวลา ฯลฯ หากจำเป็น

allowed_tools AllowedTools  (ไม่บังคับ)

เครื่องมือที่อนุญาต

การกำหนดค่าสำหรับเครื่องมือที่อนุญาต

ช่อง

mode ToolChoiceType  (ไม่บังคับ)

โหมดการเลือกเครื่องมือ

ค่าที่เป็นไปได้ มีดังนี้

  • auto
  • any
  • none
  • validated

เครื่องมือ อาร์เรย์ (สตริง)  (ไม่บังคับ)

ชื่อของเครื่องมือที่อนุญาต

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "mcp_server" เสมอ

FileSearch

เครื่องมือที่โมเดลใช้ค้นหาไฟล์ได้

file_search_store_names array (string)  (ไม่บังคับ)

ไฟล์จะจัดเก็บชื่อที่ใช้ค้นหา

top_k integer  (ไม่บังคับ)

จำนวนกลุ่มการดึงข้อมูลเชิงความหมายที่จะดึงข้อมูล

metadata_filter string  (ไม่บังคับ)

ตัวกรองข้อมูลเมตาที่จะใช้กับเอกสารและการแบ่งกลุ่มการดึงข้อมูลเชิงความหมาย

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_search" เสมอ

GoogleMaps

เครื่องมือที่โมเดลใช้เรียก Google Maps ได้

enable_widget boolean  (ไม่บังคับ)

ระบุว่าจะแสดงโทเค็นบริบทของวิดเจ็ตในผลการเรียกใช้เครื่องมือของ การตอบกลับหรือไม่

latitude number  (ไม่บังคับ)

ละติจูดของตำแหน่งของผู้ใช้

longitude number  (ไม่บังคับ)

ลองจิจูดของตำแหน่งของผู้ใช้

ประเภท สตริง  (ไม่บังคับ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_maps" เสมอ

ตัวอย่าง

ฟังก์ชัน

GoogleSearch

CodeExecution

UrlContext

ComputerUse

McpServer

FileSearch

GoogleMaps

เปิดหรือปิด

ช่อง

role string  (ไม่บังคับ)

ผู้เริ่มการเลี้ยวนี้ ต้องเป็นผู้ใช้สำหรับอินพุตหรือโมเดลสำหรับ เอาต์พุตของโมเดล

content array (Content) หรือ string  (ไม่บังคับ)

เนื้อหาของผลัด

ตัวอย่าง

เทิร์นของผู้ใช้

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "user turn"
    }
  ]
}

ผลัดกันพูด

{
  "role": "model",
  "content": [
    {
      "type": "text",
      "text": "model turn"
    }
  ]
}

InteractionSseEvent

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: event_type

InteractionStartEvent

interaction Interaction  (ต้องระบุ)

ไม่มีคำอธิบาย

event_type enum (string)  (ต้องระบุ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • interaction.start
event_id string  (ไม่บังคับ)

โทเค็น event_id ที่จะใช้เพื่อดำเนินการต่อในสตรีมการโต้ตอบจากเหตุการณ์นี้

InteractionCompleteEvent

interaction Interaction  (ต้องระบุ)

การโต้ตอบที่เสร็จสมบูรณ์โดยมีเอาต์พุตว่างเปล่าเพื่อลดขนาดเพย์โหลด ใช้เหตุการณ์ ContentDelta ก่อนหน้าสำหรับเอาต์พุตจริง

event_type enum (string)  (ต้องระบุ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • interaction.complete
event_id string  (ไม่บังคับ)

โทเค็น event_id ที่จะใช้เพื่อดำเนินการต่อในสตรีมการโต้ตอบจากเหตุการณ์นี้

InteractionStatusUpdate

interaction_id string  (ต้องระบุ)

ไม่มีคำอธิบาย

สถานะ enum (string)  (ต้องระบุ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • in_progress
  • requires_action
  • completed
  • failed
  • cancelled
  • incomplete
event_type string  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "interaction.status_update" เสมอ

event_id string  (ไม่บังคับ)

โทเค็น event_id ที่จะใช้เพื่อดำเนินการต่อในสตรีมการโต้ตอบจากเหตุการณ์นี้

ContentStart

index integer  (ต้องระบุ)

ไม่มีคำอธิบาย

เนื้อหา เนื้อหา  (ต้องระบุ)

ไม่มีคำอธิบาย

event_type string  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "content.start" เสมอ

event_id string  (ไม่บังคับ)

โทเค็น event_id ที่จะใช้เพื่อดำเนินการต่อในสตรีมการโต้ตอบจากเหตุการณ์นี้

ContentDelta

index integer  (ต้องระบุ)

ไม่มีคำอธิบาย

delta object  (ต้องระบุ)

ไม่มีคำอธิบาย

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

TextDelta

ข้อความ สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

annotations Annotation  (ไม่บังคับ)

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

UrlCitation

คำอธิบายประกอบการอ้างอิง URL

url string  (ไม่บังคับ)

URL

title string  (ไม่บังคับ)

ชื่อของ URL

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

FileCitation

คำอธิบายประกอบการอ้างอิงไฟล์

document_uri string  (ไม่บังคับ)

URI ของไฟล์

file_name string  (ไม่บังคับ)

ชื่อไฟล์

แหล่งที่มา สตริง  (ไม่บังคับ)

แหล่งที่มาของข้อความบางส่วน

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

PlaceCitation

คำอธิบายประกอบการอ้างอิงสถานที่

place_id string  (ไม่บังคับ)

รหัสของสถานที่ในรูปแบบ `places/{place_id}`

name string  (ไม่บังคับ)

ชื่อสถานที่

url string  (ไม่บังคับ)

การอ้างอิง URI ของสถานที่

review_snippets ReviewSnippet  (ไม่บังคับ)

ข้อมูลรีวิวที่ใช้ในการสร้างคำตอบเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

แคปซูลข้อมูลรีวิวของผู้ใช้ที่ตอบคำถามเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

ช่อง

title string  (ไม่บังคับ)

ชื่อของรีวิว

url string  (ไม่บังคับ)

ลิงก์ที่สอดคล้องกับรีวิวของผู้ใช้ใน Google Maps

review_id string  (ไม่บังคับ)

รหัสของตัวอย่างรีวิว

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "place_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "text" เสมอ

ImageDelta

data string  (ไม่บังคับ)

ไม่มีคำอธิบาย

uri สตริง  (ไม่บังคับ)

ไม่มีคำอธิบาย

mime_type enum (string)  (ไม่บังคับ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (ไม่บังคับ)

ความละเอียดของสื่อ

ค่าที่เป็นไปได้ มีดังนี้

  • low
  • medium
  • high
  • ultra_high

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "image" เสมอ

AudioDelta

data string  (ไม่บังคับ)

ไม่มีคำอธิบาย

uri สตริง  (ไม่บังคับ)

ไม่มีคำอธิบาย

mime_type enum (string)  (ไม่บังคับ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • audio/wav
  • audio/mp3
  • audio/aiff
  • audio/aac
  • audio/ogg
  • audio/flac
type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "audio" เสมอ

DocumentDelta

data string  (ไม่บังคับ)

ไม่มีคำอธิบาย

uri สตริง  (ไม่บังคับ)

ไม่มีคำอธิบาย

mime_type enum (string)  (ไม่บังคับ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • application/pdf
type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "document" เสมอ

VideoDelta

data string  (ไม่บังคับ)

ไม่มีคำอธิบาย

uri สตริง  (ไม่บังคับ)

ไม่มีคำอธิบาย

mime_type enum (string)  (ไม่บังคับ)

ไม่มีคำอธิบาย

ค่าที่เป็นไปได้ มีดังนี้

  • video/mp4
  • video/mpeg
  • video/mpg
  • video/mov
  • video/avi
  • video/x-flv
  • video/webm
  • video/wmv
  • video/3gpp
resolution MediaResolution  (ไม่บังคับ)

ความละเอียดของสื่อ

ค่าที่เป็นไปได้ มีดังนี้

  • low
  • medium
  • high
  • ultra_high

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "video" เสมอ

ThoughtSummaryDelta

content ThoughtSummaryContent  (ไม่บังคับ)

รายการสรุปใหม่ที่จะเพิ่มลงในความคิด

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

TextContent

บล็อกเนื้อหาข้อความ

ข้อความ สตริง  (ต้องระบุ)

เนื้อหาข้อความ

annotations Annotation  (ไม่บังคับ)

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ข้อมูลการอ้างอิงสำหรับเนื้อหาที่โมเดลสร้างขึ้น

ประเภทที่เป็นไปได้

ตัวแยกประเภทแบบ Polymorphic: type

UrlCitation

คำอธิบายประกอบการอ้างอิง URL

url string  (ไม่บังคับ)

URL

title string  (ไม่บังคับ)

ชื่อของ URL

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

FileCitation

คำอธิบายประกอบการอ้างอิงไฟล์

document_uri string  (ไม่บังคับ)

URI ของไฟล์

file_name string  (ไม่บังคับ)

ชื่อไฟล์

แหล่งที่มา สตริง  (ไม่บังคับ)

แหล่งที่มาของข้อความบางส่วน

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

PlaceCitation

คำอธิบายประกอบการอ้างอิงสถานที่

place_id string  (ไม่บังคับ)

รหัสของสถานที่ในรูปแบบ `places/{place_id}`

name string  (ไม่บังคับ)

ชื่อสถานที่

url string  (ไม่บังคับ)

การอ้างอิง URI ของสถานที่

review_snippets ReviewSnippet  (ไม่บังคับ)

ข้อมูลรีวิวที่ใช้ในการสร้างคำตอบเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

แคปซูลข้อมูลรีวิวของผู้ใช้ที่ตอบคำถามเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

ช่อง

title string  (ไม่บังคับ)

ชื่อของรีวิว

url string  (ไม่บังคับ)

ลิงก์ที่สอดคล้องกับรีวิวของผู้ใช้ใน Google Maps

review_id string  (ไม่บังคับ)

รหัสของตัวอย่างรีวิว

ประเภท สตริง  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "place_citation" เสมอ

start_index integer  (ไม่บังคับ)

จุดเริ่มต้นของส่วนของคำตอบที่มาจากแหล่งที่มานี้

end_index integer  (ไม่บังคับ)

จุดสิ้นสุดของกลุ่มที่มาของการระบุแหล่งที่มา (ไม่รวมจุดสิ้นสุด)

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "text" เสมอ

ImageContent

บล็อกเนื้อหารูปภาพ

data string  (ไม่บังคับ)

เนื้อหารูปภาพ

uri สตริง  (ไม่บังคับ)

URI ของรูปภาพ

mime_type enum (string)  (ไม่บังคับ)

ประเภท MIME ของรูปภาพ

ค่าที่เป็นไปได้ มีดังนี้

  • image/png
  • image/jpeg
  • image/webp
  • image/heic
  • image/heif
resolution MediaResolution  (ไม่บังคับ)

ความละเอียดของสื่อ

ค่าที่เป็นไปได้ มีดังนี้

  • low
  • medium
  • high
  • ultra_high

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "image" เสมอ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "thought_summary" เสมอ

ThoughtSignatureDelta

ลายเซ็น สตริง  (ไม่บังคับ)

ลายเซ็นที่ตรงกับแหล่งข้อมูลแบ็กเอนด์เพื่อเป็นส่วนหนึ่งของการสร้าง

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "thought_signature" เสมอ

FunctionCallDelta

name string  (ต้องระบุ)

ไม่มีคำอธิบาย

อาร์กิวเมนต์ object  (ต้องระบุ)

ไม่มีคำอธิบาย

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "function_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

FunctionResultDelta

name string  (ไม่บังคับ)

ไม่มีคำอธิบาย

is_error boolean  (ไม่บังคับ)

ไม่มีคำอธิบาย

result object หรือ string  (ต้องระบุ)

เดลต้าผลลัพธ์การเรียกใช้เครื่องมือ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "function_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

CodeExecutionCallDelta

arguments CodeExecutionCallArguments  (ต้องระบุ)

ไม่มีคำอธิบาย

อาร์กิวเมนต์ที่จะส่งผ่านไปยังการเรียกใช้โค้ด

ช่อง

language enum (string)  (ไม่บังคับ)

ภาษาโปรแกรมของ `code`

ค่าที่เป็นไปได้ มีดังนี้

  • python
รหัส สตริง  (ไม่บังคับ)

โค้ดที่จะดำเนินการ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "code_execution_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

CodeExecutionResultDelta

result string  (ต้องระบุ)

ไม่มีคำอธิบาย

is_error boolean  (ไม่บังคับ)

ไม่มีคำอธิบาย

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "code_execution_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

UrlContextCallDelta

arguments UrlContextCallArguments  (ต้องระบุ)

ไม่มีคำอธิบาย

อาร์กิวเมนต์ที่จะส่งไปยังบริบท URL

ช่อง

urls array (string)  (ไม่บังคับ)

URL ที่จะดึงข้อมูล

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_context_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

UrlContextResultDelta

result UrlContextResult  (ต้องระบุ)

ไม่มีคำอธิบาย

ผลลัพธ์ของบริบท URL

ช่อง

url string  (ไม่บังคับ)

URL ที่ดึงข้อมูล

status enum (string)  (ไม่บังคับ)

สถานะของการดึงข้อมูล URL

ค่าที่เป็นไปได้ มีดังนี้

  • success
  • error
  • paywall
  • unsafe
is_error boolean  (ไม่บังคับ)

ไม่มีคำอธิบาย

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "url_context_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleSearchCallDelta

arguments GoogleSearchCallArguments  (ต้องระบุ)

ไม่มีคำอธิบาย

อาร์กิวเมนต์ที่จะส่งไปยัง Google Search

ช่อง

queries อาร์เรย์ (สตริง)  (ไม่บังคับ)

คำค้นหาใน Web Search สำหรับการค้นหาเว็บเพิ่มเติม

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_search_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleSearchResultDelta

result GoogleSearchResult  (ต้องระบุ)

ไม่มีคำอธิบาย

ผลการค้นหาของ Google Search

ช่อง

search_suggestions string  (ไม่บังคับ)

ข้อมูลโค้ดเนื้อหาเว็บที่ฝังในหน้าเว็บหรือ WebView ของแอปได้

is_error boolean  (ไม่บังคับ)

ไม่มีคำอธิบาย

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_search_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

McpServerToolCallDelta

name string  (ต้องระบุ)

ไม่มีคำอธิบาย

server_name string  (ต้องระบุ)

ไม่มีคำอธิบาย

อาร์กิวเมนต์ object  (ต้องระบุ)

ไม่มีคำอธิบาย

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "mcp_server_tool_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

McpServerToolResultDelta

name string  (ไม่บังคับ)

ไม่มีคำอธิบาย

server_name string  (ไม่บังคับ)

ไม่มีคำอธิบาย

result object หรือ string  (ต้องระบุ)

เดลต้าผลลัพธ์การเรียกใช้เครื่องมือ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "mcp_server_tool_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

FileSearchCallDelta

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_search_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

FileSearchResultDelta

result FileSearchResult  (ไม่บังคับ)

ไม่มีคำอธิบาย

ผลการค้นหาไฟล์

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "file_search_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleMapsCallDelta

arguments GoogleMapsCallArguments  (ไม่บังคับ)

อาร์กิวเมนต์ที่จะส่งไปยังเครื่องมือ Google Maps

อาร์กิวเมนต์ที่จะส่งไปยังเครื่องมือ Google Maps

ช่อง

queries อาร์เรย์ (สตริง)  (ไม่บังคับ)

คำค้นหาที่จะดำเนินการ

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_maps_call" เสมอ

id string  (ต้องระบุ)

รหัสที่ไม่ซ้ำกันสำหรับการเรียกใช้เครื่องมือนี้โดยเฉพาะ

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

GoogleMapsResultDelta

result GoogleMapsResult  (ต้องระบุ)

ผลลัพธ์ของ Google Maps

ผลลัพธ์ของ Google Maps

ช่อง

places Places  (ไม่บังคับ)

สถานที่ที่พบ

ช่อง

place_id string  (ไม่บังคับ)

รหัสของสถานที่ในรูปแบบ `places/{place_id}`

name string  (ไม่บังคับ)

ชื่อสถานที่

url string  (ไม่บังคับ)

การอ้างอิง URI ของสถานที่

review_snippets ReviewSnippet  (ไม่บังคับ)

ข้อมูลรีวิวที่ใช้ในการสร้างคำตอบเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

แคปซูลข้อมูลรีวิวของผู้ใช้ที่ตอบคำถามเกี่ยวกับ ฟีเจอร์ของสถานที่หนึ่งๆ ใน Google Maps

ช่อง

title string  (ไม่บังคับ)

ชื่อของรีวิว

url string  (ไม่บังคับ)

ลิงก์ที่สอดคล้องกับรีวิวของผู้ใช้ใน Google Maps

review_id string  (ไม่บังคับ)

รหัสของตัวอย่างรีวิว

widget_context_token string  (ไม่บังคับ)

ชื่อทรัพยากรของโทเค็นบริบทของวิดเจ็ต Google Maps

type object  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "google_maps_result" เสมอ

call_id string  (ต้องระบุ)

รหัสที่ตรงกับรหัสจากบล็อกการเรียกใช้ฟังก์ชัน

ลายเซ็น สตริง  (ไม่บังคับ)

แฮชลายเซ็นสำหรับการตรวจสอบฝั่งแบ็กเอนด์

event_type string  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "content.delta" เสมอ

event_id string  (ไม่บังคับ)

โทเค็น event_id ที่จะใช้เพื่อดำเนินการต่อในสตรีมการโต้ตอบจากเหตุการณ์นี้

ContentStop

index integer  (ต้องระบุ)

ไม่มีคำอธิบาย

event_type string  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "content.stop" เสมอ

event_id string  (ไม่บังคับ)

โทเค็น event_id ที่จะใช้เพื่อดำเนินการต่อในสตรีมการโต้ตอบจากเหตุการณ์นี้

ErrorEvent

ข้อผิดพลาด ข้อผิดพลาด  (ไม่บังคับ)

ไม่มีคำอธิบาย

ข้อความแสดงข้อผิดพลาดจากการโต้ตอบ

ช่อง

รหัส สตริง  (ไม่บังคับ)

URI ที่ระบุประเภทข้อผิดพลาด

ข้อความ สตริง  (ไม่บังคับ)

ข้อความแสดงข้อผิดพลาดที่มนุษย์อ่านได้

event_type string  (ต้องระบุ)

ไม่มีคำอธิบาย

ตั้งค่าเป็น "error" เสมอ

event_id string  (ไม่บังคับ)

โทเค็น event_id ที่จะใช้เพื่อดำเนินการต่อในสตรีมการโต้ตอบจากเหตุการณ์นี้

ตัวอย่าง

เริ่มการโต้ตอบ

{
  "event_type": "interaction.start",
  "interaction": {
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "status": "in_progress"
  }
}

การโต้ตอบเสร็จสมบูรณ์

{
  "event_type": "interaction.complete",
  "interaction": {
    "created": "2025-12-09T18:45:40Z",
    "id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
    "model": "gemini-3-flash-preview",
    "object": "interaction",
    "role": "model",
    "status": "completed",
    "updated": "2025-12-09T18:45:40Z",
    "usage": {
      "input_tokens_by_modality": [
        {
          "modality": "text",
          "tokens": 11
        }
      ],
      "total_cached_tokens": 0,
      "total_input_tokens": 11,
      "total_output_tokens": 364,
      "total_thought_tokens": 1120,
      "total_tokens": 1495,
      "total_tool_use_tokens": 0
    }
  }
}

การอัปเดตสถานะการโต้ตอบ

{
  "event_type": "interaction.status_update",
  "interaction_id": "v1_ChdTMjQ0YWJ5TUF1TzcxZThQdjRpcnFRcxIXUzI0NGFieU1BdU83MWU4UHY0aXJxUXM",
  "status": "in_progress"
}

เริ่มเนื้อหา

{
  "event_type": "content.start",
  "content": {
    "type": "text"
  },
  "index": 1
}

การเปลี่ยนแปลงของเนื้อหา

{
  "event_type": "content.delta",
  "delta": {
    "type": "text",
    "text": "Elara\u2019s life was a symphony of quiet moments. A librarian, she found solace in the hushed aisles, the scent of aged paper, and the predictable rhythm of her days. Her small apartment, meticulously ordered, reflected this internal calm, save"
  },
  "index": 1
}

หยุดเนื้อหา

{
  "event_type": "content.stop",
  "index": 1
}

เหตุการณ์ข้อผิดพลาด

{
  "event_type": "error",
  "error": {
    "message": "Failed to get completed interaction: Result not found.",
    "code": "not_found"
  }
}