Gemini Environments API

CreateEnvironment

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

यह फ़ंक्शन, एनवायरमेंट बनाता है.

अनुरोध का मुख्य हिस्सा
जवाब

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

network EnvironmentNetworkEgressAllowlist या enum (string) (ज़रूरी नहीं)

एनवायरमेंट के लिए नेटवर्क कॉन्फ़िगरेशन.

संभावित टाइप

object

सैंडबॉक्स के लिए आउटबाउंड नेटवर्किंग कॉन्फ़िगरेशन. यह विकल्प चुनने पर, यह तय किया जा सकता है कि सैंडबॉक्स किन बाहरी डोमेन तक पहुंच सकता है. इसे पूरी तरह से हटा दें, ताकि हेडर इंजेक्शन के बिना सभी आउटबाउंड ट्रैफ़िक को अनुमति दी जा सके.

allowlist array (AllowlistEntry) (ज़रूरी नहीं)

अनुमति वाले आउटबाउंड डोमेन की सूची. सिर्फ़ सूची में शामिल डोमेन के अनुरोधों को अनुमति दी जाती है. कुछ डोमेन पर हेडर इंजेक्ट करते समय, सभी डोमेन को अनुमति देने के लिए [{'domain': '*'}] का इस्तेमाल करें.

फ़ील्ड

domain string (ज़रूरी नहीं)

वह डोमेन जिस पर आउटबाउंड अनुरोधों को अनुमति देनी है. वाइल्डकार्ड (जैसे, '*.googleapis.com') का इस्तेमाल किया जा सकता है. सभी डोमेन को अनुमति देने के लिए, '*' का इस्तेमाल करें.

transform array (object) or object (ज़रूरी नहीं)

इस डोमेन से मैच करने वाले सभी आउटबाउंड अनुरोधों में शामिल किए जाने वाले हेडर. यह एक डिक्ट या डिक्ट की सूची स्वीकार करता है. इग्रेस प्रॉक्सी, इन्हें अपने-आप इंजेक्ट करती है.

string

सभी नेटवर्क बंद कर देता है.

संभावित वैल्यू

disabled
सभी नेटवर्क बंद कर देता है.

sources array (Source) (ज़रूरी नहीं)

ऐसे सोर्स जिन्हें एनवायरमेंट में माउंट किया जाना है.

फ़ील्ड

content string (ज़रूरी नहीं)

अगर `type` की वैल्यू `INLINE` है, तो इनलाइन कॉन्टेंट.

encoding string (ज़रूरी नहीं)

इनलाइन कॉन्टेंट के लिए, कोड में बदलने का वैकल्पिक तरीका (जैसे, `base64`).

source string (ज़रूरी नहीं)

एनवायरमेंट का सोर्स. Cloud Storage के लिए, यह Cloud Storage का पाथ होता है. GitHub के लिए, यह GitHub का पाथ होता है.

target string (ज़रूरी नहीं)

सोर्स को एनवायरमेंट में कहां दिखना चाहिए.

type enum (string) (ज़रूरी नहीं)

कोई विवरण नहीं दिया गया.

इस्तेमाल की जा सकने वाली वैल्यू:

gcs
Cloud Storage बकेट.
inline
इनलाइन कॉन्टेंट.
repository
सामान्य रिपॉज़िटरी. सोर्स यूआरएल में मौजूद प्रोटोकॉल प्रीफ़िक्स, प्रोवाइडर की पहचान करता है. जैसे, github://, gcs://.

जवाब

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

created string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, एनवायरमेंट बनाने का समय.

file_count string (optional)

सिर्फ़ आउटपुट के लिए. एनवायरमेंट में मौजूद फ़ाइलों की संख्या. यह सिर्फ़ आउटपुट के लिए है.

id string (ज़रूरी नहीं)

ज़रूरी है. सिर्फ़ आउटपुट के लिए. एनवायरमेंट का आईडी.

last_accessed string (optional)

सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, वह समय जब एनवायरमेंट को आखिरी बार ऐक्सेस किया गया था.

network EnvironmentNetworkEgressAllowlist या enum (string) (ज़रूरी नहीं)

एनवायरमेंट के लिए नेटवर्क कॉन्फ़िगरेशन.

संभावित टाइप

object

सैंडबॉक्स के लिए आउटबाउंड नेटवर्किंग कॉन्फ़िगरेशन. यह विकल्प चुनने पर, यह तय किया जा सकता है कि सैंडबॉक्स किन बाहरी डोमेन तक पहुंच सकता है. इसे पूरी तरह से हटा दें, ताकि हेडर इंजेक्शन के बिना सभी आउटबाउंड ट्रैफ़िक को अनुमति दी जा सके.

allowlist array (AllowlistEntry) (ज़रूरी नहीं)

