Gemini 3.7 Flash është tani në dispozicion. Provojeni .

Kjo faqe është përkthyer nga Cloud Translation API.

Gemini Triggers API

Shkaktuesit ju lejojnë të planifikoni ekzekutimet e agjentëve në një orar cron, duke mundësuar detyra të automatizuara dhe të përsëritura.

Shiko si ulje Shikoni Specifikimin OpenAPI

Krijo Shkaktuesin

postoni https://generativelanguage.googleapis.com/v1beta/triggers

Krijon një shkaktar të ri që do të thirrë agjentin e specifikuar në orarin e dhënë të cron-it.

Trupi i kërkesës
Përgjigje

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

vargu i emrit të_shfaqjes (opsional)

Opsionale. Emri i shfaqur i shkaktarit.

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për ekzekutimin e shkrehësit.

numër i plotë i ekzekutimit_kohë_out_sekondave (opsionale)

Opsionale. Koha e ekzekutimit për ndërveprimin e shkaktuar.

bashkëveprim CreateAgentInteractionParams ose CreateModelInteractionParams (e detyrueshme)

E detyrueshme. Shablloni i kërkesës së ndërveprimit që do të ekzekutohet.

max_consecutive_failures numër i plotë (opsional)

Opsionale. Numri maksimal i dështimeve të njëpasnjëshme të lejuara përpara se shkaktari të ndalet automatikisht (statusi bëhet ERROR).

vargu i orarit (i detyrueshëm)

E detyrueshme. Orari cron në të cilin duhet të ekzekutohet shkaktari. Formati standard cron.

vargu i zonës_kohore (i detyrueshëm)

E detyrueshme. Zona kohore në të cilën duhet të interpretohet orari.

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

numër i plotë consecutive_failure_count (opsional)

Vetëm rezultati. Numri i dështimeve të njëpasnjëshme që kanë ndodhur që nga ekzekutimi i fundit i suksesshëm.

vargu create_time (opsional)

Vetëm rezultati. Koha kur u krijua shkaktari.

vargu i emrit të_shfaqjes (opsional)

Opsionale. Emri i shfaqur i shkaktarit.

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për ekzekutimin e shkrehësit.

numër i plotë i ekzekutimit_kohë_out_sekondave (opsionale)

Opsionale. Koha e ekzekutimit për ndërveprimin e shkaktuar.

vargu i identifikimit (opsional)

E detyrueshme. Vetëm rezultat. Identifikues. ID-ja e shkaktarit.

ndërveprim Ndërveprim (opsional)

E detyrueshme. Shablloni i kërkesës së ndërveprimit që do të ekzekutohet.

Fushat

agjenti i agjentit (opsionale)

Emri i `Agjentit` të përdorur për gjenerimin e ndërveprimit.

Vlerat e mundshme

deep-research-pro-preview-12-2025
Agjent i Kërkimeve të Thellë Gemini
deep-research-preview-04-2026
Agjent i Kërkimeve të Thellë Gemini
deep-research-max-preview-04-2026
Agjenti Maksimal i Kërkimeve të Thellë Gemini
antigravity-preview-05-2026
Përdorni agjentin e menaxhuar Antigravity për të kryer detyra me shumë hapa që kërkojnë arsyetim, operacione me skedarë dhe përdorim mjetesh.

objekti agent_config (opsional)

Parametrat e konfigurimit për bashkëveprimin e agjentit.

Llojet e mundshme

Diskriminuesi polimorfik: type

Konfigurimi i Agjentit Antigravity

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

CodeMenderAgentConfig

Konfigurimi për agjentin CodeMender.

find_request GjejKërkesë (opsionale)

Parametrat për gjetjen e dobësive.

Fushat

varg përshkrimi (opsional)

Kontekst shtesë ose udhëzime të personalizuara të ofruara nga përdoruesi për të udhëhequr analizën e cenueshmërisë.

vargu finding_id (opsional)

Identifikuesi i një gjetjeje specifike që duhet verifikuar. Kjo përdoret kryesisht në modalitetin VERIFY për të përqendruar validimin e agjentit bazuar në ekzekutim në një dobësi të vetme.

enumimi i modalitetit (vargu) (opsional)

Modaliteti i seancës së gjetjes.

Vlerat e mundshme:

scan
Skanim i shpejtë duke përdorur vetëm klasifikuesin fillestar.
verify
Kryen klasifikimin e ndjekur nga një hetim i detajuar.

vargu source_files (FileContent) (opsionale)

Një listë e skedarëve burimorë për t'u ofruar si kontekst për skanimin.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja e tekstit të koduar UTF-8 e skedarit.

vargu i shtegut (opsional)

Shtegu relativ i skedarit nga rrënja e projektit.

fix_request FixRequest (opsionale)

Parametrat për rregullimin e dobësive.

Fushat

varg përshkrimi (opsional)

Kontekst shtesë ose udhëzime të personalizuara të ofruara nga përdoruesi për të udhëhequr procesin e gjenerimit të patch-it.

vargu finding_id (opsional)

Identifikuesi i gjetjes specifike të sigurisë që duhet të ndreqet. Ky ID lidhet me një dobësi të zbuluar më parë.

vargu source_files (FileContent) (opsionale)

Një listë e skedarëve burimorë që ofrojnë kontekst për korrigjimin. Këto skedarë janë zakonisht ato që përmbajnë dobësinë e identifikuar.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja e tekstit të koduar UTF-8 e skedarit.

vargu i shtegut (opsional)

Shtegu relativ i skedarit nga rrënja e projektit.

varg modeli (opsional)

Emri i modelit që do të përdoret për agjentin CodeMender. Një seancë CodeMender do të përdorë vetëm një model.

session_config SessionConfig (opsionale)

Konfigurime opsionale specifike për sesionin për të anashkaluar sjelljen e parazgjedhur të agjentit.

Fushat

numër i plotë max_rounds (opsional)

Numri maksimal i raundeve të ndërveprimit që agjenti lejohet të kryejë përpara se të arrijë një skadencë kohore.

vargu i session_id (opsional)

Parametër për grupimin e ndërveprimeve të shumëfishta që i përkasin të njëjtit sesion CodeMender.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code-mender" .

DeepResearchAgentConfig

Konfigurimi për agjentin e Kërkimit të Thellë.

boolean i planifikimit_bashkëpunues (opsional)

Aktivizon planifikimin njerëzor në ciklin e punës për agjentin e Kërkimit të Thellë. Nëse vendoset në "e vërtetë", agjenti i Kërkimit të Thellë do të ofrojë një plan kërkimi në përgjigjen e tij. Agjenti do të vazhdojë vetëm nëse përdoruesi e konfirmon planin në raundin tjetër.

enable_bigquery_tool boolean (opsional)

Aktivizon mjetin bigquery për agjentin e Kërkimit të Thellë.

thinking_summaries Përmbledhje të të Menduarit (opsionale)

Nëse do të përfshihen përmbledhje të mendimeve në përgjigje.

Vlerat e mundshme

auto
Përmbledhje të të menduarit automatik.
none
Pa përmbledhje të të menduarit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur për "deep-research" .

numërimi i vizualizimit (varg) (opsional)

Nëse do të përfshihen vizualizime në përgjigje.

Vlerat e mundshme:

off
Mos përfshini vizualizime.
auto
Përfshi automatikisht vizualizimet.

Konfigurimi i Agjentit Dinamike

Konfigurimi për agjentë dinamikë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "dynamic" .

varg i krijuar (opsional)

Vetëm rezultati. Ora në të cilën u krijua përgjigja në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

mjedisi EnvironmentConfig ose vargu (opsional)

Konfigurimi i mjedisit për bashkëveprimin. Mund të jetë një objekt që specifikon burimet e largëta të mjedisit ose një varg që i referohet një ID-je ekzistuese të mjedisit.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Llojet e mundshme

objekt

Konfigurimi i rrjetit dalës për sandbox-in. Kur specifikohet, kufizon se cilat domene të jashtme mund të arrijë sandbox-i. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim të kokës.

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Lista e domeneve të lejuara dalëse. Lejohen vetëm kërkesat për domenet e listuara. Përdorni [{'domain': '*'}] për të lejuar të gjitha domenet, ndërkohë që ende injektohen tituj në ato specifike.

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

disabled
Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

gcs
Një kovë Ruajtjeje në Cloud.
inline
Përmbajtje e integruar.
repository
Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).
skill_registry
Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

vargu environment_id (opsional)

Vetëm rezultati. ID-ja e mjedisit për bashkëveprimin. Plotësohet vetëm nëse konfigurimi i mjedisit është vendosur në kërkesë.

varg gabimesh (Gabim) (opsional)

Vetëm rezultate. Gabime diagnostikuese / gabime të platformës të regjistruara në bashkëveprim.

Fushat

varg kodi (opsional)

Një URI që identifikon llojin e gabimit.

varg mesazhi (opsional)

Një mesazh gabimi i lexueshëm nga njeriu.

vargu i identifikimit (opsional)

E detyrueshme. Vetëm rezultat. Një identifikues unik për përfundimin e ndërveprimit.

Parazgjedhur në:

futni Përmbajtje ose varg (Content) ose varg (Step) ose varg (opsional)

Të dhënat hyrëse për bashkëveprimin.

objekt etiketash (opsional)

Etiketat me meta të dhëna të përcaktuara nga përdoruesi për kërkesën.

modeli ModelOpsioni (opsional)

Emri i `Modelit` të përdorur për gjenerimin e ndërveprimit.

Vlerat e mundshme

gemini-2.5-flash
Modeli ynë i parë hibrid i arsyetimit i cili mbështet një dritare konteksti prej 1M token dhe ka buxhete të të menduarit.
gemini-2.5-pro
Modeli ynë shumëfunksional i teknologjisë së fundit, i cili shkëlqen në kodim dhe detyra komplekse arsyetimi.
gemma-4-26b-a4b-it
Gemma 4 26B A4B IT
gemma-4-31b-it
Gemma 4 31B IT
gemini-flash-latest
Versioni më i fundit i Gemini Flash
gemini-flash-lite-latest
Versioni më i fundit i Gemini Flash-Lite
gemini-pro-latest
Versioni më i fundit i Gemini Pro
gemini-2.5-flash-lite
Modeli ynë më i vogël dhe më ekonomik, i ndërtuar për përdorim në shkallë të gjerë.
gemini-2.5-flash-image
Modeli ynë i gjenerimit të imazheve vendase, i optimizuar për shpejtësi, fleksibilitet dhe kuptim kontekstual. Futja dhe dalja e tekstit ka të njëjtin çmim si në Flash 2.5.
gemini-3-flash-preview
Modeli ynë më inteligjent i ndërtuar për shpejtësi, duke kombinuar inteligjencën kufitare me kërkimin dhe tokëzimin superior.
gemini-3.1-pro-preview
Modeli ynë më i fundit i arsyetimit SOTA me thellësi dhe nuancë të paparë, si dhe aftësi të fuqishme të të kuptuarit dhe kodimit multimodal.
gemini-3.1-pro-preview-customtools
Gemini 3.1 Pro Preview i optimizuar për përdorim të mjeteve të personalizuara
gemini-3.1-flash-lite
Modeli ynë më me kosto efektive, i optimizuar për detyra agjentike me vëllim të lartë, përkthim dhe përpunim të thjeshtë të të dhënave.
gemini-3-pro-image
Imazh i Gemini 3 Pro
nano-banana-pro-preview
Pamje paraprake e imazhit të Gemini 3 Pro
gemini-3.1-flash-image
Imazh Blic i Gemini 3.1.
gemini-3.5-flash
Modeli ynë më inteligjent për performancë të qëndrueshme në kufijtë e detyrave agjentike dhe të kodimit.
gemini-3.6-flash
Modeli ynë më inteligjent për performancë të qëndrueshme në kufijtë e detyrave agjentike dhe të kodimit.
gemini-3.7-flash
Modeli ynë më inteligjent për performancë të qëndrueshme në kufijtë e detyrave agjentike dhe të kodimit.
lyria-3-clip-preview
Modeli ynë i gjenerimit të muzikës me latencë të ulët është i optimizuar për klipe audio me besnikëri të lartë dhe kontroll të saktë ritmik.
lyria-3-pro-preview
Modeli ynë i avancuar, gjenerues i këngëve të plota, me kuptim të thellë kompozicioni, i optimizuar për kontroll të saktë strukturor dhe tranzicione komplekse nëpër stile të ndryshme muzikore.
gemini-robotics-er-1.6-preview
Pamje paraprake e Gemini Robotics-ER 1.6
gemini-robotics-er-2-preview
Parapamje e Rezonancës së Mishëruar të Gemini Robotics 2

output_audio AudioContent (opsionale)

Audioja e fundit e gjeneruar nga modeli në përgjigje të kërkesës aktuale. Shënim: kjo është shtuar nga SDK.

Fushat

numër i plotë i kanaleve (opsionale)

Numri i kanaleve audio.

varg të dhënash (opsionale)

Përmbajtja audio.

mime_type enum (string) (opsionale)

Lloji i mimikës i audios.

Vlerat e mundshme:

audio/wav
Formati audio WAV
audio/mp3
Formati audio MP3
audio/aiff
Formati audio AIFF
audio/aac
Formati audio AAC
audio/ogg
Formati audio OGG
audio/flac
Formati audio FLAC
audio/mpeg
Formati audio MPEG
audio/m4a
Formati audio M4A
audio/l16
Formati audio L16
audio/opus
Formati audio OPUS
audio/alaw
Formati audio ALAW
audio/mulaw
Formati audio MULAW

numër i plotë i shkallës së_sample-it (opsional)

Shpejtësia e mostrës së audios.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "audio" .

vargu uri (opsional)

URI-ja e audios.

output_image ImageContent (opsionale)

Imazhi i fundit i gjeneruar nga modeli në përgjigje të kërkesës aktuale. Shënim: kjo është shtuar nga SDK.

Fushat

varg të dhënash (opsionale)

Përmbajtja e imazhit.

mime_type enum (string) (opsionale)

Lloji i mimikës së imazhit.

Vlerat e mundshme:

image/png
Formati i imazhit PNG
image/jpeg
Formati i imazhit JPEG
image/webp
Formati i imazhit WebP
image/heic
Formati i imazhit HEIC
image/heif
Formati i imazhit HEIF
image/gif
Formati i imazhit GIF
image/bmp
Formati i imazhit BMP
image/tiff
Formati i imazhit TIFF

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme

low
Rezolucion i ulët.
medium
Rezolucion i mesëm.
high
Rezolucion i lartë.
ultra_high
Rezolucion ultra i lartë.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "image" .

vargu uri (opsional)

URI-ja e imazhit.

vargu i tekstit_të_outputit (opsional)

Tekst i bashkuar nga rezultati i fundit i modelit në përgjigje të kërkesës aktuale. Shënim: kjo është shtuar nga SDK.

output_video VideoContent (opsionale)

Videoja e fundit e gjeneruar nga modeli në përgjigje të kërkesës aktuale. Shënim: kjo është shtuar nga SDK.

Fushat

varg të dhënash (opsionale)

Përmbajtja e videos.

mime_type enum (string) (opsionale)

Lloji i mimikës së videos.

Vlerat e mundshme:

video/mp4
Formati i videos MP4
video/mpeg
Formati i videos MPEG
video/mpg
Formati i videos MPG
video/mov
Formati i videos MOV
video/avi
Formati i videos AVI
video/x-flv
Formati i videos FLV
video/webm
Formati i videos WebM
video/wmv
Formati i videos WMV
video/3gpp
Formati i videos 3GPP

përpunimi i MediaProcessing ose enum (string) (opsionale)

Si e përpunon modeli këtë video për ta kuptuar.

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme

low
Rezolucion i ulët.
medium
Rezolucion i mesëm.
high
Rezolucion i lartë.
ultra_high
Rezolucion ultra i lartë.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "video" .

vargu uri (opsional)

URI-ja e videos.

vargu previous_interaction_id (opsional)

ID-ja e ndërveprimit të mëparshëm, nëse ka.

response_format ResponseFormat ose varg (ResponseFormat) (opsionale)

Zbaton që përgjigjja e gjeneruar të jetë një objekt JSON që përputhet me skemën JSON të specifikuar në këtë fushë.

Llojet e mundshme

Formati i Përgjigjes Audio

Konfigurimi për formatin e daljes audio.

