Questa pagina è stata tradotta dall'API Cloud Translation.

Creare e gestire notebook (API)

NotebookLM Enterprise è uno strumento potente per generare approfondimenti e riepiloghi dai tuoi documenti. Questa pagina descrive le API che ti consentono di eseguire le seguenti attività di gestione dei blocchi note in modo programmatico:

Creare un notebook
Recuperare un notebook
Elenca i notebook visualizzati di recente
Eliminare notebook in batch
Condividere un notebook

Crea un notebook

Per creare un nuovo notebook, utilizza il metodo 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",
  }'

Sostituisci quanto segue:

ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
- us- per la multiregione Stati Uniti
- eu- per la multiregione EU
- global- per la località globale
Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
LOCATION: la posizione geografica del tuo datastore, ad esempio global. Per ulteriori informazioni, consulta Località.
NOTEBOOK_TITLE: una stringa codificata in UTF-8 utilizzata come titolo del blocco note da creare.

Se la richiesta va a buon fine, dovresti ricevere un JSON simile al seguente.

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

Tieni presente quanto segue:

NOTEBOOK_ID: un ID univoco per identificare il notebook creato. L'ID notebook è necessario per altre attività di gestione del notebook, come la condivisione o il recupero.
NOTEBOOK_NAME: il nome completo della risorsa del notebook. Questo campo ha il seguente pattern: projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID

Accedere al notebook creato e ottenere il relativo ID in un browser

Per accedere al blocco note creato e ottenere il relativo ID utilizzando un browser:

Vai alla home page di NotebookLM Enterprise disponibile a uno dei seguenti URL:
1. Se utilizzi un'identità Google, vai a:
```
https://notebooklm.cloud.google.com/LOCATION/?project=PROJECT_NUMBER
```
2. Se utilizzi un'identità di terze parti, vai a:
```
https://notebooklm.cloud.google/LOCATION/?project=PROJECT_NUMBER
```

Seleziona il notebook creato. L'URL del notebook selezionato ha il seguente pattern:

Se utilizzi un'identità Google:

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

Se utilizzi un'identità di terze parti:

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

Prendi nota dell'URL e dell'ID del notebook, che sono utili per altre attività di gestione del notebook, come la condivisione.

Recuperare un notebook

Per recuperare un blocco note specifico utilizzando il relativo ID, utilizza il metodo 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"

Sostituisci quanto segue:

ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
- us- per la multiregione Stati Uniti
- eu- per la multiregione EU
- global- per la località globale
Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
LOCATION: la posizione geografica del tuo datastore, ad esempio global. Per ulteriori informazioni, consulta Località.
NOTEBOOK_ID: l'identificatore univoco del notebook che hai ricevuto quando l'hai creato.

Se la richiesta ha esito positivo, dovresti ricevere una risposta JSON simile alla seguente per un blocco note vuoto. Se chiami questo metodo dopo aver aggiunto fonti al notebook, ricevi i dettagli di tutte le fonti aggiunte al notebook recuperato. Se hai configurato i dettagli di CMEK, riceverai anche informazioni relative a CMEK per il notebook.

{
"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"
}

Elenca i notebook visualizzati di recente

Per ottenere un elenco di tutti i blocchi note di un progetto visualizzati di recente, utilizza il metodo notebooks.listRecentlyViewed. Per impostazione predefinita, la risposta elenca gli ultimi 500 blocchi note. Puoi scegliere di paginare le risposte con il parametro di query 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"

Sostituisci quanto segue:

ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
- us- per la multiregione Stati Uniti
- eu- per la multiregione EU
- global- per la località globale
Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
LOCATION: la posizione geografica del tuo datastore, ad esempio global. Per ulteriori informazioni, consulta Località.

Se la richiesta ha esito positivo, dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene fino agli ultimi 500 blocchi note a cui un utente ha eseguito l'accesso di recente.

{
  "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"
    }
  ]
}

Eliminare i notebook in batch

Per eliminare i blocchi note in batch, utilizza il metodo 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"
    ]
  }'

Sostituisci quanto segue:

ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
- us- per la multiregione Stati Uniti
- eu- per la multiregione EU
- global- per la località globale
Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
LOCATION: la posizione geografica del tuo datastore, ad esempio global. Per ulteriori informazioni, consulta Località.
NOTEBOOK_NAME: il nome completo della risorsa del notebook da eliminare. Questo campo ha il pattern: projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID.

Se la richiesta ha esito positivo, dovresti ricevere un oggetto JSON vuoto.

Per condividere un nuovo notebook, utilizza il metodo notebooks.share.

All'utente con cui vuoi condividere il notebook deve essere concesso il ruolo Utente notebook Cloud.

REST

Nel tuo progetto Google Cloud , assegna il ruolo IAM Cloud NotebookLM User agli utenti con cui vuoi condividere il notebook.
Chiama il seguente metodo.
```
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",
     },
    ]
  }'
```
Sostituisci quanto segue:
- ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Assegna uno dei seguenti valori:
  - us- per la multiregione Stati Uniti
  - eu- per la multiregione EU
  - global- per la località globale
  Per ulteriori informazioni, vedi Specificare una regione multiregionale per il datastore.
- PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
- LOCATION: la posizione geografica del tuo datastore, ad esempio global. Per ulteriori informazioni, consulta Località.
- NOTEBOOK_ID: un ID univoco per identificare il notebook che vuoi condividere. L'ID notebook è necessario per altre attività di gestione del notebook, come la condivisione o il recupero.
- USER_EMAIL: l'indirizzo email dell'utente con cui vuoi condividere il blocco note.
- USER_ROLE: un ruolo che vuoi assegnare all'utente. Può essere uno dei seguenti:
  - PROJECT_ROLE_OWNER: L'utente è proprietario del progetto.
  - PROJECT_ROLE_WRITER: l'utente dispone delle autorizzazioni di scrittura sul progetto.
  - PROJECT_ROLE_READER: l'utente dispone delle autorizzazioni di lettura sul progetto.
  - PROJECT_ROLE_NOT_SHARED:L'utente non ha accesso al progetto.
Se la richiesta riesce, ricevi un oggetto JSON vuoto.

Verificare gli utenti utilizzando un browser

Per verificare di aver condiviso il blocco note con gli utenti corretti e di aver assegnato loro i ruoli corretti, segui questi passaggi:

Apri il notebook nel browser. Un notebook ha il seguente pattern URL:

Se utilizzi un'identità Google:

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

Se utilizzi un'identità di terze parti:

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

Fai clic su Condividi.
Verifica gli utenti elencati come Persone con accesso e i ruoli assegnati.

Passaggi successivi

Aggiungi origini dati di diversi tipi ai tuoi blocchi note in modo programmatico.

Creare e gestire notebook (API)

Crea un notebook

REST

Accedere al notebook creato e ottenere il relativo ID in un browser

Recuperare un notebook

REST

Elenca i notebook visualizzati di recente

REST

Eliminare i notebook in batch

REST

Condividere un notebook

REST

Verificare gli utenti utilizzando un browser

Passaggi successivi