अनुमति वाले आउटबाउंड डोमेन की सूची. सिर्फ़ सूची में शामिल डोमेन के अनुरोधों को अनुमति दी जाती है. कुछ डोमेन पर हेडर इंजेक्ट करते समय, सभी डोमेन को अनुमति देने के लिए [{'domain': '*'}] का इस्तेमाल करें.

फ़ील्ड

domain string (ज़रूरी नहीं)

वह डोमेन जिस पर आउटबाउंड अनुरोधों को अनुमति देनी है. वाइल्डकार्ड (जैसे, '*.googleapis.com') का इस्तेमाल किया जा सकता है. सभी डोमेन को अनुमति देने के लिए, '*' का इस्तेमाल करें.

transform array (object) or object (ज़रूरी नहीं)

इस डोमेन से मैच करने वाले सभी आउटबाउंड अनुरोधों में शामिल किए जाने वाले हेडर. यह एक डिक्ट या डिक्ट की सूची स्वीकार करता है. इग्रेस प्रॉक्सी, इन्हें अपने-आप इंजेक्ट करती है.

string

सभी नेटवर्क बंद कर देता है.

संभावित वैल्यू

disabled
सभी नेटवर्क बंद कर देता है.

size_bytes string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. एनवायरमेंट फ़ाइलों का कुल साइज़, बाइट में. यह सिर्फ़ आउटपुट होता है.

sources array (Source) (ज़रूरी नहीं)

ऐसे सोर्स जिन्हें एनवायरमेंट में माउंट किया जाना है.

फ़ील्ड

content string (ज़रूरी नहीं)

अगर `type` की वैल्यू `INLINE` है, तो इनलाइन कॉन्टेंट.

encoding string (ज़रूरी नहीं)

इनलाइन कॉन्टेंट के लिए, कोड में बदलने का वैकल्पिक तरीका (जैसे, `base64`).

source string (ज़रूरी नहीं)

एनवायरमेंट का सोर्स. Cloud Storage के लिए, यह Cloud Storage का पाथ होता है. GitHub के लिए, यह GitHub का पाथ होता है.

target string (ज़रूरी नहीं)

सोर्स को एनवायरमेंट में कहां दिखना चाहिए.

type enum (string) (ज़रूरी नहीं)

कोई विवरण नहीं दिया गया.

इस्तेमाल की जा सकने वाली वैल्यू:

gcs
Cloud Storage बकेट.
inline
इनलाइन कॉन्टेंट.
repository
सामान्य रिपॉज़िटरी. सोर्स यूआरएल में मौजूद प्रोटोकॉल प्रीफ़िक्स, प्रोवाइडर की पहचान करता है. जैसे, github://, gcs://.

