Gemini Environments API

Mjediset ofrojnë kontekste të izoluara ekzekutimi për ekzekutimin e kodit, mjeteve dhe shërbimeve të agjentëve në mënyrë të sigurt.

Shiko si ulje Shikoni Specifikimin OpenAPI

KrijoMjedis

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

Krijon një mjedis.

Trupi i kërkesës

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

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

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.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

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)

Burimet që do të montohen në mjedis.

Një burim që do të montohet në mjedis.

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://).

Përgjigje

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

varg i krijuar (opsional)

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

vargu file_count (opsional)

Vetëm rezultati. Numri i skedarëve në mjedis, vetëm rezultati.

vargu i identifikimit (opsional)

E detyrueshme. Vetëm rezultat. ID-ja e mjedisit.

vargu i aksesuar së fundmi (opsional)

Vetëm rezultati. Ora në të cilën mjedisi është aksesuar për herë të fundit në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

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.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

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 madhësisë_së_bytes (opsional)

Vetëm rezultati. Madhësia totale e skedarëve të mjedisit në bajt, vetëm rezultati.

vargu i burimeve (Burimi) (opsional)

Burimet që do të montohen në mjedis.

Një burim që do të montohet në mjedis.

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://).

numërimi i statusit (varg) (opsional)

Vetëm rezultati. Statusi i kontejnerit të mjedisit.

Vlerat e mundshme:

  • active

    Vetëm rezultati. Statusi i kontejnerit të mjedisit.

  • expired

    Vetëm rezultati. Statusi i kontejnerit të mjedisit.

varg i përditësuar (opsional)

Vetëm rezultati. Ora në të cilën mjedisi është përditësuar për herë të fundit në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

Krijo Mjedis

Shembull Përgjigjeje 

{
  "created": "2026-08-19T00:00:00Z",
  "id": "env_abc123",
  "last_accessed": "2026-08-19T00:00:00Z",
  "sources": [
    {
      "type": "inline",
      "content": "print('Hello, World!')",
      "target": "main.py"
    }
  ],
  "status": "active",
  "updated": "2026-08-19T00:00:00Z"
}

ListEnvironments

merrni https://generativelanguage.googleapis.com/v1beta/environments

Liston mjediset.

Parametrat e Shtegut / Pyetjes

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

Opsionale. Numri maksimal i mjediseve për t'u kthyer.\nNëse nuk specifikohet, vlera parazgjedhur është 50. Maksimumi është 1000.

vargu i shenjës së faqes (opsional)

Opsionale. Shenjë për faqosje.

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 mjediseve ( Mjedisi ) (opsional)

Mjediset që i përkasin projektit të dhënë.

vargu i shenjës së faqes_next_page (opsional)

Shenjë e faqezimit.

Mjediset e listës

Shembull Përgjigjeje 

{
  "environments": [
    {
      "created": "2026-08-19T00:00:00Z",
      "id": "env_abc123",
      "last_accessed": "2026-08-19T00:00:00Z",
      "status": "active",
      "updated": "2026-08-19T00:00:00Z"
    }
  ]
}

GetEnvironmentFiles

merrni https://generativelanguage.googleapis.com/v1beta/environments/{environment}/files/{path}

Merr meta të dhënat e skedarëve ose përmbajtjen e direktorisë nga një pamje e çastit e një mjedisi. Për të shkarkuar drejtpërdrejt përmbajtjen e skedarëve, kaloni ?alt=media ose përdorni ndihmësin files.download.

Parametrat e Shtegut / Pyetjes

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

Opsionale. Numri maksimal i hyrjeve për t'u kthyer për faqe (për listën e direktorisë).

vargu i shenjës së faqes (opsional)

Opsionale. Shenjë faqezimi për listën e direktorive.

boolean rekursiv (opsional)

Opsionale. Nëse është e vërtetë dhe shtegu është një drejtori, rendit në mënyrë rekursive të gjithë skedarët.

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 skedarëve (EnvironmentFile) (opsionale)

Nëse shtegu i kërkuar është një drejtori, kjo përmban përmbajtjen e saj. Nëse shtegu i kërkuar është një skedar, kjo përmban një hyrje të vetme me meta të dhënat e skedarit. Nëse është specifikuar alt=media, kjo është bosh (përmbajtja shërbehet nëpërmjet `blob`).

Meta të dhënat për një skedar ose direktori brenda një mjedisi.

Fushat

varg i krijuar (opsional)

Vetëm rezultati. Koha e krijimit të skedarit/drejtorisë.

vargu mime_type (opsional)

Vetëm rezultati. Lloji MIME i skedarit (p.sh., "text/python", "image/png"). Bosh për drejtoritë. NOLINT

varg i modifikuar (opsional)

Vetëm rezultati. Koha e modifikimit të skedarit/drejtorisë.

varg emri (opsional)

Vetëm rezultati. Emri i skedarit ose direktorisë (p.sh., "main.py" ose "src").

vargu i shtegut (opsional)

Vetëm rezultati. Shtegu i plotë relativ brenda mjedisit (p.sh., "workspace/src/main.py").

