이 페이지는 Cloud Translation API를 통해 번역되었습니다.

노트북 만들기 및 관리 (API)

NotebookLM Enterprise는 문서에서 유용한 정보와 요약을 생성하는 강력한 도구입니다. 이 페이지에서는 다음 노트북 관리 작업을 프로그래매틱 방식으로 실행할 수 있는 API를 설명합니다.

노트북 만들기
노트북 가져오기
최근에 본 노트북 목록 표시
노트북 일괄 삭제
노트북 공유하기

노트북 만들기

새 노트북을 만들려면 notebooks.create 메서드를 사용합니다.

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks" \
  -d '{
  "title": "NOTEBOOK_TITLE",
  }'

다음을 바꿉니다.

ENDPOINT_LOCATION: API 요청의 다중 리전입니다. 다음 값 중 하나를 할당합니다.
- 미국 멀티 리전의 us-
- EU 멀티 리전의 경우 eu-
- 전역 위치의 경우 global-
자세한 내용은 데이터 스토어의 다중 리전 지정을 참고하세요.
PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
LOCATION: 데이터 스토어의 지리적 위치입니다(예: global). 자세한 내용은 위치를 참고하세요.
NOTEBOOK_TITLE: 만들려는 노트북의 제목으로 사용되는 UTF-8 인코딩 문자열입니다.

요청이 성공하면 다음과 비슷한 JSON이 표시됩니다.

{
"title": "NOTEBOOK_TITLE",
"notebookId": "NOTEBOOK_ID",
"emoji": "",
"metadata": {
  "userRole": "PROJECT_ROLE_OWNER",
  "isShared": false,
  "isShareable": true
},
"name": "NOTEBOOK_NAME"
}

다음에 유의하세요.

NOTEBOOK_ID: 생성된 노트북을 식별하는 고유 ID입니다. 공유 또는 검색과 같은 다른 노트북 관리 작업을 하려면 노트북 ID가 필요합니다.
NOTEBOOK_NAME: 노트북의 전체 리소스 이름입니다. 이 필드의 패턴은 다음과 같습니다. projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID

생성된 노트북에 액세스하고 브라우저에서 ID 가져오기

브라우저를 사용하여 생성된 노트북에 액세스하고 ID를 가져오려면 다음 단계를 따르세요.

다음 URL 중 하나에서 사용할 수 있는 NotebookLM Enterprise 홈페이지로 이동합니다.
1. Google ID를 사용하는 경우 다음으로 이동하세요.
```
https://notebooklm.cloud.google.com/LOCATION/?project=PROJECT_NUMBER
```
2. 서드 파티 ID를 사용하는 경우 다음으로 이동하세요.
```
https://notebooklm.cloud.google/LOCATION/?project=PROJECT_NUMBER
```
생성된 노트북을 선택합니다. 선택한 노트북의 URL은 다음과 같은 패턴을 따릅니다.
1. Google ID를 사용하는 경우:
```
https://notebooklm.cloud.google.com/LOCATION/notebook/NOTEBOOK_ID?project=PROJECT_NUMBER
```
2. 서드 파티 ID를 사용하는 경우:
```
https://notebooklm.cloud.google/LOCATION/notebook/NOTEBOOK_ID?project=PROJECT_NUMBER
```
URL과 노트북 ID를 기록해 두세요. 공유와 같은 다른 노트북 관리 작업에 유용합니다.

노트북 가져오기

노트북 ID를 사용하여 특정 노트북을 검색하려면 notebooks.get 메서드를 사용합니다.

REST

curl -X GET \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID"

다음을 바꿉니다.

ENDPOINT_LOCATION: API 요청의 다중 리전입니다. 다음 값 중 하나를 할당합니다.
- 미국 멀티 리전의 us-
- EU 멀티 리전의 경우 eu-
- 전역 위치의 경우 global-
자세한 내용은 데이터 스토어의 다중 리전 지정을 참고하세요.
PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
LOCATION: 데이터 스토어의 지리적 위치입니다(예: global). 자세한 내용은 위치를 참고하세요.
NOTEBOOK_ID: 노트북을 만들 때 받은 노트북의 고유 식별자입니다.

요청이 성공하면 빈 노트북에 대해 다음과 비슷한 JSON 응답이 표시됩니다. 노트북에 소스를 추가한 후 이 메서드를 호출하면 검색된 노트북에 추가된 모든 소스에 관한 세부정보가 표시됩니다. CMEK 세부정보를 구성한 경우 노트북에 대한 CMEK 관련 정보도 수신됩니다.

{
"title": "NOTEBOOK_TITLE",
"notebookId": "NOTEBOOK_ID",
"emoji": "",
"metadata": {
  "userRole": "PROJECT_ROLE_OWNER",
  "isShared": false,
  "isShareable": true,
  "lastViewed": "LAST_VIEWED_TIME",
  "createTime": "LAST_CREATED_TIME"
},
"name": "NOTEBOOK_NAME"
}

최근에 본 노트북 목록

최근에 본 프로젝트의 모든 노트북 목록을 가져오려면 notebooks.listRecentlyViewed 메서드를 사용하세요. 기본적으로 응답에는 마지막 500개의 노트북이 나열됩니다. pageSize 쿼리 매개변수를 사용하여 응답을 페이지로 나눌 수 있습니다.

REST

curl -X GET \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks:listRecentlyViewed"

다음을 바꿉니다.

ENDPOINT_LOCATION: API 요청의 다중 리전입니다. 다음 값 중 하나를 할당합니다.
- 미국 멀티 리전의 us-
- EU 멀티 리전의 경우 eu-
- 전역 위치의 경우 global-
자세한 내용은 데이터 스토어의 다중 리전 지정을 참고하세요.
PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
LOCATION: 데이터 스토어의 지리적 위치입니다(예: global). 자세한 내용은 위치를 참고하세요.

