Corpus Permissions

Metoda: corpora.permissions.create

Utwórz uprawnienie do konkretnego zasobu.

Punkt końcowy

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

Parametry ścieżki

parent string

Wymagany. Zasób nadrzędny Permission. Formaty: tunedModels/{tunedModel} corpora/{corpus} Ma format corpora/{corpora}.

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: corpora.permissions.list

Wyświetla uprawnienia dotyczące konkretnego zasobu.

Punkt końcowy

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

Parametry ścieżki

parent string

Wymagany. Zasób nadrzędny uprawnień. Formaty: tunedModels/{tunedModel} corpora/{corpus} Ma format corpora/{corpora}.

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 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: corpora.permissions.get

Pobiera informacje o konkretnym uprawnieniu.

Punkt końcowy

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

Parametry ścieżki

name string

Wymagany. Nazwa zasobu uprawnienia.

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

Aktualizuje uprawnienie.

Punkt końcowy

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

PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=corpora/*/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ć corpora/{corpora}/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: corpora.permissions.delete

Usuwanie uprawnień.

Punkt końcowy

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

Parametry ścieżki

name string

Wymagany. Nazwa zasobu uprawnienia. Formaty: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Ma format corpora/{corpora}/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.

Zasób REST: corpora.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)
}

GranteeType

Definiuje typy podmiotów, którym przyznano to uprawnienie.

Wartości w polu enum
GRANTEE_TYPE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
USER Reprezentuje użytkownika. Gdy to ustawienie jest ustawione, musisz podać adres e-mail użytkownika.
GROUP Reprezentuje grupę. Gdy jest ustawiony, musisz podać adres e-mail grupy.
EVERYONE Reprezentuje dostęp dla wszystkich. Nie musisz podawać żadnych dodatkowych informacji.

Rola

Określa rolę przyznaną przez to uprawnienie.

Wartości w polu enum
ROLE_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
OWNER Właściciel może używać, aktualizować, udostępniać i usuwać zasób.
WRITER Autor może używać, aktualizować i udostępniać zasób.
READER Czytelnik może korzystać z zasobu.

ListPermissionsResponse

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

Pola
permissions[] object (Permission)

Zwrócone 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
}