Permissions

Méthode: hitsModels.permissions.create

Créer une autorisation pour une ressource spécifique

Point de terminaison

<ph type="x-smartling-placeholder"></ph> publier https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Paramètres de chemin d'accès

parent string

Obligatoire. Ressource parente de Permission. Formats: tunedModels/{tunedModel} corpora/{corpus} Il prend la forme tunedModels/{tunedmodel}.

Corps de la requête

Le corps de la requête contient une instance de Permission.

<ph type="x-smartling-placeholder">
</ph> Champs
granteeType enum (GranteeType)

Facultatif. Immuable. Type du bénéficiaire.

emailAddress string

Facultatif. Immuable. Adresse e-mail de l'utilisateur ou du groupe auquel cette autorisation fait référence. Le champ n'est pas défini lorsque le type de bénéficiaire de l'autorisation est "TOUT LE MONDE".

role enum (Role)

Obligatoire. Rôle accordé par cette autorisation.

Exemple de requête

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

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Permission.

Méthode : tunedModels.permissions.get

Obtient des informations sur une autorisation spécifique.

Point de terminaison

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

Paramètres de chemin d'accès

name string

Obligatoire. Nom de ressource de l'autorisation.

Formats: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Il prend la forme tunedModels/{tunedmodel}/permissions/{permission}.

Corps de la requête

Le corps de la requête doit être vide.

Exemple de requête

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

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Permission.

Méthode: ListenModels.permissions.list

Répertorie les autorisations pour la ressource spécifique.

Point de terminaison

<ph type="x-smartling-placeholder"></ph> obtenir https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Paramètres de chemin d'accès

parent string

Obligatoire. Ressource parente des autorisations. Formats: tunedModels/{tunedModel} corpora/{corpus} Il prend la forme tunedModels/{tunedmodel}.

Paramètres de requête

pageSize integer

Facultatif. Nombre maximal d'éléments Permission à renvoyer (par page). Le service peut renvoyer moins d'autorisations.

Si aucune autorisation n'est spécifiée, 10 autorisations au maximum seront renvoyées. Cette méthode ne renvoie pas plus de 1 000 autorisations par page, même si vous spécifiez une valeur plus élevée pour "pageSize".

pageToken string

Facultatif. Jeton de page reçu d'un appel permissions.list précédent.

Fournissez le pageToken renvoyé par une requête en tant qu'argument à la requête suivante pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à permissions.list doivent correspondre à l'appel ayant fourni le jeton de page.

Corps de la requête

Le corps de la requête doit être vide.

Exemple de requête

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

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de ListPermissionsResponse.

Méthode : tunedModels.permissions.patch

Met à jour l'autorisation.

Point de terminaison

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

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

Paramètres de chemin d'accès

permission.name string

Uniquement en sortie. Identifiant. Nom de l'autorisation. Un nom unique est généré lors de la création. Exemples : tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Uniquement en sortie. Il se présente sous la forme tunedModels/{tunedmodel}/permissions/{permission}.

Paramètres de requête

updateMask string (FieldMask format)

Obligatoire. Liste des champs à mettre à jour. Autorisés: - rôle (champ Permission.role)

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"

Corps de la requête

Le corps de la requête contient une instance de Permission.

<ph type="x-smartling-placeholder">
</ph> Champs
role enum (Role)

Obligatoire. Rôle accordé par cette autorisation.

Exemple de requête

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

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Permission.

Méthode: hitsModels.permissions.delete

Supprime l'autorisation.

Point de terminaison

<ph type="x-smartling-placeholder"></ph> supprimer https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Paramètres de chemin d'accès

name string

Obligatoire. Nom de la ressource de l'autorisation. Formats : tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Il se présente sous la forme tunedModels/{tunedmodel}/permissions/{permission}.

Corps de la requête

Le corps de la requête doit être vide.

Exemple de requête

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

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Méthode : tunedModels.transferOwnership

Transfère la propriété du modèle réglé. Il s'agit du seul moyen de modifier la propriété du modèle optimisé. Le propriétaire actuel sera rétrogradé au rôle de rédacteur.

Point de terminaison

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

Paramètres de chemin d'accès

name string

Obligatoire. Nom de la ressource du modèle affiné pour transférer la propriété.

Format: tunedModels/my-model-id. Il se présente sous la forme tunedModels/{tunedmodel}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Champs
emailAddress string

Obligatoire. Adresse e-mail de l'utilisateur vers lequel le modèle réglé est transféré.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Ressource REST: tubeModels.permissions

Ressource: Autorisation

La ressource d'autorisation accorde à l'utilisateur, au groupe ou au reste du monde l'accès à la ressource de l'API PaLM (par exemple, un modèle ajusté, un corpus).

Un rôle est un ensemble d'opérations autorisées permettant aux utilisateurs d'effectuer des actions spécifiques sur les ressources de l'API PaLM. Pour les mettre à la disposition des utilisateurs, des groupes ou des comptes de service, vous devez leur attribuer des rôles. Lorsque vous attribuez un rôle, vous lui accordez les autorisations qu'il contient.

Il existe trois rôles concentriques. Chaque rôle est un sur-ensemble des opérations autorisées du rôle précédent :

  • Le lecteur peut utiliser la ressource (par exemple, le modèle affiné, le corpus) pour l'inférence.
  • l'auteur dispose des autorisations de lecteur et peut en outre modifier et partager
  • le propriétaire dispose des autorisations de l'auteur et peut également supprimer
Champs
name string

Uniquement en sortie. Identifiant. Nom de l'autorisation. Un nom unique sera généré lors de la création. Exemples: ListenModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Sortie uniquement.

granteeType enum (GranteeType)

Facultatif. Immuable. Type du bénéficiaire.

emailAddress string

Facultatif. Immuable. Adresse e-mail de l'utilisateur ou du groupe auquel cette autorisation fait référence. Le champ n'est pas défini lorsque le type de bénéficiaire de l'autorisation est "TOUT LE MONDE".

role enum (Role)

Obligatoire. Rôle accordé par cette autorisation.

Représentation JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

Réponse de ListPermissions contenant une liste paginée d'autorisations.

Champs
permissions[] object (Permission)

Autorisations renvoyées.

nextPageToken string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante.

Si ce champ est omis, il n'y a plus de pages.

Représentation JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}