Permissions

Metoda: tunedModels.permissions.create

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

Pika përfundimtare

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

Parametrat e rrugës

parent string

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

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: tunedModels.permissions.get

Merr informacion në lidhje me një Leje specifike.

Pika përfundimtare

merrni https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/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 tunedModels/{tunedmodel}/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: tunedModels.permissions.list

Liston lejet për burimin specifik.

Pika përfundimtare

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

Parametrat e rrugës

parent string

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

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: tunedModels.permissions.patch

Përditëson lejen.

Pika përfundimtare

patch https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}
PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/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 tunedModels/{tunedmodel}/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: tunedModels.permissions.delete

Fshin lejen.

Pika përfundimtare

fshi https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/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 tunedModels/{tunedmodel}/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.

Metoda: tunedModels.transferOwnership

Transferon pronësinë e modelit të akorduar. Kjo është mënyra e vetme për të ndryshuar pronësinë e modelit të akorduar. Pronari aktual do të ulet në rolin e shkrimtarit.

Pika përfundimtare

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

Parametrat e rrugës

string name

E detyrueshme. Emri i burimit të modelit të akorduar për të transferuar pronësinë.

Formati: tunedModels/my-model-id Merr formën tunedModels/{tunedmodel} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
string emailAddress

E detyrueshme. Adresa e emailit të përdoruesit tek i cili po transferohet modeli i akorduar.

Trupi i reagimit

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

Burimi REST: tunedModels.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)
}

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
}