status enum (string) (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. एनवायरमेंट कंटेनर का स्टेटस.

इस्तेमाल की जा सकने वाली वैल्यू:

active
सिर्फ़ आउटपुट के लिए. एनवायरमेंट कंटेनर का स्टेटस.
expired
सिर्फ़ आउटपुट के लिए. एनवायरमेंट कंटेनर का स्टेटस.

updated string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, वह समय जब एनवायरमेंट को पिछली बार अपडेट किया गया था.

परिवेश बनाएं

प्रतिक्रिया का उदाहरण

{
  "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

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

एनवायरमेंट की सूची बनाता है.

पाथ / क्वेरी पैरामीटर
जवाब

पाथ / क्वेरी पैरामीटर

page_size integer (ज़रूरी नहीं)

ज़रूरी नहीं. वापस लाए जाने वाले एनवायरमेंट की ज़्यादा से ज़्यादा संख्या.\nअगर यह तय नहीं की जाती है, तो डिफ़ॉल्ट रूप से 50 पर सेट होती है. इनकी संख्या ज़्यादा से ज़्यादा 1,000 हो सकती है.

page_token string (optional)

ज़रूरी नहीं. पेज नंबर के हिसाब से नतीजे दिखाने वाला टोकन.

जवाब

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

environments array (Environment) (ज़रूरी नहीं)

दिए गए प्रोजेक्ट से जुड़े एनवायरमेंट.

next_page_token string (ज़रूरी नहीं)

पेज नंबर के हिसाब से नतीजे दिखाने वाला टोकन.

एनवायरमेंट की सूची बनाना

प्रतिक्रिया का उदाहरण

{
  "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

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

यह किसी एनवायरमेंट के स्नैपशॉट से फ़ाइल का मेटाडेटा या डायरेक्ट्री का कॉन्टेंट वापस लाता है. फ़ाइल के कॉन्टेंट को सीधे डाउनलोड करने के लिए, ?alt=media पास करें या files.download हेल्पर का इस्तेमाल करें.

पाथ / क्वेरी पैरामीटर
जवाब

पाथ / क्वेरी पैरामीटर

page_size integer (ज़रूरी नहीं)

ज़रूरी नहीं. हर पेज पर दिखाई जाने वाली ज़्यादा से ज़्यादा एंट्री की संख्या (डायरेक्ट्री लिस्टिंग के लिए).

page_token string (optional)

ज़रूरी नहीं. डायरेक्ट्री लिस्टिंग के लिए पेज नंबर बदलने का टोकन.

recursive boolean (ज़रूरी नहीं)

ज़रूरी नहीं. अगर यह विकल्प सही है और पाथ एक डायरेक्ट्री है, तो सभी फ़ाइलों की सूची को बार-बार दिखाया जाता है.

जवाब

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

files array (EnvironmentFile) (ज़रूरी नहीं)

अगर अनुरोध किया गया पाथ कोई डायरेक्ट्री है, तो इसमें उसका कॉन्टेंट शामिल होता है. अगर अनुरोध किया गया पाथ कोई फ़ाइल है, तो इसमें फ़ाइल के मेटाडेटा के साथ एक एंट्री होती है. अगर alt=media तय किया गया था, तो यह खाली होता है (कॉन्टेंट, `blob` के ज़रिए दिखाया जाता है).

फ़ील्ड

created string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. फ़ाइल/डायरेक्ट्री बनाए जाने का समय.

mime_type string (optional)

सिर्फ़ आउटपुट के लिए. फ़ाइल का एमआईएमई टाइप (जैसे, "text/python", "image/png"). डायरेक्ट्री के लिए, यह फ़ील्ड खाली होता है. NOLINT

modified string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. फ़ाइल/डायरेक्ट्री में बदलाव किए जाने का समय.

name string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. फ़ाइल या डायरेक्ट्री का नाम. उदाहरण के लिए, "main.py" या "src".

path string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. एनवायरमेंट में मौजूद पूरा रिलेटिव पाथ (जैसे, "workspace/src/main.py").

size_bytes string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. फ़ाइल/डायरेक्ट्री का साइज़, बाइट में. NOLINT

type enum (string) (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. यह किस तरह की एंट्री है.

इस्तेमाल की जा सकने वाली वैल्यू:

file
सामान्य फ़ाइल.
directory
एक डायरेक्ट्री.

next_page_token string (ज़रूरी नहीं)

डायरेक्ट्री लिस्टिंग के लिए पेज नंबर बदलने का टोकन. NOLINT

एनवायरमेंट में मौजूद फ़ाइलों की सूची बनाना

प्रतिक्रिया का उदाहरण

{
  "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"
    }
  ]
}

फ़ाइल का मेटाडेटा पाना

प्रतिक्रिया का उदाहरण

{
  "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"
    }
  ]
}

फ़ाइल का कॉन्टेंट डाउनलोड करें

प्रतिक्रिया का उदाहरण

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

GetEnvironment

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

किसी एनवायरमेंट को ऐक्सेस करता है.

जवाब

जवाब

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

created string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, एनवायरमेंट बनाने का समय.

file_count string (optional)

सिर्फ़ आउटपुट के लिए. एनवायरमेंट में मौजूद फ़ाइलों की संख्या. यह सिर्फ़ आउटपुट के लिए है.

id string (ज़रूरी नहीं)

ज़रूरी है. सिर्फ़ आउटपुट के लिए. एनवायरमेंट का आईडी.

last_accessed string (optional)

सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, वह समय जब एनवायरमेंट को आखिरी बार ऐक्सेस किया गया था.

network EnvironmentNetworkEgressAllowlist या enum (string) (ज़रूरी नहीं)

एनवायरमेंट के लिए नेटवर्क कॉन्फ़िगरेशन.

संभावित टाइप

object

सैंडबॉक्स के लिए आउटबाउंड नेटवर्किंग कॉन्फ़िगरेशन. यह विकल्प चुनने पर, यह तय किया जा सकता है कि सैंडबॉक्स किन बाहरी डोमेन तक पहुंच सकता है. इसे पूरी तरह से हटा दें, ताकि हेडर इंजेक्शन के बिना सभी आउटबाउंड ट्रैफ़िक को अनुमति दी जा सके.

allowlist array (AllowlistEntry) (ज़रूरी नहीं)

अनुमति वाले आउटबाउंड डोमेन की सूची. सिर्फ़ सूची में शामिल डोमेन के अनुरोधों को अनुमति दी जाती है. कुछ डोमेन पर हेडर इंजेक्ट करते समय, सभी डोमेन को अनुमति देने के लिए [{'domain': '*'}] का इस्तेमाल करें.

फ़ील्ड

domain string (ज़रूरी नहीं)

