Permissions

Método: tunedModels.permissions.create

Cria uma permissão para um recurso específico.

Endpoint

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

Parâmetros de caminho

parent string

Obrigatório. O recurso pai do Permission. Formatos: tunedModels/{tunedModel} corpora/{corpus}. Ele tem o formato tunedModels/{tunedmodel}.

Corpo da solicitação

O corpo da solicitação contém uma instância de Permission.

Campos
granteeType enum (GranteeType)

Opcional. Imutável. O tipo do beneficiário.

emailAddress string

Opcional. Imutável. O endereço de e-mail do usuário ou grupo a que esta permissão se refere. O campo não é definido quando o tipo de beneficiário da permissão é EVERYONE.

role enum (Role)

Obrigatório. O papel concedido por essa permissão.

Exemplo de solicitação

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Permission.

Método: tunedModels.permissions.get

Recebe informações sobre uma permissão específica.

Endpoint

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

Parâmetros de caminho

name string

Obrigatório. O nome do recurso da permissão.

Formatos: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission}. Ele tem o formato tunedModels/{tunedmodel}/permissions/{permission}.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Exemplo de solicitação

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Permission.

Método: tunedModels.permissions.list

Lista as permissões do recurso específico.

Endpoint

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

Parâmetros de caminho

parent string

Obrigatório. O recurso pai das permissões. Formatos: tunedModels/{tunedModel} corpora/{corpus}. Ele tem o formato tunedModels/{tunedmodel}.

Parâmetros de consulta

pageSize integer

Opcional. O número máximo de Permissions a serem retornados (por página). O serviço pode retornar menos permissões.

Se não for especificado, no máximo 10 permissões serão retornadas. Esse método retorna no máximo 1.000 permissões por página, mesmo que você transmita um pageSize maior.

pageToken string

Opcional. Um token de página recebido de uma chamada permissions.list anterior.

Forneça o pageToken retornado por uma solicitação como argumento para a próxima solicitação e recupere a próxima página.

Ao paginar, todos os outros parâmetros fornecidos para permissions.list precisam corresponder à chamada que forneceu o token da página.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Exemplo de solicitação

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de ListPermissionsResponse.

Método: tunedModels.permissions.patch

Atualiza a permissão.

Endpoint

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

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

Parâmetros de caminho

permission.name string

Apenas saída. Identificador. O nome da permissão. Um nome exclusivo será gerado na criação. Exemplos: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Somente saída. Ele tem o formato tunedModels/{tunedmodel}/permissions/{permission}.

Parâmetros de consulta

updateMask string (FieldMask format)

Obrigatório. Lista de campos a serem atualizados. Aceitos: - role (campo Permission.role)

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

Corpo da solicitação

O corpo da solicitação contém uma instância de Permission.

Campos
role enum (Role)

Obrigatório. O papel concedido por essa permissão.

Exemplo de solicitação

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Permission.

Método: tunedModels.permissions.delete

Exclui a permissão.

Endpoint

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

Parâmetros de caminho

name string

Obrigatório. O nome do recurso da permissão. Formatos: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission}. Ele tem o formato tunedModels/{tunedmodel}/permissions/{permission}.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Exemplo de solicitação

Python

# With Gemini 2 we're launching a new SDK. See the following doc for details.
# https://ai.google.dev/gemini-api/docs/migrate
README.md

Corpo da resposta

Se não houver nenhum problema, o corpo da resposta será um objeto JSON vazio.

Método: tunedModels.transferOwnership

Transfere a propriedade do modelo ajustado. Essa é a única maneira de mudar a propriedade do modelo ajustado. O proprietário atual será rebaixado para a função de editor.

Endpoint

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

Parâmetros de caminho

name string

Obrigatório. O nome do recurso do modelo ajustado para transferir a propriedade.

Formato: tunedModels/my-model-id. Ele tem o formato tunedModels/{tunedmodel}.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Campos
emailAddress string

Obrigatório. O endereço de e-mail do usuário para quem o modelo ajustado está sendo transferido.

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

Recurso REST: tunedModels.permissions

Recurso: permissão

O recurso de permissão concede ao usuário, grupo ou ao resto do mundo acesso ao recurso da API PaLM (por exemplo, um modelo ajustado, um corpus).

Um papel é um conjunto de operações permitidas que permite aos usuários realizar ações específicas nos recursos da API PaLM. Para disponibilizar as permissões a usuários, grupos ou contas de serviço, atribua papéis. Ao atribuir um papel, você concede as permissões que ele contém.

Há três papéis concêntricos. Cada papel é um superconjunto das operações permitidas do papel anterior:

  • o leitor pode usar o recurso (por exemplo, modelo ajustado, corpus) para inferência
  • o gravador tem as permissões do leitor e também pode editar e compartilhar
  • o proprietário tem permissões de gravador e também pode excluir
Campos
name string

Apenas saída. Identificador. O nome da permissão. Um nome exclusivo será gerado na criação. Exemplos: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Somente saída.

granteeType enum (GranteeType)

Opcional. Imutável. O tipo do beneficiário.

emailAddress string

Opcional. Imutável. O endereço de e-mail do usuário ou grupo a que esta permissão se refere. O campo não é definido quando o tipo de beneficiário da permissão é EVERYONE.

role enum (Role)

Obrigatório. O papel concedido por essa permissão.

Representação JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

Resposta de ListPermissions contendo uma lista paginada de permissões.

Campos
permissions[] object (Permission)

Permissões retornadas.

nextPageToken string

Um token, que pode ser enviado como pageToken para recuperar a próxima página.

Se esse campo for omitido, não haverá mais páginas.

Representação JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}