Contacts

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

Una persona o un gruppo che può essere utilizzato come creator o contatto.

{
  "kind": "mirror#contact",
  "source": string,
  "id": string,
  "displayName": string,
  "imageUrls": [
    string
  ],
  "type": string,
  "acceptTypes": [
    string
  ],
  "phoneNumber": string,
  "priority": unsigned integer,
  "acceptCommands": [
    {
      "type": string
    }
  ],
  "speakableName": string,
  "sharingFeatures": [
    string
  ]
}
Nome proprietà Valore Descrizione Note
acceptCommands[] list Un elenco di comandi del menu vocale che un contatto può gestire. Glass mostra fino a tre contatti per ogni comando del menu vocale. Se sono più numerosi, vengono mostrati i tre contatti con il valore priority più alto per quel determinato comando. accessibile in scrittura
acceptCommands[].type string Il tipo di operazione a cui corrisponde questo comando. I valori consentiti sono:
  • TAKE_A_NOTE: consente di condividere un elemento della sequenza temporale con la trascrizione del parlato dell'utente dal comando del menu vocale "Scrivi una nota".
  • POST_AN_UPDATE: consente di condividere un elemento della sequenza temporale con la trascrizione del parlato dell'utente dal comando del menu vocale "Pubblica un aggiornamento".
accessibile in scrittura
acceptTypes[] list Un elenco dei tipi MIME supportati da un contatto. Il contatto verrà mostrato all'utente se uno qualsiasi dei suoi acceptTypes corrisponde a uno qualsiasi dei tipi di allegati nell'elemento. Se non viene fornito alcun valoreacceptTypes, il contatto verrà mostrato per tutti gli elementi. accessibile in scrittura
displayName string Il nome da visualizzare per questo contatto. accessibile in scrittura
id string Un ID per questo contatto. Viene generato dall'applicazione e viene considerato come un token opaco. accessibile in scrittura
imageUrls[] list Insieme di URL immagine da visualizzare per un contatto. La maggior parte dei contatti avrà una sola immagine, ma un contatto di "gruppo" può includere fino a 8 URL immagine, che verranno ridimensionati e ritagliati in un mosaico nel client. accessibile in scrittura
kind string Il tipo di risorsa. Il valore è sempre mirror#contact.
phoneNumber string Numero di telefono principale del contatto. Può essere un numero completo, con prefisso internazionale e prefisso, o un numero locale. accessibile in scrittura
priority unsigned integer Priorità del contatto per determinare l'ordine in un elenco di contatti. I contatti con priorità più alte verranno visualizzati prima di quelli con priorità più bassa. accessibile in scrittura
sharingFeatures[] list Un elenco di funzionalità di condivisione che un contatto può gestire. I valori consentiti sono:
  • ADD_CAPTION
source string L'ID dell'applicazione che ha creato il contatto. Questo campo viene compilato dall'API
speakableName string Nome di questo contatto come deve essere pronunciato. Se il nome di questo contatto deve essere pronunciato nell'ambito di un menu di disambiguazione della voce, questo nome viene utilizzato come pronuncia prevista. È utile per i nomi dei contatti con caratteri non pronunciabili o la cui ortografia viene visualizzata altrimenti non fonetica. accessibile in scrittura
type string Il tipo di questo contatto. Viene utilizzato per l'ordinamento nelle UI. I valori consentiti sono:
  • INDIVIDUAL: rappresenta una singola persona. Questa è l'impostazione predefinita.
  • GROUP: rappresenta più di una persona.
accessibile in scrittura

Metodi

elimina
Elimina un contatto.
trova
Recupera un singolo contatto per ID.
inserisci
Inserisce un nuovo contatto.
list
Recupera un elenco di contatti per l'utente autenticato.
patch
Aggiorna un contatto attivo. Questo metodo supporta la semantica della patch.
aggiorna
Aggiorna un contatto attivo.