numër i plotë bit_rate (opsional)

Shpejtësia e transmetimit të biteve në bit për sekondë (bps). I zbatueshëm vetëm për formatet e kompresuara (MP3, Opus).

numërimi i dorëzimit (vargu) (opsional)

Modaliteti i dërgimit për daljen audio.

Vlerat e mundshme:

inline
Të dhënat audio kthehen brenda përgjigjes.
uri
Të dhënat audio kthehen si një URI.

mime_type enum (string) (opsionale)

Lloji MIME i daljes audio.

Vlerat e mundshme:

audio/mp3
Formati audio MP3.
audio/ogg_opus
Formati audio OGG Opus.
audio/l16
Formati audio i papërpunuar PCM (L16).
audio/wav
Formati audio WAV.
audio/alaw
Formati audio A-law.
audio/mulaw
Formati audio Mu-law.

numër i plotë i shkallës së_sample-it (opsional)

Shpejtësia e mostrës në Hz.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "audio" .

Formati i Përgjigjes së Imazhit

Konfigurimi për formatin e daljes së imazhit.

numërimi i raportit_të_aspectit (varg) (opsional)

Raporti i aspektit për rezultatin e imazhit.

Vlerat e mundshme:

1:1
Raporti i aspektit 1:1.
2:3
Raporti i aspektit 2:3.
3:2
Raporti i aspektit 3:2.
3:4
Raporti i aspektit 3:4.
4:3
Raporti i aspektit 4:3.
4:5
Raporti i aspektit 4:5.
5:4
Raporti i aspektit 5:4.
9:16
Raporti i aspektit 9:16.
16:9
Raporti i aspektit 16:9.
21:9
Raporti i aspektit 21:9.
1:8
Raporti i aspektit 1:8.
8:1
Raporti i aspektit 8:1.
1:4
Raporti i aspektit 1:4.
4:1
Raporti i aspektit 4:1.

numërimi i dorëzimit (vargu) (opsional)

Modaliteti i dorëzimit për rezultatin e imazhit.

Vlerat e mundshme:

inline
Të dhënat e imazhit kthehen brenda rreshtit në përgjigje.
uri
Të dhënat e imazhit kthehen si një URI.

enumimi i madhësisë_së_imazhit (string) (opsional)

Madhësia e imazhit të dalë.

Vlerat e mundshme:

512
Madhësia e imazhit 512px.
1K
Madhësia e imazhit 1K.
2K
Madhësia e imazhit 2K.
4K
Madhësia e imazhit 4K.

mime_type enum (string) (opsionale)

Lloji MIME i rezultatit të imazhit.

Vlerat e mundshme:

image/jpeg
Formati i imazhit JPEG.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "image" .

Formati i Përgjigjes së Tekstit

Konfigurimi për formatin e daljes së tekstit.

mime_type enum (string) (opsionale)

Lloji MIME i rezultatit të tekstit.

Vlerat e mundshme:

application/json
Formati i daljes JSON.
text/plain
Formati i daljes së tekstit të thjeshtë.

objekt skeme (opsional)

Skema JSON me të cilën duhet të përputhet rezultati. I zbatueshëm vetëm kur mime_type është application/json.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "text" .

Formati i Përgjigjes Video

Konfigurimi për formatin e daljes së videos.

numërimi i raportit_të_aspectit (varg) (opsional)

Raporti i aspektit për daljen e videos.

Vlerat e mundshme:

16:9
Raporti i aspektit 16:9.
9:16
Raporti i aspektit 9:16.

numërimi i dorëzimit (vargu) (opsional)

Modaliteti i dërgimit për daljen e videos.

Vlerat e mundshme:

inline
Të dhënat e videos kthehen brenda përgjigjes.
uri
Të dhënat e videos kthehen si një URI.

vargu i kohëzgjatjes (opsional)

Kohëzgjatja për daljen e videos.

vargu gcs_uri (opsional)

URI-ja e Ruajtjes në Cloud për të ruajtur daljen e videos. E nevojshme për Vertex nëse modaliteti i dorëzimit është URI.

numërimi i rezolucionit (varg) (opsional)

Rezolucioni i daljes së videos. Parazgjedhja është 720p.

Vlerat e mundshme:

360p
Rezolucion 360p.
720p
Rezolucion 720p.
1080p
Rezolucion 1080p.
4k
Rezolucion 4K.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "video" .

vargu i cilësimeve_të_safety-t (SafetySetting) (opsionale)

Cilësimet e sigurisë për bashkëveprimin.

Fushat

enum i metodës (string) (opsionale)

Opsionale. Metoda për bllokimin e përmbajtjes. Nëse nuk specifikohet, sjellja e parazgjedhur është përdorimi i rezultatit të probabilitetit.

Vlerat e mundshme:

severity
Metoda e bllokut të dëmit përdor si rezultatet e probabilitetit ashtu edhe të ashpërsisë.
probability
Metoda e bllokut të dëmit përdor rezultatin e probabilitetit.

numërimi i pragut (vargu) (opsional)

E detyrueshme. Pragu për bllokimin e përmbajtjes. Nëse probabiliteti i dëmit tejkalon këtë prag, përmbajtja do të bllokohet.

Vlerat e mundshme:

block_low_and_above
Blloko përmbajtjen me një probabilitet të ulët ose më të lartë dëmtimi.
block_medium_and_above
Blloko përmbajtjen me një probabilitet dëmtimi mesatar ose më të lartë.
block_only_high
Blloko përmbajtjen me një probabilitet të lartë dëmtimi.
block_none
Mos bllokoni asnjë përmbajtje, pavarësisht nga probabiliteti i dëmtimit të saj.
off
Fikeni plotësisht filtrin e sigurisë.

lloji HarmCategory (opsionale)

E detyrueshme. Lloji i kategorisë së dëmit që do të bllokohet.

Vlerat e mundshme

hate_speech
Përmbajtje që promovon dhunën ose nxit urrejtje kundër individëve ose grupeve bazuar në atribute të caktuara.
dangerous_content
Përmbajtje që promovon, lehtëson ose mundëson aktivitete të rrezikshme.
harassment
Përmbajtje abuzive, kërcënuese ose që synon të ngacmojë, torturojë ose tallë.
sexually_explicit
Përmbajtje që përmban materiale me përmbajtje seksuale eksplicite.
civic_integrity
I vjetruar: Filtri zgjedhor nuk mbështetet më. Kategoria e dëmit është integriteti qytetar.
image_hate
Imazhe që përmbajnë gjuhë urrejtjeje.
image_dangerous_content
Imazhe që përmbajnë përmbajtje të rrezikshme.
image_harassment
Imazhe që përmbajnë ngacmim.
image_sexually_explicit
Imazhe që përmbajnë përmbajtje të qartë seksuale.
jailbreak
Kërkesa të dizajnuara për të anashkaluar filtrat e sigurisë.

niveli_i_shërbimit Niveli_i_Shërbimit (opsional)

Niveli i shërbimit për bashkëveprimin.

Vlerat e mundshme

flex
Niveli i shërbimit fleksibël.
standard
Niveli standard i shërbimit.
priority
Niveli i shërbimit me përparësi.
deferred
Niveli i shërbimit të shtyrë.

numërimi i statusit (varg) (opsional)

E detyrueshme. Vetëm rezultat. Statusi i ndërveprimit.

Vlerat e mundshme:

in_progress
Ndërveprimi është në zhvillim e sipër.
requires_action
Ndërveprimi kërkon veprim/input nga përdoruesi.
completed
Ndërveprimi është përfunduar.
failed
Ndërveprimi dështoi.
cancelled
Ndërveprimi u anulua.
incomplete
Ndërveprimi është përfunduar, por përmban rezultate të paplota (p.sh., duke shtypur max_tokens).
budget_exceeded
Ndërveprimi u ndalua sepse buxheti i tokenit u tejkalua.
queued
Ndërveprimi është në radhë, duke pritur për përpunim.

varg hapash (Hapi) (opsional)

Vetëm rezultati. Hapat që përbëjnë bashkëveprimin, kur përfshihen në përgjigje.

Llojet e mundshme

CodeExecutionCallStep

Hapi i thirrjes së ekzekutimit të kodit.

argumentet CodeExecutionCallStepArguments (e detyrueshme)

E detyrueshme. Argumentet që do të kalohen në ekzekutimin e kodit.

Fushat

varg kodi (opsional)

Kodi që do të ekzekutohet.

enumimi i gjuhës (string) (opsional)

Gjuha e programimit të `kodit`.

Vlerat e mundshme:

python
Python >= 3.10, me numpy dhe simpy të disponueshëm.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution_call" .

Hapi i Rezultatit të Ekzekutimit të Kodit

Hapi i rezultatit të ekzekutimit të kodit.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

is_error boolean (opsionale)

Nëse ekzekutimi i kodit rezultoi në një gabim.

varg rezultati (i detyrueshëm)

E detyrueshme. Rezultati i ekzekutimit të kodit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution_result" .

FileSearchCallStep

Hapi i thirrjes së Kërkimit të Skedarit.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_search_call" .

FileSearchResultStep

Hapi i rezultatit të kërkimit të skedarëve.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_search_result" .

Hapi i Thirrjes së Funksionit

Një hap i thirrjes së mjetit të funksionit.

argumente objekt (i detyrueshëm)

E detyrueshme. Argumentet që duhen kaluar te funksioni.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg emri (i detyrueshëm)

E detyrueshme. Emri i mjetit që do të thirret.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function_call" .

FunctionResultStep

Rezultati i një thirrjeje të mjetit të funksionit.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

is_error boolean (opsionale)

Nëse thirrja e mjetit rezultoi në një gabim.

varg emri (opsional)

Emri i mjetit që u thirr.

varg rezultatesh (ImageContent ose TextContent) ose objekt ose varg (i detyrueshëm)

E detyrueshme. Rezultati i thirrjes së mjetit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function_result" .

GoogleMapsCallStep

Hapi i thirrjes së Google Maps.

argumentet GoogleMapsCallStepArguments (opsionale)

Argumentet për t'i kaluar mjetit Google Maps.

Fushat

varg pyetjesh (varg) (opsional)

Pyetjet që do të ekzekutohen.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_maps_call" .

Hapi i Rezultateve të GoogleMaps

Hapi i rezultatit të Google Maps.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg rezultatesh (GoogleMapsResultItem) (i detyrueshëm)

Nuk është dhënë përshkrim.

Fushat

varg vendesh (GoogleMapsResultPlaces) (opsionale)

Nuk është dhënë përshkrim.

Fushat

varg emri (opsional)

Nuk është dhënë përshkrim.

vargu place_id (opsional)

Nuk është dhënë përshkrim.

vargu review_snippets (ReviewSnippet) (opsionale)

Nuk është dhënë përshkrim.

Fushat

vargu review_id (opsional)

ID-ja e fragmentit të rishikimit.

vargu i titullit (opsional)

Titulli i rishikimit.

vargu i url- së (opsional)

Një lidhje që korrespondon me vlerësimin e përdoruesit në Google Maps.

vargu i url- së (opsional)

Nuk është dhënë përshkrim.

vargu i shenjës së widget_context_token (opsional)

Nuk është dhënë përshkrim.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_maps_result" .

GoogleSearchCallStep

Hapi i thirrjes së Kërkimit në Google.

argumente GoogleSearchCallStepArguments (e detyrueshme)

E detyrueshme. Argumentet që duhen kaluar te Kërkimi në Google.

Fushat

varg pyetjesh (varg) (opsional)

Pyetje kërkimi në internet për kërkimin pasues në internet.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

enumimi i tipit_të_kërkimit (string) (opsional)

Lloji i bazës së kërkimit të aktivizuar.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search_call" .

Hapi i Rezultateve të Kërkimit në Google

Hapi i rezultatit të Kërkimit në Google.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

is_error boolean (opsionale)

Nëse Kërkimi në Google rezultoi në një gabim.

varg rezultatesh (GoogleSearchResultItem) (i detyrueshëm)

E detyrueshme. Rezultatet e Kërkimit në Google.

Fushat

vargu i sugjerimeve të kërkimit (opsional)

Fragment përmbajtjeje uebi që mund të integrohet në një faqe uebi ose në një pamje uebi të aplikacionit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search_result" .

McpServerToolCallStep

Hapi i thirrjes së mjetit MCPServer.

argumente objekt (i detyrueshëm)

E detyrueshme. Objekti JSON i argumenteve për funksionin.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg emri (i detyrueshëm)

E detyrueshme. Emri i mjetit që u thirr.

vargu i emrit të serverit (i detyrueshëm)

E detyrueshme. Emri i serverit MCP të përdorur.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server_tool_call" .

McpServerToolResultStep

Hapi i rezultatit të mjetit MCPServer.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

varg emri (opsional)

Emri i mjetit që thirret për këtë thirrje specifike të mjetit.

varg rezultatesh (ImageContent ose TextContent) ose objekt ose varg (i detyrueshëm)

E detyrueshme. Dalja nga thirrja e serverit MCP. Mund të jetë tekst i thjeshtë ose përmbajtje e pasur.

vargu i emrit të serverit (opsional)

Emri i serverit MCP të përdorur.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server_tool_result" .

Hapi i Prodhimit të Modelit

Rezultati i gjeneruar nga modeli.

vargu i përmbajtjes (Përmbajtja) (opsionale)

Nuk është dhënë përshkrim.

Llojet e mundshme

Përmbajtje Audio

Një bllok përmbajtjeje audio.

numër i plotë i kanaleve (opsionale)

Numri i kanaleve audio.

varg të dhënash (opsionale)

Përmbajtja audio.

mime_type enum (string) (opsionale)

Lloji i mimikës i audios.

Vlerat e mundshme:

audio/wav
Formati audio WAV
audio/mp3
Formati audio MP3
audio/aiff
Formati audio AIFF
audio/aac
Formati audio AAC
audio/ogg
Formati audio OGG
audio/flac
Formati audio FLAC
audio/mpeg
Formati audio MPEG
audio/m4a
Formati audio M4A
audio/l16
Formati audio L16
audio/opus
Formati audio OPUS
audio/alaw
Formati audio ALAW
audio/mulaw
Formati audio MULAW

numër i plotë i shkallës së_sample-it (opsional)

Shpejtësia e mostrës së audios.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "audio" .

vargu uri (opsional)

URI-ja e audios.

Përmbajtja e Dokumentit

Një bllok përmbajtjeje dokumenti.

varg të dhënash (opsionale)

Përmbajtja e dokumentit.

mime_type enum (string) (opsionale)

Lloji mime i dokumentit.

Vlerat e mundshme:

application/pdf
Formati i dokumentit PDF
text/csv
Formati i dokumentit CSV

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "document" .

vargu uri (opsional)

URI-ja e dokumentit.

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

varg të dhënash (opsionale)

Përmbajtja e imazhit.

mime_type enum (string) (opsionale)

Lloji i mimikës së imazhit.

Vlerat e mundshme:

image/png
Formati i imazhit PNG
image/jpeg
Formati i imazhit JPEG
image/webp
Formati i imazhit WebP
image/heic
Formati i imazhit HEIC
image/heif
Formati i imazhit HEIF
image/gif
Formati i imazhit GIF
image/bmp
Formati i imazhit BMP
image/tiff
Formati i imazhit TIFF

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme

low
Rezolucion i ulët.
medium
Rezolucion i mesëm.
high
Rezolucion i lartë.
ultra_high
Rezolucion ultra i lartë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "image" .

vargu uri (opsional)

URI-ja e imazhit.

Përmbajtje Teksti

Një bllok përmbajtjeje teksti.

vargu i shënimeve (Shënim) (opsional)

Informacion mbi citimin për përmbajtjen e gjeneruar nga modeli.

Llojet e mundshme

FileCitation

Një shënim citimi i skedarit.

objekti custom_metadata (opsional)

Përdoruesi dha meta të dhëna rreth kontekstit të marrë.

vargu document_uri (opsional)

URI-ja e skedarit.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

vargu i emrit të skedarit (opsional)

Emri i skedarit.

vargu media_id (opsional)

ID e medias në rast të citimeve të imazheve, nëse ka.

numër i plotë i faqes (opsional)

Numri i faqes së dokumentit të cituar, nëse ka.

vargu burimor (opsional)

Burimi i atribuuar për një pjesë të tekstit.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_citation" .

Citimi i Vendit

Një shënim citimi vendi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

