REST Resource: notes

Risorsa: nota

Una sola nota.

Rappresentazione JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "trashTime": string,
  "trashed": boolean,
  "attachments": [
    {
      object (Attachment)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "title": string,
  "body": {
    object (Section)
  }
}
Campi
name

string

Solo output. Il nome della risorsa di questa nota. Consulta la nota generale sugli identificatori in KeepService.

createTime

string (Timestamp format)

Solo output. Quando è stata creata la nota.

updateTime

string (Timestamp format)

Solo output. Data dell'ultima modifica di questa nota.

trashTime

string (Timestamp format)

Solo output. Quando questa nota è stata spostata nel cestino. Se trashed, alla fine la nota viene eliminata. Se la nota non è nel cestino, questo campo non viene impostato e il campo nel cestino è false.

trashed

boolean

Solo output. true se questa nota è stata spostata nel cestino. Se si trova nel cestino, la nota viene eliminata.

attachments[]

object (Attachment)

Solo output. Gli allegati della nota.

permissions[]

object (Permission)

Solo output. L'elenco delle autorizzazioni impostato nella nota. Contiene almeno una voce per il proprietario della nota.

title

string

Il titolo della nota. La lunghezza deve essere inferiore a 1000 caratteri.

body

object (Section)

Il corpo della nota.

Allegato

Un allegato di una nota.

Rappresentazione JSON
{
  "name": string,
  "mimeType": [
    string
  ]
}
Campi
name

string

Il nome della risorsa;

mimeType[]

string

I tipi MIME (tipi di media IANA) in cui è disponibile l'allegato.

Autorizzazione

Un'unica autorizzazione per la nota. Associa un member a un role.

Rappresentazione JSON
{
  "name": string,
  "role": enum (Role),
  "email": string,
  "deleted": boolean,

  // Union field member can be only one of the following:
  "user": {
    object (User)
  },
  "group": {
    object (Group)
  },
  "family": {
    object (Family)
  }
  // End of list of possible types for union field member.
}
Campi
name

string

Solo output. Il nome della risorsa.

role

enum (Role)

Il ruolo concesso da questa autorizzazione. Il ruolo determina la capacità dell'entità di leggere, scrivere e condividere note.

email

string

L'indirizzo email associato al membro. Se viene impostato su Crea, il campo email nel messaggio User o Group deve essere vuoto o corrispondere a questo campo. In fase di lettura, l'impostazione potrebbe essere annullata se al membro non è associato un indirizzo email.

deleted

boolean

Solo output. Indica se questo membro è stato eliminato. Se l'utente viene recuperato, questo valore è impostato su false e l'utente recuperato mantiene il ruolo nella nota.

Campo di unione member. Specifica l'identità a cui è stato assegnato il ruolo. Il membro non è impostato se è stato eliminato. member può essere solo uno dei seguenti:
user

object (User)

Solo output. L'utente a cui si applica questo ruolo.

group

object (Group)

Solo output. Il gruppo a cui si applica questo ruolo.

family

object (Family)

Solo output. La famiglia Google a cui si applica questo ruolo.

Ruolo

Definisce i vari ruoli che un'entità può avere.

Enum
ROLE_UNSPECIFIED Un ruolo non definito.
OWNER Un ruolo che concede accesso completo. Impossibile aggiungere o rimuovere questo ruolo. Definito dall'autore della nota.
WRITER Un ruolo che concede la possibilità di contribuire con i contenuti e modificare le autorizzazioni per le note.

Utente

Descrive un singolo utente.

Rappresentazione JSON
{
  "email": string
}
Campi
email

string

L'indirizzo email dell'utente.

Gruppo

Descrive un singolo gruppo.

Rappresentazione JSON
{
  "email": string
}
Campi
email

string

L'indirizzo email del gruppo.

Famiglia

Descrive una singola famiglia Google.

Sezione

Il contenuto della nota.

Rappresentazione JSON
{

  // Union field Content can be only one of the following:
  "text": {
    object (TextContent)
  },
  "list": {
    object (ListContent)
  }
  // End of list of possible types for union field Content.
}
Campi
Campo di unione Content. I contenuti della sezione devono essere in uno di questi tipi di valore. Content può essere solo uno dei seguenti:
text

object (TextContent)

Utilizzato se i contenuti di questa sezione sono un blocco di testo. La lunghezza dei contenuti di testo deve essere inferiore a 20.000 caratteri.

list

object (ListContent)

Utilizzato se i contenuti di questa sezione sono un elenco.

ContenutiTesto

Il blocco di testo di una singola sezione di testo o di una voce di elenco.

Rappresentazione JSON
{
  "text": string
}
Campi
text

string

Il testo della nota. I limiti per questo campo variano in base al campo specifico in cui viene utilizzato questo tipo.

Elenco contenuti

L'elenco di voci per una singola nota a elenco.

Rappresentazione JSON
{
  "listItems": [
    {
      object (ListItem)
    }
  ]
}
Campi
listItems[]

object (ListItem)

Le voci dell'elenco. Il numero di elementi deve essere inferiore a 1000.

ListItem

Un singolo elemento dell'elenco in una nota.

Rappresentazione JSON
{
  "childListItems": [
    {
      object (ListItem)
    }
  ],
  "text": {
    object (TextContent)
  },
  "checked": boolean
}
Campi
childListItems[]

object (ListItem)

Se impostato, elenco di voci nidificate in questo elemento dell'elenco. È consentito un solo livello di nidificazione.

text

object (TextContent)

Il testo di questo elemento. La lunghezza deve essere inferiore a 1000 caratteri.

checked

boolean

Indica se l'articolo è stato contrassegnato o meno.

Metodi

create

Crea una nuova nota.

delete

Elimina una nota.

get

Riceve una nota.

list

Elenca le note.