Contacts

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

Ressourcendarstellungen

Eine Person oder Gruppe, die als Ersteller 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
  ]
}
Property-Name Wert Beschreibung Hinweise
acceptCommands[] list Eine Liste mit Sprachbefehlen für das Menü, die ein Kontakt verarbeiten kann. Glass zeigt für jeden Menübefehl bis zu drei Kontakte an. Wenn mehr Werte vorhanden sind, werden für den jeweiligen Befehl die drei Kontakte mit dem höchsten priority angezeigt. Bearbeitbar
acceptCommands[].type string Die Art des Vorgangs, für den dieser Befehl gilt. Zulässige Werte:
  • TAKE_A_NOTE: Teilt ein Zeitachsenelement mit dem Transkript der Nutzerstimme über den Sprachbefehl „Notiz schreiben“.
  • POST_AN_UPDATE: Teilt ein Zeitachsenelement mit dem Transkript der Nutzerstimme aus dem Sprachbefehl „Update posten“.
Bearbeitbar
acceptTypes[] list Eine Liste der MIME-Typen, die ein Kontakt unterstützt. Der Kontakt wird dem Nutzer angezeigt, wenn einer seiner AcceptTypes mit einem der Typen der Anhänge für das Element übereinstimmt. Wenn keine AcceptTypes angegeben werden, wird der Kontakt für alle Artikel angezeigt. Bearbeitbar
displayName string Der für diesen Kontakt anzuzeigende Name. Bearbeitbar
id string Eine ID für diesen Kontakt. Dieses wird von der Anwendung generiert und als intransparentes Token behandelt. Bearbeitbar
imageUrls[] list Satz von Bild-URLs, die für einen Kontakt angezeigt werden sollen. Die meisten Kontakte verfügen über ein einzelnes Bild. Ein "Gruppen"-Kontakt kann jedoch bis zu acht Bild-URLs enthalten. Diese werden auf dem Client in ihrer Größe angepasst und zu einem Mosaik zugeschnitten. Bearbeitbar
kind string Der Ressourcentyp. Dies ist immer mirror#contact.
phoneNumber string Primäre Telefonnummer des Kontakts Das kann eine voll qualifizierte Nummer mit Landesvorwahl und Ortsvorwahl oder eine lokale Nummer sein. Bearbeitbar
priority unsigned integer Priorität für den Kontakt, um die Reihenfolge in einer Kontaktliste festzulegen. Kontakte mit höherer Priorität werden vor Kontakten mit niedrigerer Priorität angezeigt. Bearbeitbar
sharingFeatures[] list Eine Liste der Freigabefunktionen, die ein Kontakt übernehmen kann. Zulässige Werte:
  • ADD_CAPTION
source string ID der Anwendung, die diesen Kontakt erstellt hat. Daten werden von der API eingefügt
speakableName string Name dieses Kontakts, wie er ausgesprochen werden soll. Wenn der Name dieses Kontakts in einem Menü zur Sprachauswahl ausgesprochen werden muss, wird dieser Name in der erwarteten Aussprache verwendet. Dies ist nützlich für Kontaktnamen, die nicht aussprechbare Zeichen enthalten oder deren Anzeige nicht phonetisch ist. Bearbeitbar
type string Der Typ für diesen Kontakt. Dies wird zum Sortieren in Benutzeroberflächen verwendet. Zulässige Werte:
  • INDIVIDUAL: Stellt eine einzelne Person dar. Das ist die Standardeinstellung.
  • GROUP: steht für mehr als eine Person.
Bearbeitbar

Methoden

delete
Hiermit wird ein Kontakt gelöscht.
get
Ruft einen einzelnen Kontakt nach ID ab.
insert
Fügen Sie einen neuen Kontakt ein.
list
Ruft eine Liste der Kontakte für den authentifizierten Nutzer ab.
patch
Aktualisiert einen Kontakt. Diese Methode unterstützt die Patch-Semantik.
Update
Aktualisiert einen Kontakt.