vargu i madhësisë_së_bytes (opsional)

Vetëm rezultat. Madhësia e skedarit/drejtorisë në bajt. NOLINT

tipi enum (string) (opsionale)

Vetëm rezultati. Lloji i hyrjes.

Vlerat e mundshme:

  • file

    Një skedar i rregullt.

  • directory

    Një drejtori.

vargu i shenjës së faqes_next_page (opsional)

Shenjë e faqosjes për listën e direktorive. NOLINT

Listo skedarët në mjedis

Shembull Përgjigjeje 

{
  "files": [
    {
      "name": "src",
      "type": "directory",
      "created": "2026-08-19T00:00:00Z",
      "modified": "2026-08-19T00:00:00Z",
      "path": "src"
    },
    {
      "name": "main.py",
      "type": "file",
      "created": "2026-08-19T00:00:00Z",
      "mime_type": "text/x-python",
      "modified": "2026-08-19T00:00:00Z",
      "path": "main.py",
      "size_bytes": "22"
    }
  ]
}

Merr Metadatat e Skedarit

Shembull Përgjigjeje 

{
  "files": [
    {
      "name": "main.py",
      "type": "file",
      "created": "2026-08-19T00:00:00Z",
      "mime_type": "text/x-python",
      "modified": "2026-08-19T00:00:00Z",
      "path": "main.py",
      "size_bytes": "22"
    }
  ]
}

Shkarkoni përmbajtjen e skedarit

Shembull Përgjigjeje 

{
  "files": [
    {
      "name": "main.py",
      "type": "file",
      "mime_type": "text/x-python",
      "path": "main.py",
      "size_bytes": "22"
    }
  ]
}

GetEnvironment

merrni https://generativelanguage.googleapis.com/v1beta/environments/{id}

Merr një mjedis.

Përgjigje

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

varg i krijuar (opsional)

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

vargu file_count (opsional)

Vetëm rezultati. Numri i skedarëve në mjedis, vetëm rezultati.

vargu i identifikimit (opsional)

E detyrueshme. Vetëm rezultat. ID-ja e mjedisit.

vargu i aksesuar së fundmi (opsional)

Vetëm rezultati. Ora në të cilën mjedisi është aksesuar për herë të fundit në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

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.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

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 madhësisë_së_bytes (opsional)

Vetëm rezultati. Madhësia totale e skedarëve të mjedisit në bajt, vetëm rezultati.

vargu i burimeve (Burimi) (opsional)

Burimet që do të montohen në mjedis.

Një burim që do të montohet në mjedis.

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://).

numërimi i statusit (varg) (opsional)

Vetëm rezultati. Statusi i kontejnerit të mjedisit.

Vlerat e mundshme:

  • active

    Vetëm rezultati. Statusi i kontejnerit të mjedisit.

  • expired

    Vetëm rezultati. Statusi i kontejnerit të mjedisit.

varg i përditësuar (opsional)

Vetëm rezultati. Ora në të cilën mjedisi është përditësuar për herë të fundit në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

Merr Mjedisin

Shembull Përgjigjeje 

{
  "created": "2026-08-19T00:00:00Z",
  "id": "env_abc123",
  "last_accessed": "2026-08-19T00:00:00Z",
  "sources": [
    {
      "type": "inline",
      "content": "print('Hello, World!')",
      "target": "main.py"
    }
  ],
  "status": "active",
  "updated": "2026-08-19T00:00:00Z"
}

FshijMjedisin

fshi https://generativelanguage.googleapis.com/v1beta/environments/{id}

Fshin një mjedis.

Përgjigje

Nëse ka sukses, përgjigja është bosh.

Fshij Mjedisin

Burimet

Mjedisi

Një mjedis ekzekutimi për një agjent.

Fushat

varg i krijuar (opsional)

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

vargu file_count (opsional)

Vetëm rezultati. Numri i skedarëve në mjedis, vetëm rezultati.

vargu i identifikimit (opsional)

E detyrueshme. Vetëm rezultat. ID-ja e mjedisit.

vargu i aksesuar së fundmi (opsional)

Vetëm rezultati. Ora në të cilën mjedisi është aksesuar për herë të fundit në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

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.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

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 madhësisë_së_bytes (opsional)

Vetëm rezultati. Madhësia totale e skedarëve të mjedisit në bajt, vetëm rezultati.

vargu i burimeve (Burimi) (opsional)

Burimet që do të montohen në mjedis.

Një burim që do të montohet në mjedis.

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://).

numërimi i statusit (varg) (opsional)

Vetëm rezultati. Statusi i kontejnerit të mjedisit.

Vlerat e mundshme:

  • active

    Vetëm rezultati. Statusi i kontejnerit të mjedisit.

  • expired

    Vetëm rezultati. Statusi i kontejnerit të mjedisit.

varg i përditësuar (opsional)

Vetëm rezultati. Ora në të cilën mjedisi është përditësuar për herë të fundit në formatin ISO 8601 (YYYY-MM-DDThh:mm:ssZ).