요청이 성공하면 다음과 비슷한 JSON 응답이 표시됩니다. 응답에는 사용자가 최근에 액세스한 노트북이 최대 500개까지 포함됩니다.

{
  "notebooks": [
    {
      "title": "NOTEBOOK_TITLE_1",
      "notebookId": "NOTEBOOK_ID_1",
      "emoji": "",
      "metadata": {
        "userRole": "PROJECT_ROLE_OWNER",
        "isShared": false,
        "isShareable": true,
        "lastViewed": "LAST_VIEWED_TIME",
        "createTime": "LAST_CREATED_TIME"
      },
      "name": "NOTEBOOK_NAME_1"
    },
    {
      "title": "NOTEBOOK_TITLE_2",
      "notebookId": "NOTEBOOK_ID_2",
      "emoji": "",
      "metadata": {
        "userRole": "PROJECT_ROLE_OWNER",
        "isShared": false,
        "isShareable": true,
        "lastViewed": "LAST_VIEWED_TIME",
        "createTime": "LAST_CREATED_TIME"
      },
      "name": "NOTEBOOK_NAME_2"
    }
  ]
}

노트북 일괄 삭제

노트북을 일괄 삭제하려면 notebooks.batchDelete 메서드를 사용합니다.

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks:batchDelete"
  -d '{
    "names": [
      "NOTEBOOK_NAME_1",
      "NOTEBOOK_NAME_2"
    ]
  }'

다음을 바꿉니다.

ENDPOINT_LOCATION: API 요청의 다중 리전입니다. 다음 값 중 하나를 할당합니다.
- 미국 멀티 리전의 us-
- EU 멀티 리전의 경우 eu-
- 전역 위치의 경우 global-
자세한 내용은 데이터 스토어의 다중 리전 지정을 참고하세요.
PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
LOCATION: 데이터 스토어의 지리적 위치입니다(예: global). 자세한 내용은 위치를 참고하세요.
NOTEBOOK_NAME: 삭제할 노트북의 전체 리소스 이름입니다. 이 필드의 패턴은 projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID입니다.

요청이 성공하면 빈 JSON 객체가 반환됩니다.

새 노트북을 공유하려면 notebooks.share 메서드를 사용합니다.

노트북을 공유하려는 사용자에게 Cloud Notebook 사용자 역할이 부여되어야 합니다.

REST

Google Cloud 프로젝트에서 노트북을 공유하려는 사용자에게 Cloud NotebookLM User Identity and Access Management (IAM) 역할을 할당합니다.
다음 메서드를 호출합니다.
```
curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://ENDPOINT_LOCATION--discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID:share" \
  -d '{
    "accountAndRoles": [
     {
        "email":"USER_EMAIL_1",
        "role":"USER_ROLE_1",
     },
     {
        "email":"USER_EMAIL_2",
        "role":"USER_ROLE_2",
     },
    ]
  }'
```
다음을 바꿉니다.
- ENDPOINT_LOCATION: API 요청의 다중 리전입니다. 다음 값 중 하나를 할당합니다.
  - 미국 멀티 리전의 us-
  - EU 멀티 리전의 경우 eu-
  - 전역 위치의 경우 global-
  자세한 내용은 데이터 스토어의 다중 리전 지정을 참고하세요.
- PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
- LOCATION: 데이터 스토어의 지리적 위치입니다(예: global). 자세한 내용은 위치를 참고하세요.
- NOTEBOOK_ID: 공유하려는 노트북을 식별하는 고유 ID입니다. 공유 또는 검색과 같은 다른 노트북 관리 작업을 하려면 노트북 ID가 필요합니다.
- USER_EMAIL: 노트북을 공유할 사용자의 이메일 주소입니다.
- USER_ROLE: 사용자에게 할당할 역할입니다. 다음 중 하나일 수 있습니다.
  - PROJECT_ROLE_OWNER: 사용자가 프로젝트를 소유합니다.
  - PROJECT_ROLE_WRITER: 사용자에게 프로젝트에 대한 쓰기 권한이 있습니다.
  - PROJECT_ROLE_READER: 사용자에게 프로젝트에 대한 읽기 권한이 있습니다.
  - PROJECT_ROLE_NOT_SHARED:사용자에게 프로젝트 액세스 권한이 없습니다.
요청이 성공하면 빈 JSON 객체가 수신됩니다.

브라우저를 사용하여 사용자 확인

노트북을 올바른 사용자와 공유하고 올바른 역할을 할당했는지 확인하려면 다음 단계를 따르세요.

브라우저에서 노트북을 엽니다. 노트북의 URL 패턴은 다음과 같습니다.

Google ID를 사용하는 경우:

https://notebooklm.cloud.google.com/LOCATION/notebook/NOTEBOOK_ID?project=PROJECT_NUMBER

서드 파티 ID를 사용하는 경우:

https://notebooklm.cloud.google/LOCATION/notebook/NOTEBOOK_ID?project=PROJECT_NUMBER

공유를 클릭합니다.
액세스 권한이 있는 사용자로 표시된 사용자와 할당된 역할을 확인합니다.

다음 단계

프로그래매틱 방식으로 다양한 유형의 데이터 소스를 노트북에 추가합니다.

노트북 만들기 및 관리 (API)

노트북 만들기

REST

생성된 노트북에 액세스하고 브라우저에서 ID 가져오기

노트북 가져오기

REST

최근에 본 노트북 목록

REST

노트북 일괄 삭제

REST

노트북 공유

REST

브라우저를 사용하여 사용자 확인

다음 단계