Perissions

तरीका: TunModels.permissions.create

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

एंडपॉइंट

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

पाथ पैरामीटर

parent string

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

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

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

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

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",
)

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

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

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

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

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

तरीका: TunModels.permissions.list

यह डायलॉग बॉक्स किसी खास संसाधन के लिए अनुमतियों की जानकारी देता है.

एंडपॉइंट

पाएं 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)

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

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

तरीका: tuneModels.permissions.patch

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

एंडपॉइंट

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

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

पाथ पैरामीटर

permission.name string

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

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

updateMask string (FieldMask format)

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

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

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

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

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

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()

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

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

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

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

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

तरीका: TunModels.transferOwner

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

एंडपॉइंट

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

पाथ पैरामीटर

name string

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

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

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

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

फ़ील्ड
emailAddress string

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

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

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

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

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

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

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

इसमें तीन भूमिकाएं एक-दूसरे से जुड़ी हुई होती हैं. हर भूमिका, पिछली भूमिका की अनुमति वाली कार्रवाइयों का सुपरसेट है:

  • पाठक, अनुमान लगाने के लिए संसाधन (जैसे कि ट्यून किया गया मॉडल, कॉर्पस) का इस्तेमाल कर सकता है
  • लेखक के पास लोगों की अनुमतियां होती हैं. इसके अलावा, वह लेखक के कॉन्टेंट में बदलाव और उसे शेयर भी कर सकता है
  • मालिक के पास लेखक की अनुमतियां हैं और वे दस्तावेज़ को मिटा भी सकते हैं
JSON के काेड में दिखाना 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
फ़ील्ड
name string

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

granteeType enum (GranteeType)

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

emailAddress string

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

role enum (Role)

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

ListPermissionsResponse

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

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

अनुमतियां दी गईं.

nextPageToken string

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

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