Method: projects.locations.notebooks.share

다른 계정에 노트북을 공유합니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/notebooks/*}:share

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 항목입니다. Notebook의 전체 리소스 이름입니다(예: projects/{project}/locations/{location}/notebooks/{notebookId}).

요청 본문

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

JSON 표현 
{
  "accountAndRoles": [
    {
      object (AccountAndRole)
    }
  ],
  "notifyViaEmail": boolean
}
필드
accountAndRoles[]

object (AccountAndRole)

필수 항목입니다. 노트북을 공유할 계정 및 역할 목록입니다.
notifyViaEmail

boolean

필수 항목입니다. 공유된 사용자에게 이메일로 알림을 보낼지 여부입니다.

응답 본문

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

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

name 리소스에 대한 다음 IAM 권한이 필요합니다.

  • discoveryengine.notebooks.getIamPolicy
  • discoveryengine.notebooks.setIamPolicy

자세한 내용은 IAM 문서를 참조하세요.

AccountAndRole

계정 및 역할 정보

JSON 표현 
{
  "email": string,
  "role": enum (ProjectRole)
}
필드
email

string

필수 항목입니다. 계정과 연결된 이메일 주소입니다.
role

enum (ProjectRole)

필수 항목입니다. 노트북의 역할입니다.

ProjectRole

프로젝트의 역할입니다.

열거형
PROJECT_ROLE_UNKNOWN 알 수 없는 역할입니다.
PROJECT_ROLE_OWNER 사용자가 프로젝트를 소유합니다.
PROJECT_ROLE_WRITER 사용자에게 프로젝트에 대한 쓰기 권한이 있습니다.
PROJECT_ROLE_READER 사용자에게 프로젝트에 대한 읽기 권한이 있습니다.
PROJECT_ROLE_NOT_SHARED 사용자에게 프로젝트에 대한 액세스 권한이 없습니다.