varg emri (opsional)

Titulli i vendit.

vargu place_id (opsional)

ID-ja e vendit, në formatin `places/{place_id}`.

vargu review_snippets (ReviewSnippet) (opsionale)

Fragmente të vlerësimeve që përdoren për të gjeneruar përgjigje rreth karakteristikave të një vendi të caktuar në Google Maps.

Fushat

vargu review_id (opsional)

ID-ja e fragmentit të rishikimit.

vargu i titullit (opsional)

Titulli i rishikimit.

vargu i url- së (opsional)

Një lidhje që korrespondon me vlerësimin e përdoruesit në Google Maps.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "place_citation" .

vargu i url- së (opsional)

Referenca URI e vendit.

Citimi i Url-it

Një shënim citimi URL-je.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

vargu i titullit (opsional)

Titulli i URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_citation" .

vargu i url- së (opsional)

URL-ja.

WordInfo

Shënim ASR në nivel fjale për daljen e transkriptimit. Përmban tekstin e fjalës, kohën opsionale dhe atribuimin opsional të folësit.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

vargu end_offset (opsional)

Zhvendosja e fundit në kohën e fjalës në lidhje me fillimin e audios. Paraqitet kur timestamp_granularities përmban "fjalën".

varg altoparlanti (opsional)

Opsionale. Etiketa e folësit për këtë fjalë (p.sh. "spk_1", "spk_2"). E pranishme kur diarization_mode është vendosur në TranscriptionConfig.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

vargu start_offset (opsional)

Zhvendosja fillestare në kohën e fjalës në lidhje me fillimin e audios. Paraqitet kur timestamp_granularities përmban "fjalën".

varg teksti (opsional)

Fjala e transkriptuar.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "word_info" .

varg teksti (i detyrueshëm)

E detyrueshme. Përmbajtja e tekstit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "text" .

Përmbajtje Video

Një bllok përmbajtjeje video.

varg të dhënash (opsionale)

Përmbajtja e videos.

mime_type enum (string) (opsionale)

Lloji i mimikës së videos.

Vlerat e mundshme:

video/mp4
Formati i videos MP4
video/mpeg
Formati i videos MPEG
video/mpg
Formati i videos MPG
video/mov
Formati i videos MOV
video/avi
Formati i videos AVI
video/x-flv
Formati i videos FLV
video/webm
Formati i videos WebM
video/wmv
Formati i videos WMV
video/3gpp
Formati i videos 3GPP

përpunimi i MediaProcessing ose enum (string) (opsionale)

Si e përpunon modeli këtë video për ta kuptuar.

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme

low
Rezolucion i ulët.
medium
Rezolucion i mesëm.
high
Rezolucion i lartë.
ultra_high
Rezolucion ultra i lartë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "video" .

vargu uri (opsional)

URI-ja e videos.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "model_output" .

ThoughtStep

Një hap i menduar.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

varg përmbledhës (ThoughtSummaryContent) (opsionale)

Një përmbledhje e mendimit.

Llojet e mundshme

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

varg të dhënash (opsionale)

Përmbajtja e imazhit.

mime_type enum (string) (opsionale)

Lloji i mimikës së imazhit.

Vlerat e mundshme:

image/png
Formati i imazhit PNG
image/jpeg
Formati i imazhit JPEG
image/webp
Formati i imazhit WebP
image/heic
Formati i imazhit HEIC
image/heif
Formati i imazhit HEIF
image/gif
Formati i imazhit GIF
image/bmp
Formati i imazhit BMP
image/tiff
Formati i imazhit TIFF

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme

low
Rezolucion i ulët.
medium
Rezolucion i mesëm.
high
Rezolucion i lartë.
ultra_high
Rezolucion ultra i lartë.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "image" .

vargu uri (opsional)

URI-ja e imazhit.

Përmbajtje Teksti

Një bllok përmbajtjeje teksti.

vargu i shënimeve (Shënim) (opsional)

Informacion mbi citimin për përmbajtjen e gjeneruar nga modeli.

Llojet e mundshme

FileCitation

Një shënim citimi i skedarit.

objekti custom_metadata (opsional)

Përdoruesi dha meta të dhëna rreth kontekstit të marrë.

vargu document_uri (opsional)

URI-ja e skedarit.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

vargu i emrit të skedarit (opsional)

Emri i skedarit.

vargu media_id (opsional)

ID e medias në rast të citimeve të imazheve, nëse ka.

numër i plotë i faqes (opsional)

Numri i faqes së dokumentit të cituar, nëse ka.

vargu burimor (opsional)

Burimi i atribuuar për një pjesë të tekstit.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "file_citation" .

Citimi i Vendit

Një shënim citimi vendi.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

varg emri (opsional)

Titulli i vendit.

vargu place_id (opsional)

ID-ja e vendit, në formatin `places/{place_id}`.

vargu review_snippets (ReviewSnippet) (opsionale)

Fragmente të vlerësimeve që përdoren për të gjeneruar përgjigje rreth karakteristikave të një vendi të caktuar në Google Maps.

Fushat

vargu review_id (opsional)

ID-ja e fragmentit të rishikimit.

vargu i titullit (opsional)

Titulli i rishikimit.

vargu i url- së (opsional)

Një lidhje që korrespondon me vlerësimin e përdoruesit në Google Maps.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "place_citation" .

vargu i url- së (opsional)

Referenca URI e vendit.

Citimi i Url-it

Një shënim citimi URL-je.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

vargu i titullit (opsional)

Titulli i URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_citation" .

vargu i url- së (opsional)

URL-ja.

WordInfo

Shënim ASR në nivel fjale për daljen e transkriptimit. Përmban tekstin e fjalës, kohën opsionale dhe atribuimin opsional të folësit.

numër i plotë end_index (opsional)

Fundi i segmentit të atribuuar, ekskluziv.

vargu end_offset (opsional)

Zhvendosja e fundit në kohën e fjalës në lidhje me fillimin e audios. Paraqitet kur timestamp_granularities përmban "fjalën".

varg altoparlanti (opsional)

Opsionale. Etiketa e folësit për këtë fjalë (p.sh. "spk_1", "spk_2"). E pranishme kur diarization_mode është vendosur në TranscriptionConfig.

numër i plotë i indeksit_fillues (opsional)

Fillimi i segmentit të përgjigjes që i atribuohet këtij burimi. Indeksi tregon fillimin e segmentit, i matur në bajt.

vargu start_offset (opsional)

Zhvendosja fillestare në kohën e fjalës në lidhje me fillimin e audios. Paraqitet kur timestamp_granularities përmban "fjalën".

varg teksti (opsional)

Fjala e transkriptuar.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "word_info" .

varg teksti (i detyrueshëm)

E detyrueshme. Përmbajtja e tekstit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "text" .

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "thought" .

UrlContextCallStep

Hapi i thirrjes së kontekstit të URL-së.

argumentet UrlContextCallArguments (e detyrueshme)

E detyrueshme. Argumentet që duhen kaluar në kontekstin e URL-së.

Fushat

vargu i URL -ve (string) (opsional)

URL-të që duhen marrë.

vargu i identifikimit (i detyrueshëm)

E detyrueshme. Një ID unike për këtë thirrje specifike të mjetit.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context_call" .

UrlContextResultStep

Hapi i rezultatit të kontekstit të URL-së.

vargu call_id (i detyrueshëm)

E detyrueshme. ID që përputhet me ID-në nga blloku i thirrjes së funksionit.

is_error boolean (opsionale)

Nëse konteksti i URL-së rezultoi në një gabim.

varg rezultatesh (UrlContextResult) (i detyrueshëm)

E detyrueshme. Rezultatet e kontekstit të URL-së.

Fushat

numërimi i statusit (varg) (opsional)

Statusi i rikthimit të URL-së.

Vlerat e mundshme:

success
Marrja e URL-së është kryer me sukses.
error
Marrja e URL-së dështoi për shkak të një gabimi.
paywall
Marrja e URL-së dështoi sepse përmbajtja është pas murit të pagesës.
unsafe
Marrja e URL-së dështoi sepse përmbajtja është e pasigurt.

vargu i url- së (opsional)

URL-ja që u mor.

varg nënshkrimi (opsional)

Një hash nënshkrimi për validimin e backend-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context_result" .

Hapi i Hyrjes së Përdoruesit

Të dhëna të dhëna nga përdoruesi.

vargu i përmbajtjes (Përmbajtja) (opsionale)

Nuk është dhënë përshkrim.

Llojet e mundshme

Përmbajtje Audio

Një bllok përmbajtjeje audio.

numër i plotë i kanaleve (opsionale)

Numri i kanaleve audio.

varg të dhënash (opsionale)

Përmbajtja audio.

mime_type enum (string) (opsionale)

Lloji i mimikës i audios.

Vlerat e mundshme:

audio/wav
Formati audio WAV
audio/mp3
Formati audio MP3
audio/aiff
Formati audio AIFF
audio/aac
Formati audio AAC
audio/ogg
Formati audio OGG
audio/flac
Formati audio FLAC
audio/mpeg
Formati audio MPEG
audio/m4a
Formati audio M4A
audio/l16
Formati audio L16
audio/opus
Formati audio OPUS
audio/alaw
Formati audio ALAW
audio/mulaw
Formati audio MULAW

numër i plotë i shkallës së_sample-it (opsional)

Shpejtësia e mostrës së audios.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "audio" .

vargu uri (opsional)

URI-ja e audios.

Përmbajtja e Dokumentit

Një bllok përmbajtjeje dokumenti.

varg të dhënash (opsionale)

Përmbajtja e dokumentit.

mime_type enum (string) (opsionale)

Lloji mime i dokumentit.

Vlerat e mundshme:

application/pdf
Formati i dokumentit PDF
text/csv
Formati i dokumentit CSV

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "document" .

vargu uri (opsional)

URI-ja e dokumentit.

Përmbajtje Imazhesh

Një bllok përmbajtjeje imazhi.

varg të dhënash (opsionale)

Përmbajtja e imazhit.

mime_type enum (string) (opsionale)

Lloji i mimikës së imazhit.

Vlerat e mundshme:

image/png
Formati i imazhit PNG
image/jpeg
Formati i imazhit JPEG
image/webp
Formati i imazhit WebP
image/heic
Formati i imazhit HEIC
image/heif
Formati i imazhit HEIF
image/gif
Formati i imazhit GIF
image/bmp
Formati i imazhit BMP
image/tiff
Formati i imazhit TIFF

rezolucioni i MediaResolution (opsional)

Zgjidhja e mediave.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoContent

A video content block.

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "user_input" .

vargu i udhëzimit_të_sistem-it (opsional)

System instruction for the interaction.

tools array (Tool) (optional)

A list of tool declarations the model may call during interaction.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

ComputerUse

A tool that can be used by the model to interact with the computer.

disabled_safety_policies array (enum (string)) (optional)

Optional. Disabled safety policies for computer use.

Vlerat e mundshme:

financial_transactions
Safety policy for financial transactions.
sensitive_data_modification
Safety policy for sensitive data modification.
communication_tool
Safety policy for communication tools (eg Gmail, Chat, Meet).
account_creation
Safety policy for account creation.
data_modification
Safety policy for data modification.
user_consent_management
Safety policy for user consent management.
legal_terms_and_agreements
Safety policy for legal terms and agreements.

enable_prompt_injection_detection boolean (optional)

Whether enable the prompt injection detection check on computer-use request.

environment enum (string) (optional)

The environment being operated.

Vlerat e mundshme:

browser
Operates in a web browser.
mobile
Operates in a mobile environment.
desktop
Operates in a desktop environment.

excluded_predefined_functions array (string) (optional)

The list of predefined functions that are excluded from the model call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "computer_use" .

FileSearch

A tool that can be used by the model to search files.

file_search_store_names array (string) (optional)

The file search store names to search.

metadata_filter string (optional)

Metadata filter to apply to the semantic retrieval documents and chunks.

top_k integer (optional)

The number of semantic retrieval chunks to retrieve.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

GoogleMaps

A tool that can be used by the model to call Google Maps.

enable_widget boolean (optional)

Whether to return a widget context token in the tool call result of the response.

latitude number (optional)

The latitude of the user's location.

longitude number (optional)

The longitude of the user's location.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

auto
Zgjedhja e mjetit automatik.
any
Çdo zgjedhje mjeti.
none
Pa zgjedhje mjetesh.
validated
Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Retrieval

A tool that can be used by the model to retrieve files.

exa_ai_search_config ExaAISearchConfig (optional)

Used to specify configuration for ExaAISearch.

Fushat

api_key string (optional)

Required. The API key for ExaAiSearch.

custom_config object (optional)

Optional. This field can be used to pass any parameter from the Exa.ai Search API.

parallel_ai_search_config ParallelAISearchConfig (optional)

Used to specify configuration for ParallelAISearch.

Fushat

api_key string (optional)

Optional. The API key for ParallelAiSearch.

custom_config object (optional)

Optional. Custom configs for ParallelAiSearch.

rag_store_config RagStoreConfig (optional)

Used to specify configuration for RagStore.

Fushat

rag_resources array (RagResource) (optional)

Optional. The representation of the rag source.

Fushat

rag_corpus string (optional)

Optional. RagCorpora resource name.

rag_file_ids array (string) (optional)

Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.

rag_retrieval_config RagRetrievalConfig (optional)

Optional. The retrieval config for the Rag query.

Fushat

filter Filter (optional)

Optional. Config for filters.

Fushat

metadata_filter string (optional)

Optional. String for metadata filtering.

vector_distance_threshold number (optional)

Optional. Only returns contexts with vector distance smaller than the threshold.

vector_similarity_threshold number (optional)

Optional. Only returns contexts with vector similarity larger than the threshold.

hybrid_search HybridSearch (optional)

Optional. Config for Hybrid Search.

Fushat

alpha number (optional)

Optional. Alpha value controls the weight between dense and sparse vector search results.

ranking Ranking (optional)

Optional. Config for ranking and reranking.

top_k integer (optional)

Optional. The number of contexts to retrieve.

retrieval_types array (enum (string)) (optional)

The types of file retrieval to enable.

Vlerat e mundshme:

rag_store
exa_ai_search
parallel_ai_search

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "retrieval" .

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .

updated string (optional)

Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

usage Usage (optional)

Output only. Statistics on the interaction request's token usage.

Fushat

cached_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of cached token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

grounding_tool_count array (GroundingToolCount) (optional)

Grounding tool count.

Fushat

count integer (optional)

The number of grounding tool counts.

tipi enum (string) (opsionale)

The grounding tool type associated with the count.

Vlerat e mundshme:

google_search
Grounding with Google Web Search and Image Search, & Web Grounding for Enterprise.
google_maps
Grounding with Google Maps.
retrieval
Grounding with customer's data, for example, VertexAISearch.

input_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of input token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

output_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of output token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

tool_use_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of tool-use token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

total_cached_tokens integer (optional)

Number of tokens in the cached part of the prompt (the cached content).

total_input_tokens integer (optional)

Number of tokens in the prompt (context).

total_output_tokens integer (optional)

Total number of tokens across all the generated responses.

total_thought_tokens integer (optional)

Number of tokens of thoughts for thinking models.

total_tokens integer (optional)

Total token count for the interaction request (prompt + responses + other internal tokens).

total_tool_use_tokens integer (optional)

Number of tokens present in tool-use prompt(s).

webhook_config WebhookConfig (optional)

Optional. Webhook configuration for receiving notifications when the interaction completes.

Fushat

uris array (string) (optional)

Optional. If set, these webhook URIs will be used for webhook events instead of the registered webhooks.

user_metadata object (optional)

Optional. The user metadata that will be returned on each event emission to the webhooks.

last_pause_time string (optional)

Output only. The time when the trigger was last paused.

last_resume_time string (optional)

Output only. The time when the trigger was last resumed.

last_run_time string (optional)

Output only. The time when the trigger was last run.

max_consecutive_failures integer (optional)

Optional. The maximum number of consecutive failures allowed before the trigger is automatically paused (status becomes ERROR).

next_run_time string (optional)

Output only. The time when the trigger is scheduled to run next.

previous_interaction_id string (optional)

Output only. The ID of the last interaction created by this trigger.

schedule string (optional)

Required. The cron schedule on which the trigger should run. Standard cron format.

status enum (string) (optional)

Output only. The current status of the trigger.

Vlerat e mundshme:

