Permissions

तरीका: tunedModels.permissions.create

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

एंडपॉइंट

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

पाथ पैरामीटर

parent string

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

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

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

फ़ील्ड
granteeType enum (GranteeType)

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

emailAddress string

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

role enum (Role)

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

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

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

group_permission = model_info.permissions.create(
    role="READER",
    # Use "user" for an individual email address.
    grantee_type="group",
    email_address="genai-samples-test-group@googlegroups.com",
)
tuned_models.py

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

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

तरीका: tunedModels.permissions.get

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

एंडपॉइंट

पाएं https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

पाथ पैरामीटर

name string

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

फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} यह tunedModels/{tunedmodel}/permissions/{permission} का रूप लेता है.

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

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

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

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

public = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)
print(public)
name = public.name
print(name)  # tunedModels/{tunedModel}/permissions/{permission}

from_name = genai.types.Permissions.get(name)
print(from_name)
tuned_models.py

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

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

तरीका: TunerModels.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

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

for p in model_info.permissions.list():
    print(p)
tuned_models.py

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

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

तरीका: tunedModels.permissions.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 का उदाहरण है.

फ़ील्ड
role enum (Role)

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

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

Python

        model_info = genai.get_model("tunedModels/my-increment-model")

        # ...

        test_group = model_info.permissions.create(
            role="writer",
            grantee_type="group",
            email_address="genai-samples-test-group@googlegroups.com",
        )

        test_group.update({"role": "READER"})

    def test_tuned_models_permission_delete(self):
        model_info = genai.get_model("tunedModels/my-increment-model")
        # ...

        public_permission = model_info.permissions.create(
            role="READER",
            grantee_type="EVERYONE",
        )

        public_permission.delete()


if __name__ == "__main__":
    absltest.main()

tuned_models.py

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

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

तरीका: 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

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

public_permission.delete()
tuned_models.py

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

जवाब सही होने पर, जवाब का मुख्य हिस्सा खाली होता है.

तरीका: tunedModels.transferOwnership

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

एंडपॉइंट

पोस्ट https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

पाथ पैरामीटर

name string

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

फ़ॉर्मैट: tunedModels/my-model-id यह tunedModels/{tunedmodel} फ़ॉर्मैट में होता है.

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

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

फ़ील्ड
emailAddress string

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

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

जवाब सही होने पर, जवाब का मुख्य हिस्सा खाली होता है.

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

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

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

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

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

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

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

granteeType enum (GranteeType)

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

emailAddress string

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

role enum (Role)

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

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

ListPermissionsResponse

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

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

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

nextPageToken string

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

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

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