Corpus Permissions

메서드: corpora.permissions.create

특정 리소스에 대한 권한을 만듭니다.

엔드포인트

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

경로 매개변수

parent string

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

요청 본문

요청 본문에 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의 인스턴스가 포함됩니다.

메서드: corpora.permissions.list

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

엔드포인트

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

경로 매개변수

parent string

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

쿼리 매개변수

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의 인스턴스가 포함됩니다.

메서드: corpora.permissions.get

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

엔드포인트

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

경로 매개변수

name string

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

형식: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} corpora/{corpora}/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의 인스턴스가 포함됩니다.

메서드: corpora.permissions.patch

권한을 업데이트합니다.

엔드포인트

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

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

경로 매개변수

permission.name string

출력 전용입니다. 식별자. 권한 이름입니다. 생성 시 고유한 이름이 생성됩니다. 예: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} 출력 전용입니다. corpora/{corpora}/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의 인스턴스가 포함됩니다.

메서드: corpora.permissions.delete

권한을 삭제합니다.

엔드포인트

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

경로 매개변수

name string

필수입니다. 권한의 리소스 이름입니다. 형식: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} corpora/{corpora}/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 객체입니다.

REST 리소스: corpora.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)
}

GranteeType

이 권한의 수여자 유형을 정의합니다.

열거형
GRANTEE_TYPE_UNSPECIFIED 기본값입니다. 이 값은 사용되지 않습니다.
USER 사용자를 나타냅니다. 설정된 경우 사용자의 emailAddress를 제공해야 합니다.
GROUP 그룹을 나타냅니다. 이 속성을 설정하면 그룹의 emailAddress를 제공해야 합니다.
EVERYONE 모든 사용자에게 액세스 권한을 나타냅니다. 추가 정보는 필요하지 않습니다.

역할

이 권한이 부여하는 역할을 정의합니다.

열거형
ROLE_UNSPECIFIED 기본값입니다. 이 값은 사용되지 않습니다.
OWNER 소유자는 리소스를 사용, 업데이트, 공유, 삭제할 수 있습니다.
WRITER 작성자는 리소스를 사용, 업데이트, 공유할 수 있습니다.
READER 독자가 리소스를 사용할 수 있습니다.

ListPermissionsResponse

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

필드
permissions[] object (Permission)

반환된 권한

nextPageToken string

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

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

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