Timeline

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

Ressourcendarstellungen

Jedes Element in der Zeitachse des Nutzers wird als JSON-Struktur TimelineItem dargestellt, wie unten beschrieben.

{
  "kind": "mirror#timelineItem",
  "id": string,
  "sourceItemId": string,
  "canonicalUrl": string,
  "bundleId": string,
  "isBundleCover": boolean,
  "selfLink": string,
  "created": datetime,
  "updated": datetime,
  "displayTime": datetime,
  "isPinned": boolean,
  "pinScore": integer,
  "isDeleted": boolean,
  "etag": etag,
  "creator": contacts Resource,
  "recipients": [
    contacts Resource
  ],
  "inReplyTo": string,
  "title": string,
  "text": string,
  "html": string,
  "speakableType": string,
  "speakableText": string,
  "attachments": [
    timeline.attachments Resource
  ],
  "location": locations Resource,
  "menuItems": [
    {
      "id": string,
      "action": string,
      "values": [
        {
          "state": string,
          "displayName": string,
          "iconUrl": string
        }
      ],
      "removeWhenSelected": boolean,
      "payload": string
    }
  ],
  "notification": {
    "level": string,
    "deliveryTime": datetime
  }
}

Attributname	Wert	Beschreibung	Hinweise
attachments[]	list	Eine Liste der mit diesem Element verknüpften Medienanhänge. Der Einfachheit halber können Sie auf Anhänge in Ihren HTML-Nutzlasten mit dem Anhang- oder CID-Schema verweisen. Beispiel: Anlage: <img src="attachment:attachment_index">, wobei Anhang_Index der 0-basierte Index dieses Arrays ist. cid: <img src="cid:attachment_id">, wobei „attachment_id“ die ID des Anhangs ist
bundleId	string	Die Bundle-ID für diesen Artikel. Dienste können eine Bundle-ID angeben, um mehrere Elemente zu gruppieren. Sie werden unter einem einzelnen Element der obersten Ebene auf dem Gerät angezeigt.	Bearbeitbar
canonicalUrl	string	Eine kanonische URL, die auf die kanonische/hochwertige Version der durch das Zeitachsenelement dargestellten Daten verweist.	Bearbeitbar
created	datetime	Der Zeitpunkt, zu dem dieser Artikel erstellt wurde, formatiert gemäß RFC 3339.
creator	nested object	Der Nutzer oder die Gruppe, der bzw. die dieses Element erstellt hat.	Bearbeitbar
displayTime	datetime	Die Zeit, die angezeigt werden soll, wenn dieses Element auf der Zeitachse angezeigt wird, formatiert gemäß RFC 3339. Die Zeitachse dieses Nutzers wird chronologisch nach der Anzeigezeit sortiert. Dadurch wird auch bestimmt, wo das Element in der Zeitachse angezeigt wird. Wenn dies nicht vom Dienst festgelegt ist, wird standardmäßig updated verwendet.	Bearbeitbar
etag	etag	ETag für dieses Element.
html	string	HTML-Inhalt für dieses Element. Wenn sowohl text als auch html für ein Element angegeben werden, wird das html in der Zeitachse gerendert. Zulässige HTML-Elemente: Diese Elemente können auf den Zeitachsenkarten verwendet werden. Überschriften: h1, h2, h3, h4, h5, h6 Bilder: img Listen: li, ol, ul HTML5-Semantik: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time Strukturell: blockquote, br, div, hr, p, span Stil: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup Tabellen: table, tbody, td, tfoot, th, thead, tr Blockierte HTML-Elemente: Diese Elemente und ihre Inhalte werden aus HTML-Nutzlasten entfernt. Dokumentheader: head, title Einbettungen: audio, embed, object, source, video Rahmen: frame, frameset Skripterstellung: applet, script Andere Elemente: Alle nicht aufgeführten Elemente werden entfernt, ihr Inhalt bleibt jedoch erhalten.	Bearbeitbar
id	string	Die ID des Zeitachsenelements. Er ist innerhalb der Zeitachse eines Nutzers einmalig.
inReplyTo	string	Wenn dieses Element als Antwort auf ein anderes Element generiert wurde, wird in diesem Feld die ID des Elements festgelegt, auf das geantwortet wird. Hiermit können Sie eine Antwort an die entsprechende Unterhaltung oder den entsprechenden Beitrag anhängen.
isBundleCover	boolean	Gibt an, ob es sich bei diesem Artikel um ein Set handelt. Wenn ein Element als Set gekennzeichnet ist, ist es der Einstiegspunkt für das Set mit Elementen, die dieselbe bundleId haben. Sie wird nur auf der Hauptzeitachse eingeblendet – nicht innerhalb des geöffneten Sets. Auf der Hauptzeitachse werden folgende Elemente angezeigt: Elemente mit isBundleCover, die auf true gesetzt sind Elemente ohne bundleId In einer Bundle-Unterzeitachse werden folgende Elemente angezeigt: Elemente mit dem betreffenden bundleId UND isBundleCover auf false	Bearbeitbar
isDeleted	boolean	Wenn „true“ bedeutet, wird dieses Element gelöscht und nur die ID-Property festgelegt.
isPinned	boolean	Wenn dieser Wert wahr ist, wird dieses Element angepinnt, d. h., es wird zusammen mit „aktiven“ Elementen wie Navigation und Hangouts auf der gegenüberliegenden Seite des Startbildschirms von nicht angehefteten Zeitachsenelementen gruppiert. Sie können Nutzern erlauben, den Wert dieser Eigenschaft mit dem integrierten Menüelement TOGGLE_PINNED umzuschalten.
kind	string	Der Ressourcentyp. Das ist immer mirror#timelineItem.
location	nested object	Der geografische Standort, der diesem Element zugeordnet ist.	Bearbeitbar
menuItems[]	list	Eine Liste mit Menüelementen, die dem Nutzer präsentiert werden, wenn er auf der Zeitachse ausgewählt wurde	Bearbeitbar
menuItems[].action	string	Steuert das Verhalten, wenn der Nutzer die Menüoption auswählt. Zulässige Werte: CUSTOM: vom Dienst festgelegte benutzerdefinierte Aktion. Wenn der Nutzer dieses menuItem auswählt, löst die API eine Benachrichtigung an dein callbackUrl aus, wobei userActions.type auf CUSTOM und userActions.payload auf ID dieses Menüs eingestellt ist. „Immer“ ist der Standardwert. Integrierte Aktionen: REPLY – Initiieren Sie über die UI für die Sprachaufnahme eine Antwort auf die Zeitachse. Das creator-Attribut muss auf der Zeitachse festgelegt werden, damit dieses Menü verfügbar ist. REPLY_ALL: Gleiches Verhalten wie REPLY. Die recipients des ursprünglichen Zeitachsenelements wird dem Antwortelement hinzugefügt. DELETE: Zeitachsenelement löschen. SHARE – Teilen Sie das Zeitachsenelement mit den verfügbaren Kontakten. READ_ALOUD: Liest das speakableText-Element der Zeitachse laut vor. Wenn dieses Feld nicht festgelegt ist, wird das Feld text gelesen. Ist keines dieser Felder festgelegt, wird das Menüelement ignoriert. GET_MEDIA_INPUT: Nutzern erlauben, über ein Menüelement Nutzlasten von Glassware bereitzustellen. Derzeit wird nur transkribierter Text aus Spracheingaben unterstützt. Abonnieren Sie Benachrichtigungen, wenn Nutzer diesen Menüpunkt aufrufen, um die ID der Zeitachse zu erhalten. Rufen Sie die Medien aus der Zeitachse in der Eigenschaft payload ab. VOICE_CALL: Initiieren Sie einen Anruf mit dem Attribut creator.phoneNumber der Zeitachse als Empfänger. NAVIGATE: Navigiere zum location der Zeitachse. TOGGLE_PINNED: Aktiviert bzw. deaktiviert den Status isPinned des Elements in der Zeitachse. OPEN_URI – Öffnen Sie das payload-Element des Menüs im Browser. PLAY_VIDEO: Öffnen Sie den payload des Menüpunkts im Glass-Videoplayer. SEND_MESSAGE – Senden einer Nachricht an den creator der Zeitachse starten: Wenn creator.phoneNumber eingerichtet und Glass mit einem Android-Smartphone verbunden ist, erhalten Sie die SMS als SMS. Wenn creator.email festgelegt ist, ist die Nachricht eine E-Mail.	Bearbeitbar
menuItems[].id	string	Die ID für diesen Menüpunkt. Dieser wird von der Anwendung generiert und wird als intransparentes Token behandelt.	Bearbeitbar
menuItems[].payload	string	Eine generische Nutzlast, deren Bedeutung sich je nach Aktion dieses Menüs ändert. Wenn die Aktion OPEN_URI ist, ist die Nutzlast die URL der anzuzeigenden Website. Bei der Aktion PLAY_VIDEO ist die Nutzlast die Streaming-URL des Videos. Wenn die Aktion GET_MEDIA_INPUT ist, ist die Nutzlast die Texttranskription der Spracheingabe des Nutzers.	Bearbeitbar
menuItems[].removeWhenSelected	boolean	Wenn der Wert für ein Menüelement von CUSTOM auf „true“ gesetzt wird, wird das Element nach der Auswahl aus dem Menü entfernt.	Bearbeitbar
menuItems[].values[]	list	Bei CUSTOM-Elementen eine Liste von Werten, die das Erscheinungsbild des Menüelements in jedem der Status steuern. Für den Status DEFAULT muss ein Wert angegeben werden. Wenn die Status PENDING oder CONFIRMED fehlen, werden sie nicht angezeigt.	Bearbeitbar
menuItems[].values[].displayName	string	Der Name, der für den Menüpunkt angezeigt werden soll. Wenn Sie diese Eigenschaft für einen integrierten Menüpunkt angeben, wird der standardmäßige kontextbezogene Sprachbefehl für diesen Menüpunkt nicht angezeigt.	Bearbeitbar
menuItems[].values[].iconUrl	string	URL eines Symbols, das zusammen mit dem Menüelement angezeigt werden soll.	Bearbeitbar
menuItems[].values[].state	string	Der Bundesstaat, für den dieser Wert gilt. Zulässige Werte: DEFAULT: Standardwert, der in der Liste menuItems angezeigt wird. PENDING: Wert, der angezeigt wird, wenn menuItem vom Nutzer ausgewählt wurde, aber trotzdem abgebrochen werden kann. CONFIRMED: Dieser Wert wird angezeigt, wenn „menuItem“ vom Nutzer ausgewählt wurde und nicht mehr abgebrochen werden kann.	Bearbeitbar
notification	nested object	Steuert, wie Benachrichtigungen für diesen Artikel auf dem Gerät dargestellt werden. Fehlt diese Angabe, wird keine Benachrichtigung erstellt.	Bearbeitbar
notification.deliveryTime	datetime	Der Zeitpunkt, zu dem die Benachrichtigung gesendet werden soll.	Bearbeitbar
notification.level	string	Beschreibt, wie wichtig die Benachrichtigung ist. Zulässige Werte sind: DEFAULT: Standardbenachrichtigungen. Ein Glockenton wird abgespielt, um die Nutzer zu warnen.	Bearbeitbar
pinScore	integer	Bei angepinnten Elementen wird dadurch die Reihenfolge festgelegt, in der die Elemente auf der Zeitachse zu sehen sind. Je höher die Zahl, desto höher die Punktzahl. Hinweis: Das Festlegen dieses Felds wird derzeit nicht unterstützt.
recipients[]	list	Eine Liste der Nutzer oder Gruppen, für die das Element freigegeben wurde.	Bearbeitbar
selfLink	string	Eine URL, die zum Abrufen dieses Elements verwendet werden kann.
sourceItemId	string	Intransparenter String, den Sie verwenden können, um ein Zeitachsenelement Daten in Ihrem eigenen Dienst zuzuordnen.	Bearbeitbar
speakableText	string	Die vorlesbare Version des Inhalts dieses Artikels. Verwenden Sie dieses Feld zusammen mit dem Menüpunkt READ_ALOUD, um Text anzugeben, der beim Vorlesen klarer wird, oder um zusätzliche Informationen zu den Elementen in Glass bereitzustellen. Glassware sollte auch das Feld „SpeakableType“ angeben. Dieses wird vor diesem Text gesprochen, wenn der zusätzliche Kontext nützlich ist, z. B. wenn der Nutzer nach einer Benachrichtigung anfordert, dass der Artikel vorgelesen wird.	Bearbeitbar
speakableType	string	Eine gut lesbare Beschreibung des Typs dieses Elements. Dies wird dem Nutzer vor dem Lesen des Inhalts mitgeteilt, wenn der zusätzliche Kontext nützlich ist, z. B. wenn der Nutzer nach einer Benachrichtigung anfordert, dass der Artikel vorgelesen wird. Das sollte eine kurze, einfache Nominalphrase sein, z. B. „E-Mail“, „SMS“ oder „Daily Planet News“. Glassware wird empfohlen, dieses Feld für jedes Zeitachsenelement auszufüllen, auch wenn das Element keinen Sprecher oder Text enthält. So kann der Nutzer den Typ des Elements erkennen, ohne auf den Bildschirm zu sehen.	Bearbeitbar
text	string	Textinhalt dieses Artikels.	Bearbeitbar
title	string	Der Titel dieses Artikels.	Bearbeitbar
updated	datetime	Der Zeitpunkt, zu dem dieser Artikel zuletzt geändert wurde, gemäß RFC 3339 formatiert.

Methoden

Delete

Löscht ein Zeitachsenelement.

erhalten

Ruft ein einzelnes Zeitachsenelement nach ID ab.

Einfügen

Fügt ein neues Element in die Zeitachse ein.

list

Ruft eine Liste mit Zeitachsenelementen für den authentifizierten Nutzer ab.

Patch

Aktualisiert ein Zeitachsenelement. Diese Methode unterstützt die Patch-Semantik.

Aktualisieren

Aktualisiert ein Zeitachsenelement.