Corpus Permissions

तरीका: corpora.permissions.create

किसी खास संसाधन के लिए अनुमति बनाएं.

एंडपॉइंट

पोस्ट https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*}/permissions

पाथ पैरामीटर

parent string

ज़रूरी है. Permission का पैरंट रिसॉर्स. फ़ॉर्मैट: tunedModels/{tunedModel} corpora/{corpus} इसका फ़ॉर्मैट corpora/{corpora} होता है.

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

अनुरोध के मुख्य भाग में Permission का उदाहरण है.

फ़ील्ड
granteeType enum (GranteeType)

ज़रूरी नहीं. इम्यूटेबल. अनुदान पाने वाले व्यक्ति या इकाई का टाइप.

emailAddress string

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

role enum (Role)

ज़रूरी है. इस अनुमति से मिली भूमिका.

अनुरोध का उदाहरण

Python
# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Permission का नया इंस्टेंस शामिल किया जाता है.

तरीका: corpora.permissions.list

किसी खास संसाधन के लिए अनुमतियां दिखाता है.

एंडपॉइंट

get https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*}/permissions

पाथ पैरामीटर

parent string

ज़रूरी है. अनुमतियों का पैरंट रिसॉर्स. फ़ॉर्मैट: tunedModels/{tunedModel} corpora/{corpus} इसका फ़ॉर्मैट corpora/{corpora} होता है.

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

pageSize integer

ज़रूरी नहीं. हर पेज पर, ज़्यादा से ज़्यादा कितने Permission दिखाए जाएं. ऐसा हो सकता है कि सेवा कम अनुमतियां दिखाए.

अगर कोई संख्या नहीं दी जाती है, तो ज़्यादा से ज़्यादा 10 अनुमतियां दी जाएंगी. इस तरीके से, हर पेज पर ज़्यादा से ज़्यादा 1,000 अनुमतियां मिलती हैं. भले ही, आपने ज़्यादा pageSize पास किया हो.

pageToken string

ज़रूरी नहीं. पेज टोकन, जो पिछले permissions.list कॉल से मिला था.

अगला पेज पाने के लिए, एक अनुरोध से मिला pageToken, अगले अनुरोध के आर्ग्युमेंट के तौर पर दें.

पेजेशन करते समय, permissions.list के लिए दिए गए सभी अन्य पैरामीटर, उस कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया था.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

अनुरोध का उदाहरण

Python
# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में ListPermissionsResponse का एक इंस्टेंस शामिल किया जाता है.

तरीका: corpora.permissions.get

किसी खास अनुमति के बारे में जानकारी मिलती है.

एंडपॉइंट