active
The trigger is active and will fire on schedule.
paused
The trigger is paused and will not fire.
error
The trigger has entered an error state due to consecutive failures.

time_zone string (optional)

Required. Time zone in which the schedule should be interpreted.

update_time string (optional)

Output only. The time when the trigger was last updated.

Shembull

Shembull Përgjigjeje

{
  "consecutive_failure_count": 0,
  "create_time": "string",
  "display_name": "string",
  "environment_id": "string",
  "execution_timeout_seconds": 0,
  "id": "string",
  "interaction": {
    "created": "2025-12-04T15:01:45Z",
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3.6-flash",
    "object": "interaction",
    "status": "completed",
    "steps": [
      {
        "type": "model_output",
        "content": [
          {
            "type": "text",
            "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?"
          }
        ]
      }
    ],
    "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
    }
  },
  "last_pause_time": "string",
  "last_resume_time": "string",
  "last_run_time": "string",
  "max_consecutive_failures": 0,
  "next_run_time": "string",
  "previous_interaction_id": "string",
  "schedule": "string",
  "status": "active",
  "time_zone": "string",
  "update_time": "string"
}

RunTrigger

post https://generativelanguage.googleapis.com/v1beta/triggers/{trigger_id}/executions

Runs a trigger immediately.

Përgjigje

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

end_time string (optional)

Output only. The time when the execution finished.

vargu environment_id (opsional)

Output only. The environment ID used for the execution.

error string (optional)

Output only. The error message if the execution failed.

vargu i identifikimit (opsional)

Required. Output only. Identifier. The ID of the trigger execution.

interaction_id string (optional)

Output only. The ID of the interaction created by this execution, if any.

scheduled_time string (optional)

Output only. The time when the execution was scheduled to run.

start_time string (optional)

Output only. The time when the execution started.

status enum (string) (optional)

Output only. The status of the execution.

Vlerat e mundshme:

in_progress
The execution is currently in progress.
completed
The execution completed successfully.
failed
The execution failed.
skipped
The execution was skipped (eg, previous execution still running).
timed_out
The execution timed out.

trigger_id string (optional)

Required. Output only. Identifier. The ID of the trigger that created this execution.

Shembull

Shembull Përgjigjeje

{
  "end_time": "string",
  "environment_id": "string",
  "error": "string",
  "id": "string",
  "interaction_id": "string",
  "scheduled_time": "string",
  "start_time": "string",
  "status": "in_progress",
  "trigger_id": "string"
}

ListTriggers

get https://generativelanguage.googleapis.com/v1beta/triggers

Lists triggers for a project.

Parametrat e shtegut / pyetjes
Përgjigje

Parametrat e Shtegut / Pyetjes

filter string (optional)

Optional. Filter expression (eg, by state).

numër i plotë i madhësisë së faqes (opsional)

Optional. The maximum number of triggers to return per page.

vargu i shenjës së faqes (opsional)

Optional. A page token from a previous ListTriggers call.

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

vargu i shenjës së faqes_next_page (opsional)

A page token, received from a previous `ListTriggers` call. Provide this to retrieve the subsequent page.

triggers array ( Trigger ) (optional)

The list of triggers.

Shembull

Shembull Përgjigjeje

{
  "next_page_token": "string",
  "triggers": [
    {
      "consecutive_failure_count": 0,
      "create_time": "string",
      "display_name": "string",
      "environment_id": "string",
      "execution_timeout_seconds": 0,
      "id": "string",
      "interaction": {
        "created": "2025-12-04T15:01:45Z",
        "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
        "model": "gemini-3.6-flash",
        "object": "interaction",
        "status": "completed",
        "steps": [
          {
            "type": "model_output",
            "content": [
              {
                "type": "text",
                "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?"
              }
            ]
          }
        ],
        "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
        }
      },
      "last_pause_time": "string",
      "last_resume_time": "string",
      "last_run_time": "string",
      "max_consecutive_failures": 0,
      "next_run_time": "string",
      "previous_interaction_id": "string",
      "schedule": "string",
      "status": "active",
      "time_zone": "string",
      "update_time": "string"
    }
  ]
}

GetTrigger

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

Gets details of a single trigger.

Përgjigje

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

consecutive_failure_count integer (optional)

Output only. The number of consecutive failures that have occurred since the last successful execution.

create_time string (optional)

Output only. The time when the trigger was created.

display_name string (optional)

Optional. The display name of the trigger.

vargu environment_id (opsional)

Optional. The environment ID for the trigger execution.

execution_timeout_seconds integer (optional)

Optional. The execution timeout for the triggered interaction.

vargu i identifikimit (opsional)

Required. Output only. Identifier. The ID of the trigger.

interaction Interaction (optional)

Required. The interaction request template to be executed.

Fushat

agent AgentOption (optional)

The name of the `Agent` used for generating the interaction.

Vlerat e mundshme

deep-research-pro-preview-12-2025
Gemini Deep Research Agent
deep-research-preview-04-2026
Gemini Deep Research Agent
deep-research-max-preview-04-2026
Gemini Deep Research Max Agent
antigravity-preview-05-2026
Use the Antigravity managed agent to perform multi-step tasks that require reasoning, file operations, and tool use.

agent_config object (optional)

Configuration parameters for the agent interaction.

Llojet e mundshme

Polymorphic discriminator: type

AntigravityAgentConfig

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

CodeMenderAgentConfig

Configuration for the CodeMender agent.

find_request FindRequest (optional)

Parameters for finding vulnerabilities.

Fushat

varg përshkrimi (opsional)

Additional context or custom instructions provided by the user to guide the vulnerability analysis.

finding_id string (optional)

The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.

enumimi i modalitetit (vargu) (opsional)

The mode of the find session.

Vlerat e mundshme:

scan
Fast scan using only the initial classifier.
verify
Performs classification followed by detailed investigation.

source_files array (FileContent) (optional)

A list of source files to provide as context for the scan.

Fushat

varg përmbajtjeje (opsionale)

The UTF-8 encoded text content of the file.

path string (optional)

The relative path of the file from the project root.

fix_request FixRequest (optional)

Parameters for fixing vulnerabilities.

Fushat

varg përshkrimi (opsional)

Additional context or custom instructions provided by the user to guide the patch generation process.

finding_id string (optional)

The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.

source_files array (FileContent) (optional)

A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.

Fushat

varg përmbajtjeje (opsionale)

The UTF-8 encoded text content of the file.

path string (optional)

The relative path of the file from the project root.

varg modeli (opsional)

The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.

session_config SessionConfig (optional)

Optional session-specific configurations to override default agent behavior.

Fushat

max_rounds integer (optional)

The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.

session_id string (optional)

Parameter for grouping multiple interactions that belong to the same CodeMender session.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code-mender" .

DeepResearchAgentConfig

Configuration for the Deep Research agent.

collaborative_planning boolean (optional)

Enables human-in-the-loop planning for the Deep Research agent. If set to true, the Deep Research agent will provide a research plan in its response. The agent will then proceed only if the user confirms the plan in the next turn.

enable_bigquery_tool boolean (optional)

Enables bigquery tool for the Deep Research agent.

thinking_summaries ThinkingSummaries (optional)

Whether to include thought summaries in the response.

Vlerat e mundshme

auto
Auto thinking summaries.
none
No thinking summaries.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "deep-research" .

visualization enum (string) (optional)

Whether to include visualizations in the response.

Vlerat e mundshme:

off
Do not include visualizations.
auto
Automatically include visualizations.

DynamicAgentConfig

Configuration for dynamic agents.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "dynamic" .

created string (optional)

Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

environment EnvironmentConfig or string (optional)

The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Llojet e mundshme

objekt

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

disabled
Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

gcs
Një kovë Ruajtjeje në Cloud.
inline
Përmbajtje e integruar.
repository
Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).
skill_registry
Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

vargu environment_id (opsional)

Output only. The environment ID for the interaction. Only populated if environment config is set in the request.

errors array (Error) (optional)

Output only. Diagnostic faults / platform errors recorded on the interaction.

Fushat

code string (optional)

A URI that identifies the error type.

message string (optional)

A human-readable error message.

vargu i identifikimit (opsional)

Required. Output only. A unique identifier for the interaction completion.

Defaults to:

input Content or array (Content) or array (Step) or string (optional)

The input for the interaction.

labels object (optional)

The labels with user-defined metadata for the request.

model ModelOption (optional)

The name of the `Model` used for generating the interaction.

Vlerat e mundshme

gemini-2.5-flash
Our first hybrid reasoning model which supports a 1M token context window and has thinking budgets.
gemini-2.5-pro
Our state-of-the-art multipurpose model, which excels at coding and complex reasoning tasks.
gemma-4-26b-a4b-it
Gemma 4 26B A4B IT
gemma-4-31b-it
Gemma 4 31B IT
gemini-flash-latest
Latest release of Gemini Flash
gemini-flash-lite-latest
Latest release of Gemini Flash-Lite
gemini-pro-latest
Latest release of Gemini Pro
gemini-2.5-flash-lite
Our smallest and most cost effective model, built for at scale usage.
gemini-2.5-flash-image
Our native image generation model, optimized for speed, flexibility, and contextual understanding. Text input and output is priced the same as 2.5 Flash.
gemini-3-flash-preview
Our most intelligent model built for speed, combining frontier intelligence with superior search and grounding.
gemini-3.1-pro-preview
Our latest SOTA reasoning model with unprecedented depth and nuance, and powerful multimodal understanding and coding capabilities.
gemini-3.1-pro-preview-customtools
Gemini 3.1 Pro Preview optimized for custom tool usage
gemini-3.1-flash-lite
Our most cost-efficient model, optimized for high-volume agentic tasks, translation, and simple data processing.
gemini-3-pro-image
Gemini 3 Pro Image
nano-banana-pro-preview
Gemini 3 Pro Image Preview
gemini-3.1-flash-image
Gemini 3.1 Flash Image.
gemini-3.5-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
gemini-3.6-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
gemini-3.7-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
lyria-3-clip-preview
Our low-latency, music generation model optimized for high-fidelity audio clips and precise rhythmic control.
lyria-3-pro-preview
Our advanced, full-song generative model with deep compositional understanding, optimized for precise structural control and complex transitions across diverse musical styles.
gemini-robotics-er-1.6-preview
Gemini Robotics-ER 1.6 Preview
gemini-robotics-er-2-preview
Gemini Robotics Embodied Reasoning 2 Preview

output_audio AudioContent (optional)

The last audio generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

output_image ImageContent (optional)

The last image generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

output_text string (optional)

Concatenated text from the last model output in response to the current request. Note: this is added by the SDK.

output_video VideoContent (optional)

The last video generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

previous_interaction_id string (optional)

The ID of the previous interaction, if any.

response_format ResponseFormat or array (ResponseFormat) (optional)

Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.

Llojet e mundshme

AudioResponseFormat

Configuration for audio output format.

bit_rate integer (optional)

Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).

delivery enum (string) (optional)

The delivery mode for the audio output.

Vlerat e mundshme:

inline
Audio data is returned inline in the response.
uri
Audio data is returned as a URI.

mime_type enum (string) (optional)

The MIME type of the audio output.

Vlerat e mundshme:

audio/mp3
MP3 audio format.
audio/ogg_opus
OGG Opus audio format.
audio/l16
Raw PCM (L16) audio format.
audio/wav
WAV audio format.
audio/alaw
A-law audio format.
audio/mulaw
Mu-law audio format.

sample_rate integer (optional)

Sample rate in Hz.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

ImageResponseFormat

Configuration for image output format.

aspect_ratio enum (string) (optional)

The aspect ratio for the image output.

Vlerat e mundshme:

1:1
1:1 aspect ratio.
2:3
2:3 aspect ratio.
3:2
3:2 aspect ratio.
3:4
3:4 aspect ratio.
4:3
4:3 aspect ratio.
4:5
4:5 aspect ratio.
5:4
5:4 aspect ratio.
9:16
9:16 aspect ratio.
16:9
16:9 aspect ratio.
21:9
21:9 aspect ratio.
1:8
1:8 aspect ratio.
8:1
8:1 aspect ratio.
1:4
1:4 aspect ratio.
4:1
4:1 aspect ratio.

delivery enum (string) (optional)

The delivery mode for the image output.

Vlerat e mundshme:

inline
Image data is returned inline in the response.
uri
Image data is returned as a URI.

image_size enum (string) (optional)

The size of the image output.

Vlerat e mundshme:

512
512px image size.
1K
1K image size.
2K
2K image size.
4K
4K image size.

mime_type enum (string) (optional)

The MIME type of the image output.

Vlerat e mundshme:

image/jpeg
JPEG image format.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

TextResponseFormat

Configuration for text output format.

mime_type enum (string) (optional)

The MIME type of the text output.

Vlerat e mundshme:

application/json
JSON output format.
text/plain
Plain text output format.

schema object (optional)

The JSON schema that the output should conform to. Only applicable when mime_type is application/json.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoResponseFormat

Configuration for video output format.

aspect_ratio enum (string) (optional)

The aspect ratio for the video output.

Vlerat e mundshme:

16:9
16:9 aspect ratio.
9:16
9:16 aspect ratio.

delivery enum (string) (optional)

The delivery mode for the video output.

Vlerat e mundshme:

inline
Video data is returned inline in the response.
uri
Video data is returned as a URI.

duration string (optional)

The duration for the video output.

gcs_uri string (optional)

The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.

resolution enum (string) (optional)

The video output resolution. Defaults to 720p.

Vlerat e mundshme:

360p
360p resolution.
720p
720p resolution.
1080p
1080p resolution.
4k
4K resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

safety_settings array (SafetySetting) (optional)

Safety settings for the interaction.

Fushat

method enum (string) (optional)

Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.

Vlerat e mundshme:

severity
The harm block method uses both probability and severity scores.
probability
The harm block method uses the probability score.

threshold enum (string) (optional)

Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.

Vlerat e mundshme:

block_low_and_above
Block content with a low harm probability or higher.
block_medium_and_above
Block content with a medium harm probability or higher.
block_only_high
Block content with a high harm probability.
block_none
Do not block any content, regardless of its harm probability.
off
Turn off the safety filter entirely.

type HarmCategory (optional)

Required. The type of harm category to be blocked.

Vlerat e mundshme

hate_speech
Content that promotes violence or incites hatred against individuals or groups based on certain attributes.
dangerous_content
Content that promotes, facilitates, or enables dangerous activities.
harassment
Abusive, threatening, or content intended to bully, torment, or ridicule.
sexually_explicit
Content that contains sexually explicit material.
civic_integrity
Deprecated: Election filter is not longer supported. The harm category is civic integrity.
image_hate
Images that contain hate speech.
image_dangerous_content
Images that contain dangerous content.
image_harassment
Images that contain harassment.
image_sexually_explicit
Images that contain sexually explicit content.
jailbreak
Prompts designed to bypass safety filters.

service_tier ServiceTier (optional)

The service tier for the interaction.

Vlerat e mundshme

flex
Flex service tier.
standard
Standard service tier.
priority
Priority service tier.
deferred
Deferred service tier.

status enum (string) (optional)

Required. Output only. The status of the interaction.

Vlerat e mundshme:

in_progress
The interaction is in progress.
requires_action
The interaction requires action/input from the user.
completed
The interaction is completed.
failed
The interaction failed.
cancelled
The interaction was cancelled.
incomplete
The interaction is completed, but contains incomplete results (eg hitting max_tokens).
budget_exceeded
The interaction was halted because the token budget was exceeded.
queued
The interaction is queued, waiting for processing.

steps array (Step) (optional)

Output only. The steps that make up the interaction, when included in the response.

Llojet e mundshme

CodeExecutionCallStep

Code execution call step.

arguments CodeExecutionCallStepArguments (required)

Required. The arguments to pass to the code execution.

Fushat

code string (optional)

The code to be executed.

language enum (string) (optional)

Programming language of the `code`.

Vlerat e mundshme:

python
Python >= 3.10, with numpy and simpy available.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code_execution_call" .

CodeExecutionResultStep

Code execution result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the code execution resulted in an error.

result string (required)

Required. The output of the code execution.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code_execution_result" .

FileSearchCallStep

File Search call step.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search_call" .

FileSearchResultStep

File Search result step.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search_result" .

FunctionCallStep

A function tool call step.

arguments object (required)

Required. The arguments to pass to the function.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

name string (required)

Required. The name of the tool to call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "function_call" .

