Permissions

तरीका: tunedModels.permissions.create

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

एंडपॉइंट

post https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

पाथ पैरामीटर

parent string

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

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

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

Fields
granteeType enum (GranteeType)

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

emailAddress string

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

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 का नया इंस्टेंस शामिल किया जाता है.

तरीका: tunedModels.permissions.get

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

एंडपॉइंट

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

पाथ पैरामीटर

name string

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

फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} यह tunedModels/{tunedmodel}/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 का एक इंस्टेंस शामिल किया जाता है.

तरीका: tunedModels.permissions.list

इस तरीके से, किसी संसाधन के लिए अनुमतियों की सूची मिलती है.

एंडपॉइंट

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

पाथ पैरामीटर

parent string

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

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

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 का एक इंस्टेंस शामिल किया जाता है.

तरीका: tunedModels.permissions.patch

यह कुकी, अनुमति को अपडेट करती है.

एंडपॉइंट

patch https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

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

पाथ पैरामीटर

permission.name string

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

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

updateMask string (FieldMask format)

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

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

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

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

Fields
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 का एक इंस्टेंस शामिल किया जाता है.

Method: tunedModels.permissions.delete

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

एंडपॉइंट

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

पाथ पैरामीटर

name string

ज़रूरी है. अनुमति के संसाधन का नाम. फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} यह tunedModels/{tunedmodel}/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 ऑब्जेक्ट होता है.

तरीका: tunedModels.transferOwnership

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

एंडपॉइंट

post https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

पाथ पैरामीटर

name string

ज़रूरी है. जिस ट्यून किए गए मॉडल का मालिकाना हक ट्रांसफ़र करना है उसके संसाधन का नाम.

फ़ॉर्मैट: tunedModels/my-model-id यह tunedModels/{tunedmodel} के तौर पर दिखता है.

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

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

Fields
emailAddress string

ज़रूरी है. उस उपयोगकर्ता का ईमेल पता जिसे ट्यून किया गया मॉडल ट्रांसफ़र किया जा रहा है.

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

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

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

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

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

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

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

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

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

granteeType enum (GranteeType)

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

emailAddress string

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

role enum (Role)

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

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

ListPermissionsResponse

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

Fields
permissions[] object (Permission)

अनुमतियां वापस मिल जाती हैं.

nextPageToken string

यह एक टोकन है. इसका इस्तेमाल अगले पेज को वापस पाने के लिए, pageToken के तौर पर किया जा सकता है.

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

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