अब Gemini 1.5 Pro 2M कॉन्टेक्स्ट विंडो, कोड लागू करने की सुविधाएँ, और Gemma 2 उपलब्ध हैं. ज़्यादा जानें

इस पेज का अनुवाद Cloud Translation API से किया गया है.

Corpus Perissions

तरीका: कॉर्पोरा.permissions.list

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

एंडपॉइंट

पाएं


                  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

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

# ...

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

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

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

तरीका: कॉर्पोरा.permissions.delete

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

एंडपॉइंट

मिटाएं


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

पाथ पैरामीटर

name string

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

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

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

तरीका: Corpara.permissions.create

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

एंडपॉइंट

पोस्ट


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

पाथ पैरामीटर

parent string

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

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

अनुरोध के मुख्य भाग में 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 का नया इंस्टेंस शामिल किया जाता है.

तरीका: कॉर्पोरा.permissions.patch

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

एंडपॉइंट

पैच


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

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

पाथ पैरामीटर

permission.name string

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

तरीका: कॉर्पोरा.permissions.get

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

एंडपॉइंट

पाएं


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

पाथ पैरामीटर

name string

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

फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} यह corpora/{corpora}/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)

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

REST रिसॉर्स: कॉर्पोरा.permissions

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

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

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

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

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

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

फ़ील्ड

name string

granteeType enum (GranteeType)

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

emailAddress string

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

role enum (Role)

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

GranteeType

यह बताता है कि यह अनुमति किस तरह की है.

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

भूमिका

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

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

ListPermissionsResponse

JSON काेड में दिखाना

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

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

फ़ील्ड

permissions[] object (Permission)

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

nextPageToken string

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

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