Permissions

Metoda: tunedModels.permissions.create

Utwórz uprawnienie do konkretnego zasobu.

Punkt końcowy

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

Parametry ścieżki

parent string

Wymagany. Zasób nadrzędny elementu Permission. Formaty: tunedModels/{tunedModel} corpora/{corpus}. Przyjmuje postać tunedModels/{tunedmodel}.

Treść żądania

Treść żądania zawiera wystąpienie elementu Permission.

Pola
granteeType enum (GranteeType)

Opcjonalnie. Niezmienne. Typ beneficjenta.

emailAddress string

Opcjonalnie. Niezmienne. Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie. Pole nie jest ustawione, gdy typ uprawnień do przyznania to EVERYONE.

role enum (Role)

Wymagany. Rola przyznana przez to uprawnienie.

Przykładowe żądanie

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

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Permission.

Metoda: tunedModels.permissions.get

Pobiera informacje o konkretnym uprawnieniu.

Punkt końcowy

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

Parametry ścieżki

name string

Wymagany. Nazwa zasobu uprawnienia.

Formaty: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission}. Przyjmuje postać tunedModels/{tunedmodel}/permissions/{permission}.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Permission.

Metoda: tunedModels.permissions.list

Wyświetla listę uprawnień do konkretnego zasobu.

Punkt końcowy

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

Parametry ścieżki

parent string

Wymagany. Zasób nadrzędny uprawnień. Formaty: tunedModels/{tunedModel} corpora/{corpus}. Przyjmuje postać tunedModels/{tunedmodel}.

Parametry zapytania

pageSize integer

Opcjonalnie. Maksymalna liczba Permission do zwrócenia (na stronę). Usługa może zwrócić mniejszą liczbę uprawnień.

Jeśli nie podano tego argumentu, zwracanych jest maksymalnie 10 uprawnień. Ta metoda zwraca maksymalnie 1000 uprawnień na stronę, nawet jeśli podasz większą wartość parametru pageSize.

pageToken string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania permissions.list.

Podaj wartość pageToken zwróconą przez jedno żądanie jako argument następnego żądania, aby pobrać następną stronę.

Podczas paginacji wszystkie inne parametry przekazane do funkcji permissions.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ListPermissionsResponse.

Metoda: tunedModels.permissions.patch

Aktualizuje uprawnienia.

Punkt końcowy

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

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

Parametry ścieżki

permission.name string

Tylko dane wyjściowe. Identyfikator. Nazwa uprawnienia. Podczas tworzenia zostanie wygenerowana unikalna nazwa. Przykłady: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Tylko dane wyjściowe. Ma on postać tunedModels/{tunedmodel}/permissions/{permission}.

Parametry zapytania

updateMask string (FieldMask format)

Wymagany. Lista pól do zaktualizowania. Zaakceptowane: - role (pole Permission.role)

Jest to lista w pełni kwalifikowanych nazw pól rozdzielonych przecinkami. Przykład: "user.displayName,photo".

Treść żądania

Treść żądania zawiera wystąpienie elementu Permission.

Pola
role enum (Role)

Wymagany. Rola przyznana przez to uprawnienie.

Przykładowe żądanie

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Permission.

Metoda: tunedModels.permissions.delete

Usuwa uprawnienia.

Punkt końcowy

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

Parametry ścieżki

name string

Wymagany. Nazwa zasobu uprawnienia. Formaty: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission}. Przyjmuje postać tunedModels/{tunedmodel}/permissions/{permission}.

Treść żądania

Treść żądania musi być pusta.

Przykładowe żądanie

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

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pustym obiektem JSON.

Metoda: tunedModels.transferOwnership

Przenosi własność dostrojonego modelu. To jedyny sposób na zmianę właściciela dostrojonego modelu. Obecny właściciel zostanie zdegradowany do roli osoby zapisującej.

Punkt końcowy

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

Parametry ścieżki

name string

Wymagany. Nazwa zasobu dostrojonego modelu, którego własność ma zostać przeniesiona.

Format: tunedModels/my-model-id. Przyjmuje postać tunedModels/{tunedmodel}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Pola
emailAddress string

Wymagany. Adres e-mail użytkownika, na którego konto przenoszony jest dostrojony model.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Zasób REST: tunedModels.permissions

Zasób: Permission

Zasób uprawnień przyznaje użytkownikowi, grupie lub reszcie świata dostęp do zasobu interfejsu PaLM API (np. dostrojonego modelu lub korpusu).

Rola to zbiór dozwolonych operacji, które umożliwiają użytkownikom wykonywanie określonych działań na zasobach interfejsu PaLM API. Aby udostępnić je użytkownikom, grupom lub kontom usługi, przypisz role. Przypisanie roli oznacza przyznanie uprawnień, które zawiera ta rola.

Są 3 role koncentryczne. Każda rola jest nadzbiorem dozwolonych operacji poprzedniej roli:

  • czytelnik może używać zasobu (np. dostrojonego modelu, korpusu) do wnioskowania;
  • osoba z uprawnieniami do zapisu ma uprawnienia osoby z uprawnieniami do odczytu, a dodatkowo może edytować i udostępniać pliki;
  • właściciel ma uprawnienia do pisania, a dodatkowo może usuwać
Pola
name string

Tylko dane wyjściowe. Identyfikator. Nazwa uprawnienia. Podczas tworzenia zostanie wygenerowana unikalna nazwa. Przykłady: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Tylko dane wyjściowe.

granteeType enum (GranteeType)

Opcjonalnie. Niezmienne. Typ beneficjenta.

emailAddress string

Opcjonalnie. Niezmienne. Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie. Pole nie jest ustawione, gdy typ uprawnień do przyznania to EVERYONE.

role enum (Role)

Wymagany. Rola przyznana przez to uprawnienie.

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

ListPermissionsResponse

Odpowiedź z usługi ListPermissions zawierająca podzieloną na strony listę uprawnień.

Pola
permissions[] object (Permission)

Zwrócone uprawnienia.

nextPageToken string

Token, który można wysłać jako pageToken, aby pobrać następną stronę.

Jeśli pominiesz to pole, nie będzie kolejnych stron.

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