FunctionResultStep

Result of a function tool call.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the tool call resulted in an error.

varg emri (opsional)

The name of the tool that was called.

result array (ImageContent or TextContent) or object or string (required)

Required. The result of the tool call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "function_result" .

GoogleMapsCallStep

Google Maps call step.

arguments GoogleMapsCallStepArguments (optional)

The arguments to pass to the Google Maps tool.

Fushat

queries array (string) (optional)

The queries to be executed.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps_call" .

GoogleMapsResultStep

Google Maps result step.

call_id string (required)

Required. ID to match the ID from the function call block.

result array (GoogleMapsResultItem) (required)

Nuk është dhënë përshkrim.

Fushat

places array (GoogleMapsResultPlaces) (optional)

Nuk është dhënë përshkrim.

Fushat

varg emri (opsional)

Nuk është dhënë përshkrim.

place_id string (optional)

Nuk është dhënë përshkrim.

review_snippets array (ReviewSnippet) (optional)

Nuk është dhënë përshkrim.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

vargu i url- së (opsional)

Nuk është dhënë përshkrim.

widget_context_token string (optional)

Nuk është dhënë përshkrim.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps_result" .

GoogleSearchCallStep

Google Search call step.

arguments GoogleSearchCallStepArguments (required)

Required. The arguments to pass to Google Search.

Fushat

queries array (string) (optional)

Web search queries for the following-up web search.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

search_type enum (string) (optional)

The type of search grounding enabled.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_search_call" .

GoogleSearchResultStep

Google Search result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the Google Search resulted in an error.

result array (GoogleSearchResultItem) (required)

Required. The results of the Google Search.

Fushat

search_suggestions string (optional)

Web content snippet that can be embedded in a web page or an app webview.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_search_result" .

McpServerToolCallStep

MCPServer tool call step.

arguments object (required)

Required. The JSON object of arguments for the function.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

name string (required)

Required. The name of the tool which was called.

server_name string (required)

Required. The name of the used MCP server.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "mcp_server_tool_call" .

McpServerToolResultStep

MCPServer tool result step.

call_id string (required)

Required. ID to match the ID from the function call block.

varg emri (opsional)

Name of the tool which is called for this specific tool call.

result array (ImageContent or TextContent) or object or string (required)

Required. The output from the MCP server call. Can be simple text or rich content.

server_name string (optional)

The name of the used MCP server.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "mcp_server_tool_result" .

ModelOutputStep

Output generated by the model.

content array (Content) (optional)

Nuk është dhënë përshkrim.

Llojet e mundshme

AudioContent

An audio content block.

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

DocumentContent

A document content block.

data string (optional)

The document content.

mime_type enum (string) (optional)

The mime type of the document.

Vlerat e mundshme:

application/pdf
PDF document format
text/csv
CSV document format

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "document" .

uri string (optional)

The URI of the document.

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoContent

A video content block.

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "model_output" .

ThoughtStep

A thought step.

signature string (optional)

A signature hash for backend validation.

summary array (ThoughtSummaryContent) (optional)

A summary of the thought.

Llojet e mundshme

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "thought" .

UrlContextCallStep

URL context call step.

arguments UrlContextCallArguments (required)

Required. The arguments to pass to the URL context.

Fushat

urls array (string) (optional)

The URLs to fetch.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_context_call" .

UrlContextResultStep

URL context result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the URL context resulted in an error.

result array (UrlContextResult) (required)

Required. The results of the URL context.

Fushat

status enum (string) (optional)

The status of the URL retrieval.

Vlerat e mundshme:

success
Url retrieval is successful.
error
Url retrieval is failed due to error.
paywall
Url retrieval is failed because the content is behind paywall.
unsafe
Url retrieval is failed because the content is unsafe.

vargu i url- së (opsional)

The URL that was fetched.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_context_result" .

UserInputStep

Input provided by the user.

content array (Content) (optional)

Nuk është dhënë përshkrim.

Llojet e mundshme

AudioContent

An audio content block.

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

DocumentContent

A document content block.

data string (optional)

The document content.

mime_type enum (string) (optional)

The mime type of the document.

Vlerat e mundshme:

application/pdf
PDF document format
text/csv
CSV document format

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "document" .

uri string (optional)

The URI of the document.

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoContent

A video content block.

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "user_input" .

vargu i udhëzimit_të_sistem-it (opsional)

System instruction for the interaction.

tools array (Tool) (optional)

A list of tool declarations the model may call during interaction.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

ComputerUse

A tool that can be used by the model to interact with the computer.

disabled_safety_policies array (enum (string)) (optional)

Optional. Disabled safety policies for computer use.

Vlerat e mundshme:

financial_transactions
Safety policy for financial transactions.
sensitive_data_modification
Safety policy for sensitive data modification.
communication_tool
Safety policy for communication tools (eg Gmail, Chat, Meet).
account_creation
Safety policy for account creation.
data_modification
Safety policy for data modification.
user_consent_management
Safety policy for user consent management.
legal_terms_and_agreements
Safety policy for legal terms and agreements.

enable_prompt_injection_detection boolean (optional)

Whether enable the prompt injection detection check on computer-use request.

environment enum (string) (optional)

The environment being operated.

Vlerat e mundshme:

browser
Operates in a web browser.
mobile
Operates in a mobile environment.
desktop
Operates in a desktop environment.

excluded_predefined_functions array (string) (optional)

The list of predefined functions that are excluded from the model call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "computer_use" .

FileSearch

A tool that can be used by the model to search files.

file_search_store_names array (string) (optional)

The file search store names to search.

metadata_filter string (optional)

Metadata filter to apply to the semantic retrieval documents and chunks.

top_k integer (optional)

The number of semantic retrieval chunks to retrieve.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

GoogleMaps

A tool that can be used by the model to call Google Maps.

enable_widget boolean (optional)

Whether to return a widget context token in the tool call result of the response.

latitude number (optional)

The latitude of the user's location.

longitude number (optional)

The longitude of the user's location.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

auto
Zgjedhja e mjetit automatik.
any
Çdo zgjedhje mjeti.
none
Pa zgjedhje mjetesh.
validated
Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Retrieval

A tool that can be used by the model to retrieve files.

exa_ai_search_config ExaAISearchConfig (optional)

Used to specify configuration for ExaAISearch.

Fushat

api_key string (optional)

Required. The API key for ExaAiSearch.

custom_config object (optional)

Optional. This field can be used to pass any parameter from the Exa.ai Search API.

parallel_ai_search_config ParallelAISearchConfig (optional)

Used to specify configuration for ParallelAISearch.

Fushat

api_key string (optional)

Optional. The API key for ParallelAiSearch.

custom_config object (optional)

Optional. Custom configs for ParallelAiSearch.

rag_store_config RagStoreConfig (optional)

Used to specify configuration for RagStore.

Fushat

rag_resources array (RagResource) (optional)

Optional. The representation of the rag source.

Fushat

rag_corpus string (optional)

Optional. RagCorpora resource name.

rag_file_ids array (string) (optional)

Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.

rag_retrieval_config RagRetrievalConfig (optional)

Optional. The retrieval config for the Rag query.

Fushat

filter Filter (optional)

Optional. Config for filters.

Fushat

metadata_filter string (optional)

Optional. String for metadata filtering.

vector_distance_threshold number (optional)

Optional. Only returns contexts with vector distance smaller than the threshold.

vector_similarity_threshold number (optional)

Optional. Only returns contexts with vector similarity larger than the threshold.

hybrid_search HybridSearch (optional)

Optional. Config for Hybrid Search.

Fushat

alpha number (optional)

Optional. Alpha value controls the weight between dense and sparse vector search results.

ranking Ranking (optional)

Optional. Config for ranking and reranking.

top_k integer (optional)

Optional. The number of contexts to retrieve.

retrieval_types array (enum (string)) (optional)

The types of file retrieval to enable.

Vlerat e mundshme:

rag_store
exa_ai_search
parallel_ai_search

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "retrieval" .

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .

updated string (optional)

Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

usage Usage (optional)

Output only. Statistics on the interaction request's token usage.

Fushat

cached_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of cached token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

grounding_tool_count array (GroundingToolCount) (optional)

Grounding tool count.

Fushat

count integer (optional)

The number of grounding tool counts.

tipi enum (string) (opsionale)

The grounding tool type associated with the count.

Vlerat e mundshme:

google_search
Grounding with Google Web Search and Image Search, & Web Grounding for Enterprise.
google_maps
Grounding with Google Maps.
retrieval
Grounding with customer's data, for example, VertexAISearch.

input_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of input token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

output_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of output token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

tool_use_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of tool-use token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

total_cached_tokens integer (optional)

Number of tokens in the cached part of the prompt (the cached content).

total_input_tokens integer (optional)

Number of tokens in the prompt (context).

total_output_tokens integer (optional)

Total number of tokens across all the generated responses.

total_thought_tokens integer (optional)

Number of tokens of thoughts for thinking models.

total_tokens integer (optional)

Total token count for the interaction request (prompt + responses + other internal tokens).

total_tool_use_tokens integer (optional)

Number of tokens present in tool-use prompt(s).

webhook_config WebhookConfig (optional)

Optional. Webhook configuration for receiving notifications when the interaction completes.

Fushat

uris array (string) (optional)

Optional. If set, these webhook URIs will be used for webhook events instead of the registered webhooks.

user_metadata object (optional)

Optional. The user metadata that will be returned on each event emission to the webhooks.

last_pause_time string (optional)

Output only. The time when the trigger was last paused.

last_resume_time string (optional)

Output only. The time when the trigger was last resumed.

last_run_time string (optional)

Output only. The time when the trigger was last run.

max_consecutive_failures integer (optional)

Optional. The maximum number of consecutive failures allowed before the trigger is automatically paused (status becomes ERROR).

next_run_time string (optional)

Output only. The time when the trigger is scheduled to run next.

previous_interaction_id string (optional)

Output only. The ID of the last interaction created by this trigger.

schedule string (optional)

Required. The cron schedule on which the trigger should run. Standard cron format.

status enum (string) (optional)

Output only. The current status of the trigger.

Vlerat e mundshme:

active
The trigger is active and will fire on schedule.
paused
The trigger is paused and will not fire.
error
The trigger has entered an error state due to consecutive failures.

time_zone string (optional)

Required. Time zone in which the schedule should be interpreted.

update_time string (optional)

Output only. The time when the trigger was last updated.

Shembull

Shembull Përgjigjeje

{
  "consecutive_failure_count": 0,
  "create_time": "string",
  "display_name": "string",
  "environment_id": "string",
  "execution_timeout_seconds": 0,
  "id": "string",
  "interaction": {
    "created": "2025-12-04T15:01:45Z",
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3.6-flash",
    "object": "interaction",
    "status": "completed",
    "steps": [
      {
        "type": "model_output",
        "content": [
          {
            "type": "text",
            "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?"
          }
        ]
      }
    ],
    "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
    }
  },
  "last_pause_time": "string",
  "last_resume_time": "string",
  "last_run_time": "string",
  "max_consecutive_failures": 0,
  "next_run_time": "string",
  "previous_interaction_id": "string",
  "schedule": "string",
  "status": "active",
  "time_zone": "string",
  "update_time": "string"
}

ListTriggerExecutions

get https://generativelanguage.googleapis.com/v1beta/triggers/{trigger_id}/executions

Lists executions for a trigger.

Parametrat e shtegut / pyetjes
Përgjigje

Parametrat e Shtegut / Pyetjes

numër i plotë i madhësisë së faqes (opsional)

Optional. The maximum number of executions to return per page.

vargu i shenjës së faqes (opsional)

Optional. A page token from a previous ListTriggerExecutions call.

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

vargu i shenjës së faqes_next_page (opsional)

A page token, received from a previous `ListTriggerExecutions` call. Provide this to retrieve the subsequent page.

trigger_executions array (TriggerExecution) (optional)

The list of trigger executions.

Fushat

end_time string (optional)

Output only. The time when the execution finished.

vargu environment_id (opsional)

Output only. The environment ID used for the execution.

error string (optional)

Output only. The error message if the execution failed.

vargu i identifikimit (opsional)

Required. Output only. Identifier. The ID of the trigger execution.

interaction_id string (optional)

Output only. The ID of the interaction created by this execution, if any.

scheduled_time string (optional)

Output only. The time when the execution was scheduled to run.

start_time string (optional)

Output only. The time when the execution started.

status enum (string) (optional)

Output only. The status of the execution.

Vlerat e mundshme:

in_progress
The execution is currently in progress.
completed
The execution completed successfully.
failed
The execution failed.
skipped
The execution was skipped (eg, previous execution still running).
timed_out
The execution timed out.

trigger_id string (optional)

Required. Output only. Identifier. The ID of the trigger that created this execution.

Shembull

Shembull Përgjigjeje

{
  "next_page_token": "string",
  "trigger_executions": [
    {
      "end_time": "string",
      "environment_id": "string",
      "error": "string",
      "id": "string",
      "interaction_id": "string",
      "scheduled_time": "string",
      "start_time": "string",
      "status": "in_progress",
      "trigger_id": "string"
    }
  ]
}

UpdateTrigger

patch https://generativelanguage.googleapis.com/v1beta/triggers/{id}

Updates a trigger.

Trupi i kërkesës
Përgjigje

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

display_name string (optional)

Optional. The display name of the trigger.

status enum (string) (optional)

Optional. The status of the trigger.

Vlerat e mundshme:

active
The trigger is active and will fire on schedule.
paused
The trigger is paused and will not fire.
error
The trigger has entered an error state due to consecutive failures.

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

consecutive_failure_count integer (optional)

Output only. The number of consecutive failures that have occurred since the last successful execution.

create_time string (optional)

Output only. The time when the trigger was created.

display_name string (optional)

Optional. The display name of the trigger.

vargu environment_id (opsional)

Optional. The environment ID for the trigger execution.

execution_timeout_seconds integer (optional)

Optional. The execution timeout for the triggered interaction.

vargu i identifikimit (opsional)

Required. Output only. Identifier. The ID of the trigger.

interaction Interaction (optional)

Required. The interaction request template to be executed.

Fushat

agent AgentOption (optional)

The name of the `Agent` used for generating the interaction.

Vlerat e mundshme

deep-research-pro-preview-12-2025
Gemini Deep Research Agent
deep-research-preview-04-2026
Gemini Deep Research Agent
deep-research-max-preview-04-2026
Gemini Deep Research Max Agent
antigravity-preview-05-2026
Use the Antigravity managed agent to perform multi-step tasks that require reasoning, file operations, and tool use.

agent_config object (optional)

Configuration parameters for the agent interaction.

Llojet e mundshme

Polymorphic discriminator: type

AntigravityAgentConfig

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

CodeMenderAgentConfig

Configuration for the CodeMender agent.

find_request FindRequest (optional)

Parameters for finding vulnerabilities.

Fushat

varg përshkrimi (opsional)

Additional context or custom instructions provided by the user to guide the vulnerability analysis.

finding_id string (optional)

The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.

enumimi i modalitetit (vargu) (opsional)

The mode of the find session.

Vlerat e mundshme:

scan
Fast scan using only the initial classifier.
verify
Performs classification followed by detailed investigation.

source_files array (FileContent) (optional)

A list of source files to provide as context for the scan.

Fushat

varg përmbajtjeje (opsionale)

The UTF-8 encoded text content of the file.

path string (optional)

The relative path of the file from the project root.

fix_request FixRequest (optional)

Parameters for fixing vulnerabilities.

Fushat

varg përshkrimi (opsional)

Additional context or custom instructions provided by the user to guide the patch generation process.

finding_id string (optional)

The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.

source_files array (FileContent) (optional)

A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.

Fushat

varg përmbajtjeje (opsionale)

The UTF-8 encoded text content of the file.

path string (optional)

The relative path of the file from the project root.

varg modeli (opsional)

The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.

session_config SessionConfig (optional)

Optional session-specific configurations to override default agent behavior.

Fushat

max_rounds integer (optional)

The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.

session_id string (optional)

Parameter for grouping multiple interactions that belong to the same CodeMender session.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code-mender" .

DeepResearchAgentConfig

Configuration for the Deep Research agent.

collaborative_planning boolean (optional)

enable_bigquery_tool boolean (optional)

Enables bigquery tool for the Deep Research agent.

thinking_summaries ThinkingSummaries (optional)

Whether to include thought summaries in the response.

