Permissions

Crea un'autorizzazione per una risorsa specifica.

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

Obbligatorio. La risorsa padre del Permission. Formati: tunedModels/{tunedModel} corpora/{corpus} Il formato è tunedModels/{tunedmodel}.

Il corpo della richiesta contiene un'istanza di Permission.

Campi
granteeType enum (GranteeType)

(Facoltativo) Immutabile. Il tipo di concessore.

emailAddress string

(Facoltativo) Immutabile. L'indirizzo email dell'utente o del gruppo a cui fa riferimento questa autorizzazione. Il campo non è impostato quando il tipo di concessore dell'autorizzazione è TUTTI.

role enum (Role)

Obbligatorio. Il ruolo concesso da questa autorizzazione.

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

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Permission appena creata.

Metodo: tunedModels.permissions.get

Recupera le informazioni su un'autorizzazione specifica.

Endpoint

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

Parametri del percorso

name string

Obbligatorio. Il nome della risorsa dell'autorizzazione.

Formati: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Il formato è tunedModels/{tunedmodel}/permissions/{permission}.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Richiesta di esempio

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

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Permission.

Metodo: tunedModels.permissions.list

Elenca le autorizzazioni per la risorsa specifica.

Endpoint

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

Parametri del percorso

parent string

Obbligatorio. La risorsa principale delle autorizzazioni. Formati: tunedModels/{tunedModel} corpora/{corpus} Il formato è tunedModels/{tunedmodel}.

Parametri di query

pageSize integer

(Facoltativo) Il numero massimo di Permission da restituire (per pagina). Il servizio potrebbe restituire meno autorizzazioni.

Se non specificato, verranno restituite al massimo 10 autorizzazioni. Questo metodo restituisce al massimo 1000 autorizzazioni per pagina, anche se specifichi un valore di pageSize più grande.

pageToken string

(Facoltativo) Un token di pagina ricevuto da una chiamata permissions.list precedente.

Fornisci il token pageToken restituito da una richiesta come argomento alla richiesta successiva per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a permissions.list devono corrispondere alla chiamata che ha fornito il token pagina.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Richiesta di esempio

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

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di ListPermissionsResponse.

Metodo: tunedModels.permissions.patch

Aggiorna l'autorizzazione.

Endpoint

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

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

Parametri del percorso

permission.name string

Solo output. Identificatore. Il nome dell'autorizzazione. Al momento della creazione verrà generato un nome univoco. Esempi: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Solo output. Il formato è tunedModels/{tunedmodel}/permissions/{permission}.

Parametri di query

updateMask string (FieldMask format)

Obbligatorio. L'elenco dei campi da aggiornare. Quelli accettati: - role (campo Permission.role)

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Permission.

Campi
role enum (Role)

Obbligatorio. Il ruolo concesso da questa autorizzazione.

Richiesta di esempio

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

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Permission.

Metodo: tunedModels.permissions.delete

Consente di eliminare l'autorizzazione.

Endpoint

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

Parametri del percorso

name string

Obbligatorio. Il nome della risorsa dell'autorizzazione. Formati: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Il formato è tunedModels/{tunedmodel}/permissions/{permission}.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Richiesta di esempio

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

Corpo della risposta

In caso di esito positivo, il corpo della risposta è un oggetto JSON vuoto.

Metodo: tunedModels.transferOwnership

Trasferisce la proprietà del modello ottimizzato. Questo è l'unico modo per cambiare la proprietà del modello ottimizzato. Il proprietario attuale verrà retrocesso al ruolo di autore.

Endpoint

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

Parametri del percorso

name string

Obbligatorio. Il nome della risorsa del modello ottimizzato di cui trasferire la proprietà.

Formato: tunedModels/my-model-id Deve avere il formato tunedModels/{tunedmodel}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Campi
emailAddress string

Obbligatorio. L'indirizzo email dell'utente a cui viene trasferito il modello ottimizzato.

Corpo della risposta

In caso di esito positivo, il corpo della risposta è vuoto.

Risorsa REST: tunedModels.permissions

Risorsa: autorizzazione

La risorsa di autorizzazione concede all'utente, al gruppo o al resto del mondo l'accesso alla risorsa dell'API PaLM (ad es. un modello ottimizzato, un corpus).

Un ruolo è un insieme di operazioni consentite che consente agli utenti di eseguire azioni specifiche sulle risorse dell'API PaLM. Per renderli disponibili a utenti, gruppi o account di servizio, devi assegnare i ruoli. Quando assegni un ruolo, concedi le autorizzazioni incluse nel ruolo.

Esistono tre ruoli concentrici. Ogni ruolo è un superinsieme delle operazioni consentite dal ruolo precedente:

  • il lettore può utilizzare la risorsa (ad es. modello ottimizzato, corpus) per l'inferenza
  • L'autore ha le autorizzazioni del lettore e può anche modificare e condividere
  • il proprietario dispone delle autorizzazioni dello scrittore e può anche eliminare
Campi
name string

Solo output. Identificatore. Il nome dell'autorizzazione. Al momento della creazione verrà generato un nome univoco. Esempi: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Solo output.

granteeType enum (GranteeType)

(Facoltativo) Immutabile. Il tipo di concessore.

emailAddress string

(Facoltativo) Immutabile. L'indirizzo email dell'utente o del gruppo a cui fa riferimento questa autorizzazione. Il campo non è impostato quando il tipo di concessore dell'autorizzazione è TUTTI.

role enum (Role)

Obbligatorio. Il ruolo concesso da questa autorizzazione.

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

ListPermissionsResponse

Risposta di ListPermissions contenente un elenco paginato di autorizzazioni.

Campi
permissions[] object (Permission)

Autorizzazioni restituite.

nextPageToken string

Un token che può essere inviato come pageToken per recuperare la pagina successiva.

Se questo campo viene omesso, non ci sono altre pagine.

Rappresentazione JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}