Contacts

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Eine Person oder Gruppe, die als Creator oder Kontakt verwendet werden kann.

{
  "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
  ]
}
Attributname Wert Beschreibung Hinweise
acceptCommands[] list Eine Liste von Sprachbefehlen, die ein Kontakt verarbeiten kann Glass zeigt bis zu drei Kontakte pro Sprachbefehl an. Wenn es mehr gibt, werden die drei Kontakte mit dem höchsten priority für diesen bestimmten Befehl angezeigt. Bearbeitbar
acceptCommands[].type string Der Typ des Vorgangs, dem dieser Befehl entspricht. Zulässige Werte:
  • TAKE_A_NOTE: Gibt ein Zeitachsenelement frei, das über den Sprachbefehl „Notiz erstellen“ mit der Sprache des Nutzers gesprochen wird.
  • POST_AN_UPDATE: Gibt ein Zeitachsenelement frei, das über den Sprachbefehl „Aktualisierung aktualisieren“ mit der Transkription von Nutzersprache geteilt wird.
Bearbeitbar
acceptTypes[] list Eine Liste der MIME-Typen, die ein Kontakt unterstützt. Der Kontakt wird dem Nutzer angezeigt, wenn einer seiner akzeptierten Typen mit einem der Arten von Anhängen auf dem Element übereinstimmt. Wenn keine AcceptTypes angegeben werden, wird der Kontakt für alle Artikel angezeigt. Bearbeitbar
displayName string Der Name, der für diesen Kontakt angezeigt werden soll. Bearbeitbar
id string Eine ID für diesen Kontakt. Dieser wird von der Anwendung generiert und wird als intransparentes Token behandelt. Bearbeitbar
imageUrls[] list Bild-URLs, die für einen Kontakt angezeigt werden sollen. Die meisten Kontakte haben ein einzelnes Bild. Ein Kontakt aus der Gruppe kann aber bis zu acht Bild-URLs umfassen. Die Größe dieser Kontakte wird angepasst und auf dem Client in ein Mosaik zugeschnitten. Bearbeitbar
kind string Der Ressourcentyp. Das ist immer mirror#contact.
phoneNumber string Primäre Telefonnummer des Kontakts. Das kann eine voll qualifizierte Nummer mit Ländervorwahl und Vorwahl oder eine lokale Nummer sein. Bearbeitbar
priority unsigned integer Priorität für den Kontakt, um die Reihenfolge in der Kontaktliste festzulegen. Kontakte mit höherer Priorität werden vor Kontakten mit niedrigerer Priorität angezeigt. Bearbeitbar
sharingFeatures[] list Eine Liste von Freigabefunktionen, die ein Kontakt verarbeiten kann. Zulässige Werte:
  • ADD_CAPTION
source string Die ID der Anwendung, die diesen Kontakt erstellt hat. Wird von der API ausgefüllt
speakableName string Name dieses Kontakts, wie er ausgesprochen werden sollte. Wenn der Name dieses Kontakts im Menü zur Sprachdeklaration gesprochen werden muss, wird dieser Name als erwartete Aussprache verwendet. Das ist hilfreich bei Kontaktnamen mit nicht aussprechenden Zeichen oder wenn ihre Schreibweise sonst nicht phonetisch ist. Bearbeitbar
type string Der Typ für diesen Kontakt. Wird zum Sortieren in Benutzeroberflächen verwendet. Zulässige Werte:
  • INDIVIDUAL: Steht für eine einzelne Person. Das ist die Standardeinstellung.
  • GROUP: Darstellung mehrerer Personen
Bearbeitbar

Methoden

Delete
Löscht einen Kontakt.
erhalten
Ruft einen einzelnen Kontakt nach ID ab.
Einfügen
Neuen Kontakt einfügen
list
Ruft eine Liste der Kontakte des authentifizierten Nutzers ab.
Patch
Aktualisiert einen vorhandenen Kontakt. Diese Methode unterstützt die Patch-Semantik.
Aktualisieren
Aktualisiert einen vorhandenen Kontakt.