Contacts

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Personne ou groupe pouvant être utilisé comme créateur ou contact.

{
  "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
  ]
}
Nom de propriété Valeur Description Remarques
acceptCommands[] list Liste des commandes de menu vocal qu'un contact peut gérer. Les Google Glass affichent jusqu'à trois contacts pour chaque commande du menu vocal. S'il y en a plus, les trois contacts dont le priority est le plus élevé sont affichés pour la commande concernée. accessible en écriture
acceptCommands[].type string Type d'opération auquel cette commande correspond. Valeurs autorisées:
  • TAKE_A_NOTE : partage un élément de la chronologie avec la transcription du discours de l'utilisateur de la section "Créer une note" commande de menu vocal.
  • POST_AN_UPDATE : partage un élément de la chronologie avec la transcription des propos de l'utilisateur à partir de l'option "Publier une actualité" commande de menu vocal.
accessible en écriture
acceptTypes[] list Liste des types MIME pris en charge par un contact. Le contact sera présenté à l'utilisateur si l'une de ses valeurs "acceptType" correspond à l'un des types de pièces jointes associés à l'élément. Si aucune valeur "acceptTypes" n'est définie, le contact est affiché pour tous les éléments. accessible en écriture
displayName string Nom à afficher pour ce contact. accessible en écriture
id string Identifiant de ce contact. Il est généré par l'application et traité comme un jeton opaque. accessible en écriture
imageUrls[] list Ensemble d'URL d'images à afficher pour un contact. La plupart des contacts n'ont qu'une seule image, mais un "groupe" peut inclure jusqu'à 8 URL d'images, qui seront redimensionnées et recadrées pour former une mosaïque sur le client. accessible en écriture
kind string Type de ressource. Il s'agit toujours de mirror#contact.
phoneNumber string Numéro de téléphone principal du contact. Il peut s'agir d'un numéro complet, avec l'indicatif de pays et d'un indicatif de zone, ou d'un numéro local. accessible en écriture
priority unsigned integer Priorité du contact pour déterminer l'ordre dans une liste de contacts. Les contacts dont la priorité est plus élevée sont affichés avant ceux dont la priorité est plus faible. accessible en écriture
sharingFeatures[] list Liste des fonctionnalités de partage qu'un contact peut gérer. Valeurs autorisées:
  • ADD_CAPTION
source string ID de l'application qui a créé ce contact. Ces informations sont renseignées par l'API
speakableName string Nom de ce contact, tel qu'il doit être prononcé. Si le nom de ce contact doit être prononcé dans un menu de sélection vocale, ce nom est utilisé comme prononciation attendue. Cette option est utile pour les contacts contenant des caractères imprononçables ou dont l'orthographe n'est pas phonétique. accessible en écriture
type string Type pour ce contact. Ceci est utilisé pour le tri dans les interfaces utilisateur. Valeurs autorisées:
  • INDIVIDUAL : représente une seule personne. Il s'agit de la valeur par défaut.
  • GROUP : représente plusieurs personnes.
accessible en écriture

Méthodes

supprimer
Supprime un contact.
get
Récupère un seul contact par son ID.
insérer
Insère un nouveau contact.
liste
Récupère la liste des contacts de l'utilisateur authentifié.
patch
Modifie un contact existant. Cette méthode est compatible avec la sémantique "patch".
mise à jour
Modifie un contact existant.