Corpus Permissions

Metoda: corpora.permissions.create

Krijo një leje për një burim specifik.

Pika përfundimtare

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

Parametrat e rrugës

parent string

E detyrueshme. Burimi mëmë i Permission . Formatet: tunedModels/{tunedModel} corpora/{corpus} Merr formën corpora/{corpora} .

Trupi i kërkesës

Trupi i kërkesës përmban një shembull të Permission .

Fushat
enum granteeType enum ( GranteeType )

Fakultative. E pandryshueshme. Lloji i përfituesit të grantit.

string emailAddress

Fakultative. E pandryshueshme. Adresa e emailit të përdoruesit të grupit të cilit i referohet kjo leje. Fusha nuk caktohet kur lloji i përfituesit të lejes është GJITHË.

role enum ( Role )

E detyrueshme. Roli i dhënë nga kjo leje.

Shembull i kërkesës

Python 

import google.generativeai as genai

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

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të sapokrijuar të Permission .

Metoda: corpora.permissions.list

Liston lejet për burimin specifik.

Pika përfundimtare

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

Parametrat e rrugës

parent string

E detyrueshme. Burimi prind i lejeve. Formatet: tunedModels/{tunedModel} corpora/{corpus} Merr formën corpora/{corpora} .

Parametrat e pyetjes

integer pageSize

Fakultative. Numri maksimal i Permission për t'u kthyer (për faqe). Shërbimi mund të kthejë më pak leje.

Nëse nuk specifikohet, maksimumi 10 leje do të kthehen. Kjo metodë kthen më së shumti 1000 leje për faqe, edhe nëse kaloni një faqe më të madhe.

string pageToken

Fakultative. Një shenjë faqeje, e marrë nga një telefonatë e mëparshme permissions.list .

Jepni pageToken të kthyer nga një kërkesë si argument për kërkesën tjetër për të marrë faqen tjetër.

Gjatë paginimit, të gjithë parametrat e tjerë të dhënë për permissions.list duhet të përputhen me thirrjen që ka dhënë tokenin e faqes.

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Shembull i kërkesës

Python 

import google.generativeai as genai

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

# ...

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

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të ListPermissionsResponse .

Metoda: corpora.permissions.get

Merr informacion në lidhje me një Leje specifike.

Pika përfundimtare

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

Parametrat e rrugës

string name

E detyrueshme. Emri i burimit të lejes.

Formatet: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Merr formën corpora/{corpora}/permissions/{permission} .

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Shembull i kërkesës

Python 

import google.generativeai as genai

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

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Permission .

Metoda: corpora.permissions.patch

Përditëson lejen.

Pika përfundimtare

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

Parametrat e rrugës

permission.name string

Vetëm dalje. Identifikues. Emri i lejes. Një emër unik do të krijohet gjatë krijimit. Shembuj: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Vetëm dalje. Ajo merr formën corpora/{corpora}/permissions/{permission} .

Parametrat e pyetjes

vargu updateMask string ( FieldMask format)

E detyrueshme. Lista e fushave për të përditësuar. Të pranuarit: - roli (fusha e Permission.role )

Kjo është një listë e ndarë me presje e emrave plotësisht të kualifikuar të fushave. Shembull: "user.displayName,photo" .

Trupi i kërkesës

Trupi i kërkesës përmban një shembull të Permission .

Fushat
role enum ( Role )

E detyrueshme. Roli i dhënë nga kjo leje.

Shembull i kërkesës

Python 

        import google.generativeai as genai

        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):
        import google.generativeai as genai

        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

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Permission .

Metoda: corpora.permissions.delete

Fshin lejen.

Pika përfundimtare

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

Parametrat e rrugës

string name

E detyrueshme. Emri i burimit të lejes. Formatet: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Merr formën corpora/{corpora}/permissions/{permission} .

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Shembull i kërkesës

Python 

import google.generativeai as genai

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

Trupi i reagimit

Nëse ka sukses, trupi i përgjigjes është bosh.

Burimi REST: corpora.permissions

Burimi: Leja

Burimi i lejes i jep përdoruesit, grupit ose pjesës tjetër të botës akses në burimin e API-së PalM (p.sh. një model i akorduar, korpus).

Një rol është një koleksion i operacioneve të lejuara që i lejon përdoruesit të kryejnë veprime specifike në burimet e PalM API. Për t'i vënë ato të disponueshme për përdoruesit, grupet ose llogaritë e shërbimit, ju caktoni role. Kur caktoni një rol, ju jepni lejet që përmban roli.

Ka tre role koncentrike. Çdo rol është një superbashkë e operacioneve të lejuara të rolit të mëparshëm:

  • lexuesi mund të përdorë burimin (p.sh. modeli i akorduar, korpusi) për përfundime
  • shkrimtari ka lejet e lexuesit dhe gjithashtu mund të modifikojë dhe shpërndajë
  • pronari ka lejet e shkrimtarit dhe gjithashtu mund të fshijë
Fushat
string name

Vetëm dalje. Identifikues. Emri i lejes. Një emër unik do të krijohet gjatë krijimit. Shembuj: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Vetëm dalje.

enum granteeType enum ( GranteeType )

Fakultative. E pandryshueshme. Lloji i përfituesit të grantit.

string emailAddress

Fakultative. E pandryshueshme. Adresa e emailit të përdoruesit të grupit të cilit i referohet kjo leje. Fusha nuk caktohet kur lloji i përfituesit të lejes është GJITHË.

role enum ( Role )

E detyrueshme. Roli i dhënë nga kjo leje.

Përfaqësimi JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

GranteeType

Përcakton llojet e përfituesit të kësaj leje.

Enums
GRANTEE_TYPE_UNSPECIFIED Vlera e paracaktuar. Kjo vlerë është e papërdorur.
USER Përfaqëson një përdorues. Kur caktohet, duhet të jepni adresën e emailit për përdoruesin.
GROUP Përfaqëson një grup. Kur caktohet, duhet të jepni adresën e emailit për grupin.
EVERYONE Përfaqëson akses për të gjithë. Asnjë informacion shtesë nuk kërkohet.

Roli

Përcakton rolin e dhënë nga kjo leje.

Enums
ROLE_UNSPECIFIED Vlera e paracaktuar. Kjo vlerë është e papërdorur.
OWNER Pronari mund të përdorë, përditësojë, ndajë dhe fshijë burimin.
WRITER Writer mund të përdorë, përditësojë dhe ndajë burimin.
READER Lexuesi mund të përdorë burimin.

ListPermissionsResponse

Përgjigje nga ListPermissions që përmban një listë të faqeve të lejeve.

Fushat
permissions[] object ( Permission )

Lejet e kthyera.

string nextPageToken

Një shenjë, e cila mund të dërgohet si pageToken për të tërhequr faqen tjetër.

Nëse kjo fushë hiqet, nuk ka më faqe.

Përfaqësimi JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}