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 Permission. Formaty: tunedModels/{tunedModel} corpora/{corpus} Ma format tunedModels/{tunedmodel}.

Treść żądania

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

Pola
granteeType enum (GranteeType)

Opcjonalnie: Niezmienna. Typ podmiotu, któremu udzielono uprawnienia.

emailAddress string

Opcjonalnie: Niezmienna. Adres e-mail użytkownika grupy, do której odnosi się to uprawnienie. Pole nie jest ustawione, gdy typ uprawnienia to WSZYSCY.

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ę powiedzie, 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} Ma format 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 uprawnienia dotyczące 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} Ma format tunedModels/{tunedmodel}.

Parametry zapytania

pageSize integer

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

Jeśli nie podasz tej wartości, zwrócimy 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 funkcji permissions.list.

Aby pobrać kolejną stronę, podaj jako argument kolejnego żądania pageToken zwrócony przez pierwsze żądanie.

Podczas podziału na strony wszystkie inne parametry przekazywane 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 uprawnienie.

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 ona postać tunedModels/{tunedmodel}/permissions/{permission}.

Parametry zapytania

updateMask string (FieldMask format)

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

Jest to lista pełnych nazw pól rozdzielona 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

Usuwanie uprawnień.

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} Ma format 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 to pusty obiekt JSON.

Metoda: tunedModels.transferOwnership

Przekazuje prawo własności do zmodyfikowanego modelu. Jest to jedyny sposób na zmianę właściciela dostosowanego modelu. Obecny właściciel zostanie przekształcony w redaktora.

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ść chcesz przenieść.

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

Treść żądania

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

Pola
emailAddress string

Wymagany. Adres e-mail użytkownika, do którego jest przenoszona dostosowana wersja modelu.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi jest pusta.

Zasób REST: tunedModels.permissions

Zasób: Permission

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

Rola to zbiór dozwolonych operacji, który umożliwia użytkownikom wykonywanie określonych działań na zasobach PaLM API. Aby udostępnić je użytkownikom, grupom lub kontom usługi, przypisz role. Przypisując rolę, przyznajesz uprawnienia, które są z nią powiązane.

Istnieją 3 poziomy roli. Każda rola jest superzbiorem dozwolonych operacji poprzedniej roli:

  • reader może używać zasobu (np.dostosowanego modelu lub korpusu) do wnioskowania.
  • writer ma uprawnienia reader i dodatkowo może edytować i udostępniać
  • właściciel ma uprawnienia autora i dodatkowo może usuwać
Fields
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: Niezmienna. Typ podmiotu, któremu udzielono uprawnienia.

emailAddress string

Opcjonalnie: Niezmienna. Adres e-mail użytkownika grupy, do której odnosi się to uprawnienie. Pole nie jest ustawione, gdy typ uprawnienia to WSZYSCY.

role enum (Role)

Wymagany. Rola przyznana przez to uprawnienie.

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

ListPermissionsResponse

Odpowiedź z ListPermissions zawierająca ponumerowane strony z uprawnieniami.

Pola
permissions[] object (Permission)

Zwracane uprawnienia.

nextPageToken string

token, który może być wysyłany jako pageToken w celu pobrania następnej strony.

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

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