Permissions

Метод: tunedModels.permissions.create

Создайте разрешение для определенного ресурса.

Конечная точка

пост https: / /generativelanguage.googleapis.com /v1beta /{parent=tunedModels /*} /permissions

Параметры пути

parent string

Обязательно. Родительский ресурс Permission . Форматы: tunedModels/{tunedModel} corpora/{corpus} Принимает форму tunedModels/{tunedmodel} .

Текст запроса

Тело запроса содержит экземпляр Permission .

Поля
перечисление granteeType enum ( GranteeType )

Необязательный. Неизменяемый. Тип получателя гранта.

string emailAddress

Необязательное. Неизменяемое. Адрес электронной почты пользователя группы, к которой относится это разрешение. Поле не заполняется, если тип получателя разрешения — «ВСЕ».

role enum ( Role )

Обязательно. Роль, предоставляемая этим разрешением.

Пример запроса

Питон 

# 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

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр Permission .

Метод: tunedModels.permissions.get

Получает информацию о конкретном разрешении.

Конечная точка

получить https: / /generativelanguage.googleapis.com /v1beta /{name=tunedModels /* /permissions /*}

Параметры пути

string name

Обязательно. Имя ресурса разрешения.

Форматы: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Он имеет вид tunedModels/{tunedmodel}/permissions/{permission} .

Текст запроса

Тело запроса должно быть пустым.

Пример запроса

Питон 

# 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

Тело ответа

В случае успеха тело ответа содержит экземпляр Permission .

Метод: tunedModels.permissions.list

Перечисляет разрешения для определенного ресурса.

Конечная точка

получить https: / /generativelanguage.googleapis.com /v1beta /{parent=tunedModels /*} /permissions

Параметры пути

parent string

Обязательно. Родительский ресурс разрешений. Форматы: tunedModels/{tunedModel} corpora/{corpus} Принимает форму tunedModels/{tunedmodel} .

Параметры запроса

pageSize integer

Необязательно. Максимальное количество возвращаемых Permission (на страницу). Сервис может возвращать меньше разрешений.

Если не указано, будет возвращено не более 10 разрешений. Этот метод возвращает не более 1000 разрешений на страницу, даже если передано большее значение pageSize.

string pageToken

Необязательно. Токен страницы, полученный в результате предыдущего вызова permissions.list .

Предоставьте pageToken , возвращенный одним запросом, в качестве аргумента следующему запросу для получения следующей страницы.

При пагинации все остальные параметры, предоставленные permissions.list должны соответствовать вызову, который предоставил токен страницы.

Текст запроса

Тело запроса должно быть пустым.

Пример запроса

Питон 

# 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

Тело ответа

В случае успеха тело ответа содержит экземпляр ListPermissionsResponse .

Метод: tunedModels.permissions.patch

Обновляет разрешение.

Конечная точка

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

Параметры пути

string permission.name

Только вывод. Идентификатор. Имя разрешения. Уникальное имя будет сгенерировано при создании. Примеры: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Только вывод. Формат: tunedModels/{tunedmodel}/permissions/{permission} .

Параметры запроса

string ( FieldMask format) updateMask (формат FieldMask)

Обязательно. Список полей для обновления. Допустимые поля: - role (поле Permission.role )

Это список полных имён полей, разделённых запятыми. Пример: "user.displayName,photo" .

Текст запроса

Тело запроса содержит экземпляр Permission .

Поля
role enum ( Role )

Обязательно. Роль, предоставляемая этим разрешением.

Пример запроса

Питон 

# 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

Тело ответа

В случае успеха тело ответа содержит экземпляр Permission .

Метод: tunedModels.permissions.delete

Удаляет разрешение.

Конечная точка

удалить https: / /generativelanguage.googleapis.com /v1beta /{name=tunedModels /* /permissions /*}

Параметры пути

string name

Обязательно. Имя ресурса разрешения. Форматы: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Оно имеет вид tunedModels/{tunedmodel}/permissions/{permission} .

Текст запроса

Тело запроса должно быть пустым.

Пример запроса

Питон 

# 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

Тело ответа

В случае успеха тело ответа представляет собой пустой объект JSON.

Метод: tunedModels.transferOwnership

Передаёт право собственности на настроенную модель. Это единственный способ сменить владельца настроенной модели. Роль текущего владельца будет понижена до уровня автора.

Конечная точка

пост https: / /generativelanguage.googleapis.com /v1beta /{name=tunedModels /*}:transferOwnership

Параметры пути

string name

Обязательно. Имя ресурса настроенной модели для передачи права собственности.

Формат: tunedModels/my-model-id Он имеет вид tunedModels/{tunedmodel} .

Текст запроса

Тело запроса содержит данные со следующей структурой:

Поля
string emailAddress

Обязательно. Адрес электронной почты пользователя, которому передается настроенная модель.

Тело ответа

В случае успеха тело ответа пустое.

Ресурс REST: tunedModels.permissions

Ресурс: Разрешение

Ресурс разрешения предоставляет пользователю, группе или остальному миру доступ к ресурсу API PaLM (например, настроенной модели, корпусу).

Роль — это набор разрешённых операций, позволяющий пользователям выполнять определённые действия с ресурсами API PaLM. Чтобы сделать их доступными пользователям, группам или учётным записям служб, необходимо назначить роли. Назначая роль, вы предоставляете разрешения, содержащиеся в ней.

Существует три концентрические роли. Каждая роль представляет собой надмножество разрешённых операций предыдущей роли:

  • читатель может использовать ресурс (например, настроенную модель, корпус) для вывода
  • Автор имеет права читателя и может редактировать и делиться
  • владелец имеет права автора и может также удалять
Поля
string name

Только вывод. Идентификатор. Имя разрешения. Уникальное имя будет сгенерировано при создании. Примеры: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Только вывод.

перечисление granteeType enum ( GranteeType )

Необязательный. Неизменяемый. Тип получателя гранта.

string emailAddress

Необязательное. Неизменяемое. Адрес электронной почты пользователя группы, к которой относится это разрешение. Поле не заполняется, если тип получателя разрешения — «ВСЕ».

role enum ( Role )

Обязательно. Роль, предоставляемая этим разрешением.

JSON-представление 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

Ответ от ListPermissions , содержащий постраничный список разрешений.

Поля
объект permissions[] object ( Permission )

Возвращенные разрешения.

string nextPageToken

Токен, который можно отправить как pageToken для получения следующей страницы.

Если это поле пропущено, страниц больше нет.

JSON-представление 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}