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)

선택사항입니다. 변경할 수 없습니다. 수여 대상자의 유형입니다.

emailAddress string

선택사항입니다. 변경할 수 없습니다. 이 권한이 참조하는 그룹 사용자의 이메일 주소입니다. 권한의 수혜자 유형이 EVERYONE인 경우 필드가 설정되지 않습니다.

role enum (Role)

필수입니다. 이 권한이 부여하는 역할입니다.

요청 예시

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

응답 본문

성공한 경우 응답 본문에 새로 생성된 Permission의 인스턴스가 포함됩니다.

메서드: tunedModels.permissions.get

특정 권한에 대한 정보를 가져옵니다.

엔드포인트

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

경로 매개변수

name string

필수입니다. 권한의 리소스 이름입니다.

형식: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} tunedModels/{tunedmodel}/permissions/{permission} 형식입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

요청 예시

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

응답 본문

성공한 경우 응답 본문에 Permission의 인스턴스가 포함됩니다.

메서드: tunedModels.permissions.list

특정 리소스의 권한을 나열합니다.

엔드포인트

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

경로 매개변수

parent string

필수입니다. 권한의 상위 리소스입니다. 형식: tunedModels/{tunedModel} corpora/{corpus} tunedModels/{tunedmodel} 형식입니다.

쿼리 매개변수

pageSize integer

선택사항입니다. 반환할 최대 Permission 수 (페이지당)입니다. 서비스가 더 적은 권한을 반환할 수 있습니다.

지정하지 않으면 최대 10개의 권한이 반환됩니다. 이 메서드는 더 큰 pageSize를 전달하더라도 페이지당 최대 1, 000개의 권한을 반환합니다.

pageToken string

선택사항입니다. 이전 permissions.list 호출에서 받은 페이지 토큰입니다.

한 요청에서 반환된 pageToken를 다음 요청의 인수로 제공하여 다음 페이지를 가져옵니다.

페이지를 매길 때 permissions.list에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

요청 예시

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

응답 본문

성공한 경우 응답 본문에 ListPermissionsResponse의 인스턴스가 포함됩니다.

메서드: tunedModels.permissions.patch

권한을 업데이트합니다.

엔드포인트

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

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

경로 매개변수

permission.name string

출력 전용입니다. 식별자. 권한 이름입니다. 생성 시 고유한 이름이 생성됩니다. 예: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} 출력 전용입니다. tunedModels/{tunedmodel}/permissions/{permission} 형식이 사용됩니다.

쿼리 매개변수

updateMask string (FieldMask format)

필수입니다. 업데이트할 필드 목록입니다. 허용되는 필드: - 역할 (Permission.role 필드)

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

요청 본문

요청 본문에 Permission의 인스턴스가 포함됩니다.

필드
role enum (Role)

필수입니다. 이 권한이 부여하는 역할입니다.

요청 예시

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

응답 본문

성공한 경우 응답 본문에 Permission의 인스턴스가 포함됩니다.

메서드: tunedModels.permissions.delete

권한을 삭제합니다.

엔드포인트

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

경로 매개변수

name string

필수입니다. 권한의 리소스 이름입니다. 형식: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} tunedModels/{tunedmodel}/permissions/{permission} 형식입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

요청 예시

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

응답 본문

성공하면 응답 본문은 빈 JSON 객체입니다.

메서드: tunedModels.transferOwnership

조정된 모델의 소유권을 이전합니다. 이는 조정된 모델의 소유권을 변경하는 유일한 방법입니다. 기존 소유자는 작성자 역할로 다운그레이드됩니다.

엔드포인트

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

경로 매개변수

name string

필수입니다. 소유권을 이전할 조정된 모델의 리소스 이름입니다.

형식: tunedModels/my-model-id tunedModels/{tunedmodel} 형식이 사용됩니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

필드
emailAddress string

필수입니다. 조정된 모델이 전송되는 사용자의 이메일 주소입니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

REST 리소스: tunedModels.permissions

리소스: 권한

권한 리소스는 사용자, 그룹 또는 기타 모든 사용자에게 PaLM API 리소스 (예: 조정된 모델, 자료)에 대한 액세스 권한을 부여합니다.

역할은 사용자가 PaLM API 리소스에서 특정 작업을 수행할 수 있도록 허용하는 허용된 작업 모음입니다. 사용자, 그룹 또는 서비스 계정에서 사용할 수 있도록 하려면 역할을 할당합니다. 역할을 할당하면 역할에 포함된 권한이 부여됩니다.

세 가지 역할이 동심원으로 표시됩니다. 각 역할은 이전 역할의 허용된 작업의 상위 집합입니다.

  • 리더가 추론에 리소스 (예: 조정된 모델, 자료)를 사용할 수 있음
  • 작성자가 읽기 권한을 보유하고 있으며 추가로 수정 및 공유할 수 있습니다.
  • 소유자가 작성자 권한을 보유하고 있으며 추가로 삭제할 수 있음
필드
name string

출력 전용입니다. 식별자. 권한 이름입니다. 생성 시 고유한 이름이 생성됩니다. 예: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} 출력 전용입니다.

granteeType enum (GranteeType)

선택사항입니다. 변경할 수 없습니다. 수여 대상자의 유형입니다.

emailAddress string

선택사항입니다. 변경할 수 없습니다. 이 권한이 참조하는 그룹 사용자의 이메일 주소입니다. 권한의 수혜자 유형이 EVERYONE인 경우 필드가 설정되지 않습니다.

role enum (Role)

필수입니다. 이 권한이 부여하는 역할입니다.

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

ListPermissionsResponse

페이지로 나뉜 권한 목록이 포함된 ListPermissions의 응답입니다.

필드
permissions[] object (Permission)

반환된 권한

nextPageToken string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다.

이 필드를 생략하면 더 이상 페이지가 없습니다.

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