Vlerat e mundshme

auto
Auto thinking summaries.
none
No thinking summaries.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "deep-research" .

visualization enum (string) (optional)

Whether to include visualizations in the response.

Vlerat e mundshme:

off
Do not include visualizations.
auto
Automatically include visualizations.

DynamicAgentConfig

Configuration for dynamic agents.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "dynamic" .

created string (optional)

Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

environment EnvironmentConfig or string (optional)

The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Llojet e mundshme

objekt

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

disabled
Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

gcs
Një kovë Ruajtjeje në Cloud.
inline
Përmbajtje e integruar.
repository
Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).
skill_registry
Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

vargu environment_id (opsional)

Output only. The environment ID for the interaction. Only populated if environment config is set in the request.

errors array (Error) (optional)

Output only. Diagnostic faults / platform errors recorded on the interaction.

Fushat

code string (optional)

A URI that identifies the error type.

message string (optional)

A human-readable error message.

vargu i identifikimit (opsional)

Required. Output only. A unique identifier for the interaction completion.

Defaults to:

input Content or array (Content) or array (Step) or string (optional)

The input for the interaction.

labels object (optional)

The labels with user-defined metadata for the request.

model ModelOption (optional)

The name of the `Model` used for generating the interaction.

Vlerat e mundshme

gemini-2.5-flash
Our first hybrid reasoning model which supports a 1M token context window and has thinking budgets.
gemini-2.5-pro
Our state-of-the-art multipurpose model, which excels at coding and complex reasoning tasks.
gemma-4-26b-a4b-it
Gemma 4 26B A4B IT
gemma-4-31b-it
Gemma 4 31B IT
gemini-flash-latest
Latest release of Gemini Flash
gemini-flash-lite-latest
Latest release of Gemini Flash-Lite
gemini-pro-latest
Latest release of Gemini Pro
gemini-2.5-flash-lite
Our smallest and most cost effective model, built for at scale usage.
gemini-2.5-flash-image
Our native image generation model, optimized for speed, flexibility, and contextual understanding. Text input and output is priced the same as 2.5 Flash.
gemini-3-flash-preview
Our most intelligent model built for speed, combining frontier intelligence with superior search and grounding.
gemini-3.1-pro-preview
Our latest SOTA reasoning model with unprecedented depth and nuance, and powerful multimodal understanding and coding capabilities.
gemini-3.1-pro-preview-customtools
Gemini 3.1 Pro Preview optimized for custom tool usage
gemini-3.1-flash-lite
Our most cost-efficient model, optimized for high-volume agentic tasks, translation, and simple data processing.
gemini-3-pro-image
Gemini 3 Pro Image
nano-banana-pro-preview
Gemini 3 Pro Image Preview
gemini-3.1-flash-image
Gemini 3.1 Flash Image.
gemini-3.5-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
gemini-3.6-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
gemini-3.7-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
lyria-3-clip-preview
Our low-latency, music generation model optimized for high-fidelity audio clips and precise rhythmic control.
lyria-3-pro-preview
Our advanced, full-song generative model with deep compositional understanding, optimized for precise structural control and complex transitions across diverse musical styles.
gemini-robotics-er-1.6-preview
Gemini Robotics-ER 1.6 Preview
gemini-robotics-er-2-preview
Gemini Robotics Embodied Reasoning 2 Preview

output_audio AudioContent (optional)

The last audio generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

output_image ImageContent (optional)

The last image generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

output_text string (optional)

Concatenated text from the last model output in response to the current request. Note: this is added by the SDK.

output_video VideoContent (optional)

The last video generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

previous_interaction_id string (optional)

The ID of the previous interaction, if any.

response_format ResponseFormat or array (ResponseFormat) (optional)

Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.

Llojet e mundshme

AudioResponseFormat

Configuration for audio output format.

bit_rate integer (optional)

Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).

delivery enum (string) (optional)

The delivery mode for the audio output.

Vlerat e mundshme:

inline
Audio data is returned inline in the response.
uri
Audio data is returned as a URI.

mime_type enum (string) (optional)

The MIME type of the audio output.

Vlerat e mundshme:

audio/mp3
MP3 audio format.
audio/ogg_opus
OGG Opus audio format.
audio/l16
Raw PCM (L16) audio format.
audio/wav
WAV audio format.
audio/alaw
A-law audio format.
audio/mulaw
Mu-law audio format.

sample_rate integer (optional)

Sample rate in Hz.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

ImageResponseFormat

Configuration for image output format.

aspect_ratio enum (string) (optional)

The aspect ratio for the image output.

Vlerat e mundshme:

1:1
1:1 aspect ratio.
2:3
2:3 aspect ratio.
3:2
3:2 aspect ratio.
3:4
3:4 aspect ratio.
4:3
4:3 aspect ratio.
4:5
4:5 aspect ratio.
5:4
5:4 aspect ratio.
9:16
9:16 aspect ratio.
16:9
16:9 aspect ratio.
21:9
21:9 aspect ratio.
1:8
1:8 aspect ratio.
8:1
8:1 aspect ratio.
1:4
1:4 aspect ratio.
4:1
4:1 aspect ratio.

delivery enum (string) (optional)

The delivery mode for the image output.

Vlerat e mundshme:

inline
Image data is returned inline in the response.
uri
Image data is returned as a URI.

image_size enum (string) (optional)

The size of the image output.

Vlerat e mundshme:

512
512px image size.
1K
1K image size.
2K
2K image size.
4K
4K image size.

mime_type enum (string) (optional)

The MIME type of the image output.

Vlerat e mundshme:

image/jpeg
JPEG image format.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

TextResponseFormat

Configuration for text output format.

mime_type enum (string) (optional)

The MIME type of the text output.

Vlerat e mundshme:

application/json
JSON output format.
text/plain
Plain text output format.

schema object (optional)

The JSON schema that the output should conform to. Only applicable when mime_type is application/json.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoResponseFormat

Configuration for video output format.

aspect_ratio enum (string) (optional)

The aspect ratio for the video output.

Vlerat e mundshme:

16:9
16:9 aspect ratio.
9:16
9:16 aspect ratio.

delivery enum (string) (optional)

The delivery mode for the video output.

Vlerat e mundshme:

inline
Video data is returned inline in the response.
uri
Video data is returned as a URI.

duration string (optional)

The duration for the video output.

gcs_uri string (optional)

The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.

resolution enum (string) (optional)

The video output resolution. Defaults to 720p.

Vlerat e mundshme:

360p
360p resolution.
720p
720p resolution.
1080p
1080p resolution.
4k
4K resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

safety_settings array (SafetySetting) (optional)

Safety settings for the interaction.

Fushat

method enum (string) (optional)

Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.

Vlerat e mundshme:

severity
The harm block method uses both probability and severity scores.
probability
The harm block method uses the probability score.

threshold enum (string) (optional)

Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.

Vlerat e mundshme:

block_low_and_above
Block content with a low harm probability or higher.
block_medium_and_above
Block content with a medium harm probability or higher.
block_only_high
Block content with a high harm probability.
block_none
Do not block any content, regardless of its harm probability.
off
Turn off the safety filter entirely.

type HarmCategory (optional)

Required. The type of harm category to be blocked.

Vlerat e mundshme

hate_speech
Content that promotes violence or incites hatred against individuals or groups based on certain attributes.
dangerous_content
Content that promotes, facilitates, or enables dangerous activities.
harassment
Abusive, threatening, or content intended to bully, torment, or ridicule.
sexually_explicit
Content that contains sexually explicit material.
civic_integrity
Deprecated: Election filter is not longer supported. The harm category is civic integrity.
image_hate
Images that contain hate speech.
image_dangerous_content
Images that contain dangerous content.
image_harassment
Images that contain harassment.
image_sexually_explicit
Images that contain sexually explicit content.
jailbreak
Prompts designed to bypass safety filters.

service_tier ServiceTier (optional)

The service tier for the interaction.

Vlerat e mundshme

flex
Flex service tier.
standard
Standard service tier.
priority
Priority service tier.
deferred
Deferred service tier.

status enum (string) (optional)

Required. Output only. The status of the interaction.

Vlerat e mundshme:

in_progress
The interaction is in progress.
requires_action
The interaction requires action/input from the user.
completed
The interaction is completed.
failed
The interaction failed.
cancelled
The interaction was cancelled.
incomplete
The interaction is completed, but contains incomplete results (eg hitting max_tokens).
budget_exceeded
The interaction was halted because the token budget was exceeded.
queued
The interaction is queued, waiting for processing.

steps array (Step) (optional)

Output only. The steps that make up the interaction, when included in the response.

Llojet e mundshme

CodeExecutionCallStep

Code execution call step.

arguments CodeExecutionCallStepArguments (required)

Required. The arguments to pass to the code execution.

Fushat

code string (optional)

The code to be executed.

language enum (string) (optional)

Programming language of the `code`.

Vlerat e mundshme:

python
Python >= 3.10, with numpy and simpy available.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code_execution_call" .

CodeExecutionResultStep

Code execution result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the code execution resulted in an error.

result string (required)

Required. The output of the code execution.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code_execution_result" .

FileSearchCallStep

File Search call step.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search_call" .

FileSearchResultStep

File Search result step.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search_result" .

FunctionCallStep

A function tool call step.

arguments object (required)

Required. The arguments to pass to the function.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

name string (required)

Required. The name of the tool to call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "function_call" .

FunctionResultStep

Result of a function tool call.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the tool call resulted in an error.

varg emri (opsional)

The name of the tool that was called.

result array (ImageContent or TextContent) or object or string (required)

Required. The result of the tool call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "function_result" .

GoogleMapsCallStep

Google Maps call step.

arguments GoogleMapsCallStepArguments (optional)

The arguments to pass to the Google Maps tool.

Fushat

queries array (string) (optional)

The queries to be executed.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps_call" .

GoogleMapsResultStep

Google Maps result step.

call_id string (required)

Required. ID to match the ID from the function call block.

result array (GoogleMapsResultItem) (required)

Nuk është dhënë përshkrim.

Fushat

places array (GoogleMapsResultPlaces) (optional)

Nuk është dhënë përshkrim.

Fushat

varg emri (opsional)

Nuk është dhënë përshkrim.

place_id string (optional)

Nuk është dhënë përshkrim.

review_snippets array (ReviewSnippet) (optional)

Nuk është dhënë përshkrim.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

vargu i url- së (opsional)

Nuk është dhënë përshkrim.

widget_context_token string (optional)

Nuk është dhënë përshkrim.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps_result" .

GoogleSearchCallStep

Google Search call step.

arguments GoogleSearchCallStepArguments (required)

Required. The arguments to pass to Google Search.

Fushat

queries array (string) (optional)

Web search queries for the following-up web search.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

search_type enum (string) (optional)

The type of search grounding enabled.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_search_call" .

GoogleSearchResultStep

Google Search result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the Google Search resulted in an error.

result array (GoogleSearchResultItem) (required)

Required. The results of the Google Search.

Fushat

search_suggestions string (optional)

Web content snippet that can be embedded in a web page or an app webview.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_search_result" .

McpServerToolCallStep

MCPServer tool call step.

arguments object (required)

Required. The JSON object of arguments for the function.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

name string (required)

Required. The name of the tool which was called.

server_name string (required)

Required. The name of the used MCP server.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "mcp_server_tool_call" .

McpServerToolResultStep

MCPServer tool result step.

call_id string (required)

Required. ID to match the ID from the function call block.

varg emri (opsional)

Name of the tool which is called for this specific tool call.

result array (ImageContent or TextContent) or object or string (required)

Required. The output from the MCP server call. Can be simple text or rich content.

server_name string (optional)

The name of the used MCP server.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "mcp_server_tool_result" .

ModelOutputStep

Output generated by the model.

content array (Content) (optional)

Nuk është dhënë përshkrim.

Llojet e mundshme

AudioContent

An audio content block.

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

DocumentContent

A document content block.

data string (optional)

The document content.

mime_type enum (string) (optional)

The mime type of the document.

Vlerat e mundshme:

application/pdf
PDF document format
text/csv
CSV document format

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "document" .

uri string (optional)

The URI of the document.

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoContent

A video content block.

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "model_output" .

ThoughtStep

A thought step.

signature string (optional)

A signature hash for backend validation.

summary array (ThoughtSummaryContent) (optional)

A summary of the thought.

Llojet e mundshme

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "thought" .

UrlContextCallStep

URL context call step.

arguments UrlContextCallArguments (required)

Required. The arguments to pass to the URL context.

Fushat

urls array (string) (optional)

The URLs to fetch.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_context_call" .

UrlContextResultStep

URL context result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the URL context resulted in an error.

result array (UrlContextResult) (required)

Required. The results of the URL context.

Fushat

status enum (string) (optional)

The status of the URL retrieval.

Vlerat e mundshme:

success
Url retrieval is successful.
error
Url retrieval is failed due to error.
paywall
Url retrieval is failed because the content is behind paywall.
unsafe
Url retrieval is failed because the content is unsafe.

vargu i url- së (opsional)

The URL that was fetched.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_context_result" .

UserInputStep

Input provided by the user.

content array (Content) (optional)

Nuk është dhënë përshkrim.

Llojet e mundshme

AudioContent

An audio content block.

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

DocumentContent

A document content block.

data string (optional)

The document content.

mime_type enum (string) (optional)

The mime type of the document.

Vlerat e mundshme:

application/pdf
PDF document format
text/csv
CSV document format

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "document" .

uri string (optional)

The URI of the document.

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoContent

A video content block.

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "user_input" .

vargu i udhëzimit_të_sistem-it (opsional)

System instruction for the interaction.

tools array (Tool) (optional)

A list of tool declarations the model may call during interaction.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

ComputerUse

A tool that can be used by the model to interact with the computer.

disabled_safety_policies array (enum (string)) (optional)

Optional. Disabled safety policies for computer use.

Vlerat e mundshme:

financial_transactions
Safety policy for financial transactions.
sensitive_data_modification
Safety policy for sensitive data modification.
communication_tool
Safety policy for communication tools (eg Gmail, Chat, Meet).
account_creation
Safety policy for account creation.
data_modification
Safety policy for data modification.
user_consent_management
Safety policy for user consent management.
legal_terms_and_agreements
Safety policy for legal terms and agreements.

enable_prompt_injection_detection boolean (optional)

Whether enable the prompt injection detection check on computer-use request.

environment enum (string) (optional)

The environment being operated.

Vlerat e mundshme:

browser
Operates in a web browser.
mobile
Operates in a mobile environment.
desktop
Operates in a desktop environment.

excluded_predefined_functions array (string) (optional)

The list of predefined functions that are excluded from the model call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "computer_use" .

FileSearch

A tool that can be used by the model to search files.

file_search_store_names array (string) (optional)

The file search store names to search.

metadata_filter string (optional)

Metadata filter to apply to the semantic retrieval documents and chunks.

top_k integer (optional)

The number of semantic retrieval chunks to retrieve.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

GoogleMaps

A tool that can be used by the model to call Google Maps.

enable_widget boolean (optional)

Whether to return a widget context token in the tool call result of the response.

latitude number (optional)

The latitude of the user's location.

longitude number (optional)

The longitude of the user's location.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

auto
Zgjedhja e mjetit automatik.
any
Çdo zgjedhje mjeti.
none
Pa zgjedhje mjetesh.
validated
Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Retrieval

A tool that can be used by the model to retrieve files.

exa_ai_search_config ExaAISearchConfig (optional)

Used to specify configuration for ExaAISearch.

Fushat

api_key string (optional)

Required. The API key for ExaAiSearch.

custom_config object (optional)

Optional. This field can be used to pass any parameter from the Exa.ai Search API.

parallel_ai_search_config ParallelAISearchConfig (optional)

Used to specify configuration for ParallelAISearch.

Fushat

api_key string (optional)

Optional. The API key for ParallelAiSearch.

custom_config object (optional)

Optional. Custom configs for ParallelAiSearch.

rag_store_config RagStoreConfig (optional)

Used to specify configuration for RagStore.

Fushat

rag_resources array (RagResource) (optional)

Optional. The representation of the rag source.

Fushat

rag_corpus string (optional)

Optional. RagCorpora resource name.

rag_file_ids array (string) (optional)

Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.

rag_retrieval_config RagRetrievalConfig (optional)

Optional. The retrieval config for the Rag query.

Fushat

filter Filter (optional)

Optional. Config for filters.