वह डोमेन जिस पर आउटबाउंड अनुरोधों को अनुमति देनी है. वाइल्डकार्ड (जैसे, '*.googleapis.com') का इस्तेमाल किया जा सकता है. सभी डोमेन को अनुमति देने के लिए, '*' का इस्तेमाल करें.

transform array (object) or object (ज़रूरी नहीं)

इस डोमेन से मैच करने वाले सभी आउटबाउंड अनुरोधों में शामिल किए जाने वाले हेडर. यह एक डिक्ट या डिक्ट की सूची स्वीकार करता है. इग्रेस प्रॉक्सी, इन्हें अपने-आप इंजेक्ट करती है.

string

सभी नेटवर्क बंद कर देता है.

संभावित वैल्यू

disabled
सभी नेटवर्क बंद कर देता है.

size_bytes string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. एनवायरमेंट फ़ाइलों का कुल साइज़, बाइट में. यह सिर्फ़ आउटपुट होता है.

sources array (Source) (ज़रूरी नहीं)

ऐसे सोर्स जिन्हें एनवायरमेंट में माउंट किया जाना है.

फ़ील्ड

content string (ज़रूरी नहीं)

अगर `type` की वैल्यू `INLINE` है, तो इनलाइन कॉन्टेंट.

encoding string (ज़रूरी नहीं)

इनलाइन कॉन्टेंट के लिए, कोड में बदलने का वैकल्पिक तरीका (जैसे, `base64`).

source string (ज़रूरी नहीं)

एनवायरमेंट का सोर्स. Cloud Storage के लिए, यह Cloud Storage का पाथ होता है. GitHub के लिए, यह GitHub का पाथ होता है.

target string (ज़रूरी नहीं)

सोर्स को एनवायरमेंट में कहां दिखना चाहिए.

type enum (string) (ज़रूरी नहीं)

कोई विवरण नहीं दिया गया.

इस्तेमाल की जा सकने वाली वैल्यू:

gcs
Cloud Storage बकेट.
inline
इनलाइन कॉन्टेंट.
repository
सामान्य रिपॉज़िटरी. सोर्स यूआरएल में मौजूद प्रोटोकॉल प्रीफ़िक्स, प्रोवाइडर की पहचान करता है. जैसे, github://, gcs://.

status enum (string) (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. एनवायरमेंट कंटेनर का स्टेटस.

इस्तेमाल की जा सकने वाली वैल्यू:

active
सिर्फ़ आउटपुट के लिए. एनवायरमेंट कंटेनर का स्टेटस.
expired
सिर्फ़ आउटपुट के लिए. एनवायरमेंट कंटेनर का स्टेटस.

updated string (ज़रूरी नहीं)

सिर्फ़ आउटपुट के लिए. आईएसओ 8601 फ़ॉर्मैट (YYYY-MM-DDThh:mm:ssZ) में, वह समय जब एनवायरमेंट को पिछली बार अपडेट किया गया था.

एनवायरमेंट की जानकारी पाना

प्रतिक्रिया का उदाहरण

{
  "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"
}

DeleteEnvironment

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

इस तरीके का इस्तेमाल करके, किसी एनवायरमेंट को मिटाया जा सकता है.

जवाब

जवाब

अगर अनुरोध पूरा हो जाता है, तो जवाब में कोई डेटा नहीं होता.

CreateEnvironment

अनुरोध का मुख्य भाग

संभावित टाइप

फ़ील्ड

संभावित वैल्यू

फ़ील्ड

जवाब

संभावित टाइप

फ़ील्ड

संभावित वैल्यू

फ़ील्ड

परिवेश बनाएं

प्रतिक्रिया का उदाहरण

ListEnvironments

पाथ / क्वेरी पैरामीटर

जवाब

एनवायरमेंट की सूची बनाना

प्रतिक्रिया का उदाहरण

GetEnvironmentFiles

पाथ / क्वेरी पैरामीटर

जवाब

फ़ील्ड

एनवायरमेंट में मौजूद फ़ाइलों की सूची बनाना

प्रतिक्रिया का उदाहरण

फ़ाइल का मेटाडेटा पाना

प्रतिक्रिया का उदाहरण

फ़ाइल का कॉन्टेंट डाउनलोड करें

प्रतिक्रिया का उदाहरण

GetEnvironment

जवाब

संभावित टाइप

फ़ील्ड

संभावित वैल्यू

फ़ील्ड

एनवायरमेंट की जानकारी पाना

प्रतिक्रिया का उदाहरण

DeleteEnvironment

जवाब

एनवायरमेंट मिटाएं

संसाधन

परिवेश

फ़ील्ड

संभावित टाइप

फ़ील्ड

संभावित वैल्यू

फ़ील्ड