get https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/permissions/*}

पाथ पैरामीटर

name string

ज़रूरी है. अनुमति का संसाधन नाम.

फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} इसका फ़ॉर्मैट corpora/{corpora}/permissions/{permission} होता है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

अनुरोध का उदाहरण

Python
# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Permission का एक इंस्टेंस शामिल किया जाता है.

तरीका: corpora.permissions.patch

अनुमति अपडेट करता है.

एंडपॉइंट

पैच https://generativelanguage.googleapis.com/v1beta/{permission.name=corpora/*/permissions/*}

PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=corpora/*/permissions/*}

पाथ पैरामीटर

permission.name string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. अनुमति का नाम. कैंपेन बनाने पर, एक यूनीक नाम जनरेट हो जाएगा. उदाहरण: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} सिर्फ़ आउटपुट के लिए. यह corpora/{corpora}/permissions/{permission} फ़ॉर्मैट में होता है.

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

updateMask string (FieldMask format)

ज़रूरी है. अपडेट किए जाने वाले फ़ील्ड की सूची. स्वीकार किए गए फ़ील्ड: - भूमिका (Permission.role फ़ील्ड)

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: "user.displayName,photo".

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

अनुरोध के मुख्य भाग में Permission का उदाहरण है.

फ़ील्ड
role enum (Role)

ज़रूरी है. इस अनुमति से मिली भूमिका.

अनुरोध का उदाहरण

Python
# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Permission का एक इंस्टेंस शामिल किया जाता है.

तरीका: corpora.permissions.delete

अनुमति मिटाता है.

एंडपॉइंट

delete https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/permissions/*}

पाथ पैरामीटर

name string

ज़रूरी है. अनुमति का संसाधन नाम. फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} इसका फ़ॉर्मैट corpora/{corpora}/permissions/{permission} होता है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

अनुरोध का उदाहरण

Python
# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, तो रिस्पॉन्स बॉडी में खाली JSON ऑब्जेक्ट होता है.

REST रिसॉर्स: corpora.permissions

संसाधन: अनुमति

अनुमति संसाधन, उपयोगकर्ता, ग्रुप या दुनिया भर के लोगों को PaLM API संसाधन (जैसे, ट्यून किया गया मॉडल, कॉर्पस) का ऐक्सेस देता है.

भूमिका, अनुमति वाले ऑपरेशन का एक कलेक्शन है. इसकी मदद से, उपयोगकर्ता PaLM API के संसाधनों पर खास कार्रवाइयां कर सकते हैं. उन्हें उपयोगकर्ताओं, ग्रुप या सेवा खातों के लिए उपलब्ध कराने के लिए, उन्हें भूमिकाएं असाइन की जाती हैं. किसी भूमिका को असाइन करने पर, उस भूमिका से जुड़ी अनुमतियां मिल जाती हैं.

इसमें तीन भूमिकाएं होती हैं. हर रोल, पिछली रोल के लिए अनुमति वाले ऑपरेशन का सुपरसेट होती है:

  • अनुमान लगाने के लिए, रीडर संसाधन (जैसे, ट्यून किया गया मॉडल, कॉर्पस) का इस्तेमाल कर सकता है
  • लेखक के पास रीडर की अनुमतियां होती हैं. साथ ही, वह बदलाव कर सकता है और शेयर कर सकता है
  • मालिक के पास लेखक की अनुमतियां होती हैं. साथ ही, वह फ़ाइल को मिटा सकता है
फ़ील्ड
name string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. अनुमति का नाम. कैंपेन बनाने पर, एक यूनीक नाम जनरेट हो जाएगा. उदाहरण: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} सिर्फ़ आउटपुट के लिए.

granteeType enum (GranteeType)

ज़रूरी नहीं. इम्यूटेबल. अनुदान पाने वाले व्यक्ति या इकाई का टाइप.

emailAddress string

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

role enum (Role)

ज़रूरी है. इस अनुमति से मिली भूमिका.

JSON के काेड में दिखाना 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

GranteeType

इस अनुमति को पाने वाले लोगों के टाइप तय करता है.

Enums
GRANTEE_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इस वैल्यू का इस्तेमाल नहीं किया जाता.
USER किसी उपयोगकर्ता की जानकारी दिखाता है. सेट करने के बाद, आपको उपयोगकर्ता के लिए ईमेल पता देना होगा.
GROUP किसी ग्रुप को दिखाता है. सेट करने के बाद, आपको ग्रुप के लिए ईमेल पता देना होगा.
EVERYONE सभी के लिए ऐक्सेस दिखाता है. इसके लिए, कोई और जानकारी देने की ज़रूरत नहीं है.

भूमिका

इस अनुमति से मिली भूमिका के बारे में बताता है.

Enums
ROLE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इस वैल्यू का इस्तेमाल नहीं किया जाता.
OWNER मालिक, संसाधन का इस्तेमाल कर सकता है, उसे अपडेट कर सकता है, शेयर कर सकता है, और मिटा सकता है.
WRITER लेखक, संसाधन का इस्तेमाल कर सकता है, उसे अपडेट कर सकता है, और शेयर कर सकता है.
READER रीडर, संसाधन का इस्तेमाल कर सकता है.

ListPermissionsResponse

ListPermissions से मिला जवाब, जिसमें पेज पर मौजूद अनुमतियों की सूची शामिल है.

फ़ील्ड
permissions[] object (Permission)

वापस ली गई अनुमतियां.

nextPageToken string

एक टोकन, जिसे अगले पेज को फिर से पाने के लिए pageToken के तौर पर भेजा जा सकता है.

अगर इस फ़ील्ड को छोड़ा जाता है, तो इसका मतलब है कि कोई और पेज नहीं है.

JSON के काेड में दिखाना 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}