Fushat

metadata_filter string (optional)

Optional. String for metadata filtering.

vector_distance_threshold number (optional)

Optional. Only returns contexts with vector distance smaller than the threshold.

vector_similarity_threshold number (optional)

Optional. Only returns contexts with vector similarity larger than the threshold.

hybrid_search HybridSearch (optional)

Optional. Config for Hybrid Search.

Fushat

alpha number (optional)

Optional. Alpha value controls the weight between dense and sparse vector search results.

ranking Ranking (optional)

Optional. Config for ranking and reranking.

top_k integer (optional)

Optional. The number of contexts to retrieve.

retrieval_types array (enum (string)) (optional)

The types of file retrieval to enable.

Vlerat e mundshme:

rag_store
exa_ai_search
parallel_ai_search

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "retrieval" .

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .

updated string (optional)

Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

usage Usage (optional)

Output only. Statistics on the interaction request's token usage.

Fushat

cached_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of cached token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

grounding_tool_count array (GroundingToolCount) (optional)

Grounding tool count.

Fushat

count integer (optional)

The number of grounding tool counts.

tipi enum (string) (opsionale)

The grounding tool type associated with the count.

Vlerat e mundshme:

google_search
Grounding with Google Web Search and Image Search, & Web Grounding for Enterprise.
google_maps
Grounding with Google Maps.
retrieval
Grounding with customer's data, for example, VertexAISearch.

input_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of input token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

output_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of output token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

tool_use_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of tool-use token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

total_cached_tokens integer (optional)

Number of tokens in the cached part of the prompt (the cached content).

total_input_tokens integer (optional)

Number of tokens in the prompt (context).

total_output_tokens integer (optional)

Total number of tokens across all the generated responses.

total_thought_tokens integer (optional)

Number of tokens of thoughts for thinking models.

total_tokens integer (optional)

Total token count for the interaction request (prompt + responses + other internal tokens).

total_tool_use_tokens integer (optional)

Number of tokens present in tool-use prompt(s).

webhook_config WebhookConfig (optional)

Optional. Webhook configuration for receiving notifications when the interaction completes.

Fushat

uris array (string) (optional)

Optional. If set, these webhook URIs will be used for webhook events instead of the registered webhooks.

user_metadata object (optional)

Optional. The user metadata that will be returned on each event emission to the webhooks.

last_pause_time string (optional)

Output only. The time when the trigger was last paused.

last_resume_time string (optional)

Output only. The time when the trigger was last resumed.

last_run_time string (optional)

Output only. The time when the trigger was last run.

max_consecutive_failures integer (optional)

Optional. The maximum number of consecutive failures allowed before the trigger is automatically paused (status becomes ERROR).

next_run_time string (optional)

Output only. The time when the trigger is scheduled to run next.

previous_interaction_id string (optional)

Output only. The ID of the last interaction created by this trigger.

schedule string (optional)

Required. The cron schedule on which the trigger should run. Standard cron format.

status enum (string) (optional)

Output only. The current status of the trigger.

Vlerat e mundshme:

active
The trigger is active and will fire on schedule.
paused
The trigger is paused and will not fire.
error
The trigger has entered an error state due to consecutive failures.

time_zone string (optional)

Required. Time zone in which the schedule should be interpreted.

update_time string (optional)

Output only. The time when the trigger was last updated.

Shembull

Shembull Përgjigjeje

{
  "consecutive_failure_count": 0,
  "create_time": "string",
  "display_name": "string",
  "environment_id": "string",
  "execution_timeout_seconds": 0,
  "id": "string",
  "interaction": {
    "created": "2025-12-04T15:01:45Z",
    "id": "v1_ChdXS0l4YWZXTk9xbk0xZThQczhEcmlROBIXV0tJeGFmV05PcW5NMWU4UHM4RHJpUTg",
    "model": "gemini-3.6-flash",
    "object": "interaction",
    "status": "completed",
    "steps": [
      {
        "type": "model_output",
        "content": [
          {
            "type": "text",
            "text": "Hello! I'm doing well, functioning as expected. Thank you for asking! How are you doing today?"
          }
        ]
      }
    ],
    "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
    }
  },
  "last_pause_time": "string",
  "last_resume_time": "string",
  "last_run_time": "string",
  "max_consecutive_failures": 0,
  "next_run_time": "string",
  "previous_interaction_id": "string",
  "schedule": "string",
  "status": "active",
  "time_zone": "string",
  "update_time": "string"
}

DeleteTrigger

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

Deletes a trigger.

Përgjigje

Përgjigje

Nëse ka sukses, përgjigja është bosh.

Shembull

Burimet

Shkaktues

A trigger configuration that is scheduled to run an agent.

Fushat

consecutive_failure_count integer (optional)

Output only. The number of consecutive failures that have occurred since the last successful execution.

create_time string (optional)

Output only. The time when the trigger was created.

display_name string (optional)

Optional. The display name of the trigger.

vargu environment_id (opsional)

Optional. The environment ID for the trigger execution.

execution_timeout_seconds integer (optional)

Optional. The execution timeout for the triggered interaction.

vargu i identifikimit (opsional)

Required. Output only. Identifier. The ID of the trigger.

interaction Interaction (optional)

Required. The interaction request template to be executed.

Fushat

agent AgentOption (optional)

The name of the `Agent` used for generating the interaction.

Vlerat e mundshme

deep-research-pro-preview-12-2025
Gemini Deep Research Agent
deep-research-preview-04-2026
Gemini Deep Research Agent
deep-research-max-preview-04-2026
Gemini Deep Research Max Agent
antigravity-preview-05-2026
Use the Antigravity managed agent to perform multi-step tasks that require reasoning, file operations, and tool use.

agent_config object (optional)

Configuration parameters for the agent interaction.

Llojet e mundshme

Polymorphic discriminator: type

AntigravityAgentConfig

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

CodeMenderAgentConfig

Configuration for the CodeMender agent.

find_request FindRequest (optional)

Parameters for finding vulnerabilities.

Fushat

varg përshkrimi (opsional)

Additional context or custom instructions provided by the user to guide the vulnerability analysis.

finding_id string (optional)

The identifier of a specific finding to verify. This is primarily used in VERIFY mode to focus the agent's execution-based validation on a single vulnerability.

enumimi i modalitetit (vargu) (opsional)

The mode of the find session.

Vlerat e mundshme:

scan
Fast scan using only the initial classifier.
verify
Performs classification followed by detailed investigation.

source_files array (FileContent) (optional)

A list of source files to provide as context for the scan.

Fushat

varg përmbajtjeje (opsionale)

The UTF-8 encoded text content of the file.

path string (optional)

The relative path of the file from the project root.

fix_request FixRequest (optional)

Parameters for fixing vulnerabilities.

Fushat

varg përshkrimi (opsional)

Additional context or custom instructions provided by the user to guide the patch generation process.

finding_id string (optional)

The identifier of the specific security finding to be remediated. This ID maps to a previously discovered vulnerability.

source_files array (FileContent) (optional)

A list of source files providing context for the remediation. These files are typically the ones containing the identified vulnerability.

Fushat

varg përmbajtjeje (opsionale)

The UTF-8 encoded text content of the file.

path string (optional)

The relative path of the file from the project root.

varg modeli (opsional)

The name of the model to use for the CodeMender agent. One CodeMender session will only use one model.

session_config SessionConfig (optional)

Optional session-specific configurations to override default agent behavior.

Fushat

max_rounds integer (optional)

The maximum number of interaction rounds the agent is allowed to perform before reaching a timeout.

session_id string (optional)

Parameter for grouping multiple interactions that belong to the same CodeMender session.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code-mender" .

DeepResearchAgentConfig

Configuration for the Deep Research agent.

collaborative_planning boolean (optional)

enable_bigquery_tool boolean (optional)

Enables bigquery tool for the Deep Research agent.

thinking_summaries ThinkingSummaries (optional)

Whether to include thought summaries in the response.

Vlerat e mundshme

auto
Auto thinking summaries.
none
No thinking summaries.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "deep-research" .

visualization enum (string) (optional)

Whether to include visualizations in the response.

Vlerat e mundshme:

off
Do not include visualizations.
auto
Automatically include visualizations.

DynamicAgentConfig

Configuration for dynamic agents.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "dynamic" .

created string (optional)

Output only. The time at which the response was created in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

environment EnvironmentConfig or string (optional)

The environment configuration for the interaction. Can be an object specifying remote environment sources or a string referencing an existing environment ID.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Llojet e mundshme

objekt

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

disabled
Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

gcs
Një kovë Ruajtjeje në Cloud.
inline
Përmbajtje e integruar.
repository
Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).
skill_registry
Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

vargu environment_id (opsional)

Output only. The environment ID for the interaction. Only populated if environment config is set in the request.

errors array (Error) (optional)

Output only. Diagnostic faults / platform errors recorded on the interaction.

Fushat

code string (optional)

A URI that identifies the error type.

message string (optional)

A human-readable error message.

vargu i identifikimit (opsional)

Required. Output only. A unique identifier for the interaction completion.

Defaults to:

input Content or array (Content) or array (Step) or string (optional)

The input for the interaction.

labels object (optional)

The labels with user-defined metadata for the request.

model ModelOption (optional)

The name of the `Model` used for generating the interaction.

Vlerat e mundshme

gemini-2.5-flash
Our first hybrid reasoning model which supports a 1M token context window and has thinking budgets.
gemini-2.5-pro
Our state-of-the-art multipurpose model, which excels at coding and complex reasoning tasks.
gemma-4-26b-a4b-it
Gemma 4 26B A4B IT
gemma-4-31b-it
Gemma 4 31B IT
gemini-flash-latest
Latest release of Gemini Flash
gemini-flash-lite-latest
Latest release of Gemini Flash-Lite
gemini-pro-latest
Latest release of Gemini Pro
gemini-2.5-flash-lite
Our smallest and most cost effective model, built for at scale usage.
gemini-2.5-flash-image
Our native image generation model, optimized for speed, flexibility, and contextual understanding. Text input and output is priced the same as 2.5 Flash.
gemini-3-flash-preview
Our most intelligent model built for speed, combining frontier intelligence with superior search and grounding.
gemini-3.1-pro-preview
Our latest SOTA reasoning model with unprecedented depth and nuance, and powerful multimodal understanding and coding capabilities.
gemini-3.1-pro-preview-customtools
Gemini 3.1 Pro Preview optimized for custom tool usage
gemini-3.1-flash-lite
Our most cost-efficient model, optimized for high-volume agentic tasks, translation, and simple data processing.
gemini-3-pro-image
Gemini 3 Pro Image
nano-banana-pro-preview
Gemini 3 Pro Image Preview
gemini-3.1-flash-image
Gemini 3.1 Flash Image.
gemini-3.5-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
gemini-3.6-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
gemini-3.7-flash
Our most intelligent model for sustained frontier performance in agentic and coding tasks.
lyria-3-clip-preview
Our low-latency, music generation model optimized for high-fidelity audio clips and precise rhythmic control.
lyria-3-pro-preview
Our advanced, full-song generative model with deep compositional understanding, optimized for precise structural control and complex transitions across diverse musical styles.
gemini-robotics-er-1.6-preview
Gemini Robotics-ER 1.6 Preview
gemini-robotics-er-2-preview
Gemini Robotics Embodied Reasoning 2 Preview

output_audio AudioContent (optional)

The last audio generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

output_image ImageContent (optional)

The last image generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

output_text string (optional)

Concatenated text from the last model output in response to the current request. Note: this is added by the SDK.

output_video VideoContent (optional)

The last video generated by the model in response to the current request. Note: this is added by the SDK.

Fushat

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

previous_interaction_id string (optional)

The ID of the previous interaction, if any.

response_format ResponseFormat or array (ResponseFormat) (optional)

Enforces that the generated response is a JSON object that complies with the JSON schema specified in this field.

Llojet e mundshme

AudioResponseFormat

Configuration for audio output format.

bit_rate integer (optional)

Bit rate in bits per second (bps). Only applicable for compressed formats (MP3, Opus).

delivery enum (string) (optional)

The delivery mode for the audio output.

Vlerat e mundshme:

inline
Audio data is returned inline in the response.
uri
Audio data is returned as a URI.

mime_type enum (string) (optional)

The MIME type of the audio output.

Vlerat e mundshme:

audio/mp3
MP3 audio format.
audio/ogg_opus
OGG Opus audio format.
audio/l16
Raw PCM (L16) audio format.
audio/wav
WAV audio format.
audio/alaw
A-law audio format.
audio/mulaw
Mu-law audio format.

sample_rate integer (optional)

Sample rate in Hz.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

ImageResponseFormat

Configuration for image output format.

aspect_ratio enum (string) (optional)

The aspect ratio for the image output.

Vlerat e mundshme:

1:1
1:1 aspect ratio.
2:3
2:3 aspect ratio.
3:2
3:2 aspect ratio.
3:4
3:4 aspect ratio.
4:3
4:3 aspect ratio.
4:5
4:5 aspect ratio.
5:4
5:4 aspect ratio.
9:16
9:16 aspect ratio.
16:9
16:9 aspect ratio.
21:9
21:9 aspect ratio.
1:8
1:8 aspect ratio.
8:1
8:1 aspect ratio.
1:4
1:4 aspect ratio.
4:1
4:1 aspect ratio.

delivery enum (string) (optional)

The delivery mode for the image output.

Vlerat e mundshme:

inline
Image data is returned inline in the response.
uri
Image data is returned as a URI.

image_size enum (string) (optional)

The size of the image output.

Vlerat e mundshme:

512
512px image size.
1K
1K image size.
2K
2K image size.
4K
4K image size.

mime_type enum (string) (optional)

The MIME type of the image output.

Vlerat e mundshme:

image/jpeg
JPEG image format.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

TextResponseFormat

Configuration for text output format.

mime_type enum (string) (optional)

The MIME type of the text output.

Vlerat e mundshme:

application/json
JSON output format.
text/plain
Plain text output format.

schema object (optional)

The JSON schema that the output should conform to. Only applicable when mime_type is application/json.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoResponseFormat

Configuration for video output format.

aspect_ratio enum (string) (optional)

The aspect ratio for the video output.

Vlerat e mundshme:

16:9
16:9 aspect ratio.
9:16
9:16 aspect ratio.

delivery enum (string) (optional)

The delivery mode for the video output.

Vlerat e mundshme:

inline
Video data is returned inline in the response.
uri
Video data is returned as a URI.

duration string (optional)

The duration for the video output.

gcs_uri string (optional)

The Cloud Storage URI to store the video output. Required for Vertex if delivery mode is URI.

resolution enum (string) (optional)

The video output resolution. Defaults to 720p.

Vlerat e mundshme:

360p
360p resolution.
720p
720p resolution.
1080p
1080p resolution.
4k
4K resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

safety_settings array (SafetySetting) (optional)

Safety settings for the interaction.

Fushat

method enum (string) (optional)

Optional. The method for blocking content. If not specified, the default behavior is to use the probability score.

Vlerat e mundshme:

severity
The harm block method uses both probability and severity scores.
probability
The harm block method uses the probability score.

threshold enum (string) (optional)

Required. The threshold for blocking content. If the harm probability exceeds this threshold, the content will be blocked.

Vlerat e mundshme:

block_low_and_above
Block content with a low harm probability or higher.
block_medium_and_above
Block content with a medium harm probability or higher.
block_only_high
Block content with a high harm probability.
block_none
Do not block any content, regardless of its harm probability.
off
Turn off the safety filter entirely.

type HarmCategory (optional)

Required. The type of harm category to be blocked.

Vlerat e mundshme

hate_speech
Content that promotes violence or incites hatred against individuals or groups based on certain attributes.
dangerous_content
Content that promotes, facilitates, or enables dangerous activities.
harassment
Abusive, threatening, or content intended to bully, torment, or ridicule.
sexually_explicit
Content that contains sexually explicit material.
civic_integrity
Deprecated: Election filter is not longer supported. The harm category is civic integrity.
image_hate
Images that contain hate speech.
image_dangerous_content
Images that contain dangerous content.
image_harassment
Images that contain harassment.
image_sexually_explicit
Images that contain sexually explicit content.
jailbreak
Prompts designed to bypass safety filters.

service_tier ServiceTier (optional)

The service tier for the interaction.

Vlerat e mundshme

flex
Flex service tier.
standard
Standard service tier.
priority
Priority service tier.
deferred
Deferred service tier.

status enum (string) (optional)

Required. Output only. The status of the interaction.

Vlerat e mundshme:

in_progress
The interaction is in progress.
requires_action
The interaction requires action/input from the user.
completed
The interaction is completed.
failed
The interaction failed.
cancelled
The interaction was cancelled.
incomplete
The interaction is completed, but contains incomplete results (eg hitting max_tokens).
budget_exceeded
The interaction was halted because the token budget was exceeded.
queued
The interaction is queued, waiting for processing.

steps array (Step) (optional)

Output only. The steps that make up the interaction, when included in the response.

Llojet e mundshme

CodeExecutionCallStep

Code execution call step.

arguments CodeExecutionCallStepArguments (required)

Required. The arguments to pass to the code execution.

Fushat

code string (optional)

The code to be executed.

language enum (string) (optional)

Programming language of the `code`.

Vlerat e mundshme:

python
Python >= 3.10, with numpy and simpy available.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code_execution_call" .

CodeExecutionResultStep

Code execution result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the code execution resulted in an error.

result string (required)

Required. The output of the code execution.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "code_execution_result" .

FileSearchCallStep

File Search call step.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search_call" .

FileSearchResultStep

File Search result step.

call_id string (required)

Required. ID to match the ID from the function call block.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search_result" .

FunctionCallStep

A function tool call step.

arguments object (required)

Required. The arguments to pass to the function.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

name string (required)

Required. The name of the tool to call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "function_call" .

FunctionResultStep

Result of a function tool call.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the tool call resulted in an error.

varg emri (opsional)

The name of the tool that was called.

result array (ImageContent or TextContent) or object or string (required)

Required. The result of the tool call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "function_result" .

GoogleMapsCallStep

Google Maps call step.

arguments GoogleMapsCallStepArguments (optional)

The arguments to pass to the Google Maps tool.

Fushat

queries array (string) (optional)

The queries to be executed.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps_call" .

GoogleMapsResultStep

Google Maps result step.

call_id string (required)

Required. ID to match the ID from the function call block.

result array (GoogleMapsResultItem) (required)

Nuk është dhënë përshkrim.

Fushat

places array (GoogleMapsResultPlaces) (optional)

Nuk është dhënë përshkrim.

Fushat

varg emri (opsional)

Nuk është dhënë përshkrim.

place_id string (optional)

Nuk është dhënë përshkrim.

review_snippets array (ReviewSnippet) (optional)

Nuk është dhënë përshkrim.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

vargu i url- së (opsional)

Nuk është dhënë përshkrim.

widget_context_token string (optional)

Nuk është dhënë përshkrim.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps_result" .

GoogleSearchCallStep

Google Search call step.

arguments GoogleSearchCallStepArguments (required)

Required. The arguments to pass to Google Search.

Fushat

queries array (string) (optional)

Web search queries for the following-up web search.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

search_type enum (string) (optional)

The type of search grounding enabled.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_search_call" .

GoogleSearchResultStep

Google Search result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the Google Search resulted in an error.

result array (GoogleSearchResultItem) (required)

Required. The results of the Google Search.

Fushat

search_suggestions string (optional)

Web content snippet that can be embedded in a web page or an app webview.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_search_result" .

McpServerToolCallStep

MCPServer tool call step.

arguments object (required)

Required. The JSON object of arguments for the function.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

name string (required)

Required. The name of the tool which was called.

server_name string (required)

Required. The name of the used MCP server.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "mcp_server_tool_call" .

McpServerToolResultStep

MCPServer tool result step.

call_id string (required)

Required. ID to match the ID from the function call block.

varg emri (opsional)

Name of the tool which is called for this specific tool call.

result array (ImageContent or TextContent) or object or string (required)

Required. The output from the MCP server call. Can be simple text or rich content.

server_name string (optional)

The name of the used MCP server.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "mcp_server_tool_result" .

ModelOutputStep

Output generated by the model.

content array (Content) (optional)

Nuk është dhënë përshkrim.

Llojet e mundshme

AudioContent

An audio content block.

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

DocumentContent

A document content block.

data string (optional)

The document content.

mime_type enum (string) (optional)

The mime type of the document.

Vlerat e mundshme:

application/pdf
PDF document format
text/csv
CSV document format

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "document" .

uri string (optional)

The URI of the document.

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoContent

A video content block.

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "model_output" .

ThoughtStep

A thought step.

signature string (optional)

A signature hash for backend validation.

summary array (ThoughtSummaryContent) (optional)

A summary of the thought.

Llojet e mundshme

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "thought" .

UrlContextCallStep

URL context call step.

arguments UrlContextCallArguments (required)

Required. The arguments to pass to the URL context.

Fushat

urls array (string) (optional)

The URLs to fetch.

vargu i identifikimit (i detyrueshëm)

Required. A unique ID for this specific tool call.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_context_call" .

UrlContextResultStep

URL context result step.

call_id string (required)

Required. ID to match the ID from the function call block.

is_error boolean (optional)

Whether the URL context resulted in an error.

result array (UrlContextResult) (required)

Required. The results of the URL context.

Fushat

status enum (string) (optional)

The status of the URL retrieval.

Vlerat e mundshme:

success
Url retrieval is successful.
error
Url retrieval is failed due to error.
paywall
Url retrieval is failed because the content is behind paywall.
unsafe
Url retrieval is failed because the content is unsafe.

vargu i url- së (opsional)

The URL that was fetched.

signature string (optional)

A signature hash for backend validation.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_context_result" .

UserInputStep

Input provided by the user.

content array (Content) (optional)

Nuk është dhënë përshkrim.

Llojet e mundshme

AudioContent

An audio content block.

channels integer (optional)

The number of audio channels.

data string (optional)

The audio content.

mime_type enum (string) (optional)

The mime type of the audio.

Vlerat e mundshme:

audio/wav
WAV audio format
audio/mp3
MP3 audio format
audio/aiff
AIFF audio format
audio/aac
AAC audio format
audio/ogg
OGG audio format
audio/flac
FLAC audio format
audio/mpeg
MPEG audio format
audio/m4a
M4A audio format
audio/l16
L16 audio format
audio/opus
OPUS audio format
audio/alaw
ALAW audio format
audio/mulaw
MULAW audio format

sample_rate integer (optional)

The sample rate of the audio.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "audio" .

uri string (optional)

The URI of the audio.

DocumentContent

A document content block.

data string (optional)

The document content.

mime_type enum (string) (optional)

The mime type of the document.

Vlerat e mundshme:

application/pdf
PDF document format
text/csv
CSV document format

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "document" .

uri string (optional)

The URI of the document.

ImageContent

An image content block.

data string (optional)

The image content.

mime_type enum (string) (optional)

The mime type of the image.

Vlerat e mundshme:

image/png
PNG image format
image/jpeg
JPEG image format
image/webp
WebP image format
image/heic
HEIC image format
image/heif
HEIF image format
image/gif
GIF image format
image/bmp
BMP image format
image/tiff
TIFF image format

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "image" .

uri string (optional)

The URI of the image.

TextContent

A text content block.

annotations array (Annotation) (optional)

Citation information for model-generated content.

Llojet e mundshme

FileCitation

A file citation annotation.

custom_metadata object (optional)

User provided metadata about the retrieved context.

document_uri string (optional)

The URI of the file.

end_index integer (optional)

End of the attributed segment, exclusive.

file_name string (optional)

The name of the file.

media_id string (optional)

Media ID in-case of image citations, if applicable.

page_number integer (optional)

Page number of the cited document, if applicable.

vargu burimor (opsional)

Source attributed for a portion of the text.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_citation" .

PlaceCitation

A place citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

varg emri (opsional)

Title of the place.

place_id string (optional)

The ID of the place, in `places/{place_id}` format.

review_snippets array (ReviewSnippet) (optional)

Snippets of reviews that are used to generate answers about the features of a given place in Google Maps.

Fushat

review_id string (optional)

The ID of the review snippet.

title string (optional)

Title of the review.

vargu i url- së (opsional)

A link that corresponds to the user review on Google Maps.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "place_citation" .

vargu i url- së (opsional)

URI reference of the place.

UrlCitation

A URL citation annotation.

end_index integer (optional)

End of the attributed segment, exclusive.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

title string (optional)

The title of the URL.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "url_citation" .

vargu i url- së (opsional)

The URL.

WordInfo

Word-level ASR annotation for transcription output. Carries the word text, optional timing, and optional speaker attribution.

end_index integer (optional)

End of the attributed segment, exclusive.

end_offset string (optional)

End offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

speaker string (optional)

Optional. Speaker label for this word (eg "spk_1", "spk_2"). Present when diarization_mode is set in TranscriptionConfig.

start_index integer (optional)

Start of segment of the response that is attributed to this source. Index indicates the start of the segment, measured in bytes.

start_offset string (optional)

Start offset in time of the word relative to the start of the audio. Present when timestamp_granularities contains "word".

text string (optional)

The transcribed word.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "word_info" .

text string (required)

Required. The text content.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "text" .

VideoContent

A video content block.

data string (optional)

The video content.

mime_type enum (string) (optional)

The mime type of the video.

Vlerat e mundshme:

video/mp4
MP4 video format
video/mpeg
MPEG video format
video/mpg
MPG video format
video/mov
MOV video format
video/avi
AVI video format
video/x-flv
FLV video format
video/webm
WebM video format
video/wmv
WMV video format
video/3gpp
3GPP video format

processing MediaProcessing or enum (string) (optional)

How the model processes this video for understanding.

resolution MediaResolution (optional)

The resolution of the media.

Vlerat e mundshme

low
Low resolution.
medium
Medium resolution.
high
High resolution.
ultra_high
Ultra high resolution.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "video" .

uri string (optional)

The URI of the video.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "user_input" .

vargu i udhëzimit_të_sistem-it (opsional)

System instruction for the interaction.

tools array (Tool) (optional)

A list of tool declarations the model may call during interaction.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

ComputerUse

A tool that can be used by the model to interact with the computer.

disabled_safety_policies array (enum (string)) (optional)

Optional. Disabled safety policies for computer use.

Vlerat e mundshme:

financial_transactions
Safety policy for financial transactions.
sensitive_data_modification
Safety policy for sensitive data modification.
communication_tool
Safety policy for communication tools (eg Gmail, Chat, Meet).
account_creation
Safety policy for account creation.
data_modification
Safety policy for data modification.
user_consent_management
Safety policy for user consent management.
legal_terms_and_agreements
Safety policy for legal terms and agreements.

enable_prompt_injection_detection boolean (optional)

Whether enable the prompt injection detection check on computer-use request.

environment enum (string) (optional)

The environment being operated.

Vlerat e mundshme:

browser
Operates in a web browser.
mobile
Operates in a mobile environment.
desktop
Operates in a desktop environment.

excluded_predefined_functions array (string) (optional)

The list of predefined functions that are excluded from the model call.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "computer_use" .

FileSearch

A tool that can be used by the model to search files.

file_search_store_names array (string) (optional)

The file search store names to search.

metadata_filter string (optional)

Metadata filter to apply to the semantic retrieval documents and chunks.

top_k integer (optional)

The number of semantic retrieval chunks to retrieve.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "file_search" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

GoogleMaps

A tool that can be used by the model to call Google Maps.

enable_widget boolean (optional)

Whether to return a widget context token in the tool call result of the response.

latitude number (optional)

The latitude of the user's location.

longitude number (optional)

The longitude of the user's location.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "google_maps" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.
image_search
Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.
enterprise_web_search
Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

auto
Zgjedhja e mjetit automatik.
any
Çdo zgjedhje mjeti.
none
Pa zgjedhje mjetesh.
validated
Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Retrieval

A tool that can be used by the model to retrieve files.

exa_ai_search_config ExaAISearchConfig (optional)

Used to specify configuration for ExaAISearch.

Fushat

api_key string (optional)

Required. The API key for ExaAiSearch.

custom_config object (optional)

Optional. This field can be used to pass any parameter from the Exa.ai Search API.

parallel_ai_search_config ParallelAISearchConfig (optional)

Used to specify configuration for ParallelAISearch.

Fushat

api_key string (optional)

Optional. The API key for ParallelAiSearch.

custom_config object (optional)

Optional. Custom configs for ParallelAiSearch.

rag_store_config RagStoreConfig (optional)

Used to specify configuration for RagStore.

Fushat

rag_resources array (RagResource) (optional)

Optional. The representation of the rag source.

Fushat

rag_corpus string (optional)

Optional. RagCorpora resource name.

rag_file_ids array (string) (optional)

Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.

rag_retrieval_config RagRetrievalConfig (optional)

Optional. The retrieval config for the Rag query.

Fushat

filter Filter (optional)

Optional. Config for filters.

Fushat

metadata_filter string (optional)

Optional. String for metadata filtering.

vector_distance_threshold number (optional)

Optional. Only returns contexts with vector distance smaller than the threshold.

vector_similarity_threshold number (optional)

Optional. Only returns contexts with vector similarity larger than the threshold.

hybrid_search HybridSearch (optional)

Optional. Config for Hybrid Search.

Fushat

alpha number (optional)

Optional. Alpha value controls the weight between dense and sparse vector search results.

ranking Ranking (optional)

Optional. Config for ranking and reranking.

top_k integer (optional)

Optional. The number of contexts to retrieve.

retrieval_types array (enum (string)) (optional)

The types of file retrieval to enable.

Vlerat e mundshme:

rag_store
exa_ai_search
parallel_ai_search

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Always set to "retrieval" .

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .

updated string (optional)

Output only. The time at which the response was last updated in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ).

usage Usage (optional)

Output only. Statistics on the interaction request's token usage.

Fushat

cached_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of cached token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

grounding_tool_count array (GroundingToolCount) (optional)

Grounding tool count.

Fushat

count integer (optional)

The number of grounding tool counts.

tipi enum (string) (opsionale)

The grounding tool type associated with the count.

Vlerat e mundshme:

google_search
Grounding with Google Web Search and Image Search, & Web Grounding for Enterprise.
google_maps
Grounding with Google Maps.
retrieval
Grounding with customer's data, for example, VertexAISearch.

input_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of input token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

output_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of output token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

tool_use_tokens_by_modality array (ModalityTokens) (optional)

A breakdown of tool-use token usage by modality.

Fushat

modality ResponseModality (optional)

The modality associated with the token count.

Vlerat e mundshme

text
Indicates the model should return text.
image
Indicates the model should return images.
audio
Indicates the model should return audio.
video
Indicates the model should return video.
document
Indicates the model should return documents.

tokens integer (optional)

Number of tokens for the modality.

total_cached_tokens integer (optional)

Number of tokens in the cached part of the prompt (the cached content).

total_input_tokens integer (optional)

Number of tokens in the prompt (context).

total_output_tokens integer (optional)

Total number of tokens across all the generated responses.

total_thought_tokens integer (optional)

Number of tokens of thoughts for thinking models.

total_tokens integer (optional)

Total token count for the interaction request (prompt + responses + other internal tokens).

total_tool_use_tokens integer (optional)

Number of tokens present in tool-use prompt(s).

webhook_config WebhookConfig (optional)

Optional. Webhook configuration for receiving notifications when the interaction completes.

Fushat

uris array (string) (optional)

Optional. If set, these webhook URIs will be used for webhook events instead of the registered webhooks.

user_metadata object (optional)

Optional. The user metadata that will be returned on each event emission to the webhooks.

last_pause_time string (optional)

Output only. The time when the trigger was last paused.

last_resume_time string (optional)

Output only. The time when the trigger was last resumed.

last_run_time string (optional)

Output only. The time when the trigger was last run.

max_consecutive_failures integer (optional)

Optional. The maximum number of consecutive failures allowed before the trigger is automatically paused (status becomes ERROR).

next_run_time string (optional)

Output only. The time when the trigger is scheduled to run next.

previous_interaction_id string (optional)

Output only. The ID of the last interaction created by this trigger.

schedule string (optional)

Required. The cron schedule on which the trigger should run. Standard cron format.

status enum (string) (optional)

Output only. The current status of the trigger.

Vlerat e mundshme:

active
The trigger is active and will fire on schedule.
paused
The trigger is paused and will not fire.
error
The trigger has entered an error state due to consecutive failures.

time_zone string (optional)

Required. Time zone in which the schedule should be interpreted.

update_time string (optional)

Output only. The time when the trigger was last updated.