Timeline

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Każdy element na osi czasu użytkownika jest reprezentowany jako struktura JSON TimelineItem, zgodnie z opisem poniżej.

{
  "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
  }
}
Nazwa usługi Wartość Opis Uwagi
attachments[] list Lista załączników multimedialnych powiązanych z tym elementem. Dla wygody możesz odwoływać się do załączników w ładunkach HTML za pomocą schematu załącznika lub schematu cid. Na przykład:
  • przyłącze: <img src="attachment:attachment_index">, gdzie indeks_załącznika to indeks tej tablicy oparty na 0.
  • cid: <img src="cid:attachment_id">, gdzie załącznik_id to identyfikator załącznika.
bundleId string Identyfikator pakietu danego produktu. Usługi mogą mieć określony identyfikator pakietu, aby zgrupować wiele elementów. Są one wyświetlane na urządzeniu pod jednym elementem najwyższego poziomu. z możliwością zapisu
canonicalUrl string Kanoniczny adres URL wskazujący kanoniczną lub wysoką jakość danych reprezentowanych przez element osi czasu. z możliwością zapisu
created datetime Godzina utworzenia elementu podana w formacie RFC 3339.
creator nested object Użytkownik lub grupa, która utworzyła ten element. z możliwością zapisu
displayTime datetime Godzina, która powinna być wyświetlana, gdy ten element jest wyświetlany na osi czasu, sformatowany zgodnie ze standardem RFC 3339. Oś czasu tego użytkownika jest posortowana chronologicznie według czasu wyświetlania, dlatego ma to również wpływ na miejsce wyświetlania produktu na osi czasu. Jeśli usługa nie ustawi tego czasu, domyślnym czasem wyświetlania będzie updated. z możliwością zapisu
etag etag Tag ETag tego elementu.
html string Zawartość HTML tego elementu. Jeśli w przypadku danego elementu podasz zarówno text, jak i html, na osi czasu zostanie wyświetlona wartość html.

Dozwolone elementy HTML – możesz używać tych elementów na kartach osi czasu.

  • Nagłówki: h1, h2, h3, h4, h5, h6
  • Obrazy: img
  • Listy: li, ol, ul
  • Semantyka HTML5: article, aside, details, figure, figcaption, footer, header, nav, section, summary, time
  • Struktura: blockquote, br, div, hr, p, span
  • Styl: b, big, center, em, i, u, s, small, strike, strong, style, sub, sup
  • Tabele: table, tbody, td, tfoot, th, thead, tr

Zablokowane elementy HTML: te elementy i ich zawartość są usuwane z ładunków HTML.

  • Nagłówki dokumentów: head, title
  • Umieszczone: audio, embed, object, source, video
  • Ramki: frame, frameset
  • Skrypt: applet, script

Inne elementy: wszystkie elementy, których nie ma na liście, są usuwane, ale ich zawartość pozostaje bez zmian.

z możliwością zapisu
id string Identyfikator elementu osi czasu. Jest to unikalne działanie w obrębie osi czasu użytkownika.
inReplyTo string Jeśli ten element został wygenerowany jako odpowiedź na inny element, w tym polu zostanie ustawiony identyfikator produktu, na który odpowiadasz. W ten sposób możesz załączyć odpowiedź do właściwej rozmowy lub posta.
isBundleCover boolean Określa, czy ten produkt jest okładką pakietu.

Jeśli element jest oznaczony jako okładka pakietu, będzie to punkt wejścia do pakietu elementów mających ten sam atrybut bundleId co ten element. Będzie wyświetlany tylko na głównej osi czasu, a nie w otwartym pakiecie.

Na głównej osi czasu wyświetlane są:
  • Elementy, w których atrybut isBundleCover ma wartość true.
  • Elementy, które nie mają atrybutu bundleId
Na osi czasu pakietu wyświetlane są:
  • Elementy, w których parametr bundleId jest określony ORAZ isBundleCover jest ustawiony na false
z możliwością zapisu
isDeleted boolean Jeśli ma wartość true (prawda), oznacza to, że element został usunięty, a ustawiona jest tylko właściwość ID.
isPinned boolean Jeśli ma wartość true (prawda), ten element jest przypięty, co oznacza, że jest zgrupowany jako „aktywny”. takie jak nawigacja i spotkania, po przeciwnej stronie ekranu głównego niż historyczne (nieprzypięte) elementy osi czasu. Możesz zezwolić użytkownikowi na przełączanie wartości tej właściwości za pomocą wbudowanego menu TOGGLE_PINNED.
kind string Typ zasobu. To zawsze mirror#timelineItem.
location nested object Położenie geograficzne powiązane z tym elementem. z możliwością zapisu
notification nested object Określa sposób wyświetlania na urządzeniu powiadomień dotyczących tego elementu. W przypadku jego braku powiadomienie nie zostanie wygenerowane. z możliwością zapisu
notification.deliveryTime datetime Godzina dostarczenia powiadomienia. z możliwością zapisu
notification.level string Określa, jak ważne jest powiadomienie. Dozwolone wartości to:
  • DEFAULT – powiadomienia o domyślnej ważności. Usłyszysz sygnał dźwiękowy, który będzie ostrzegać użytkowników.
z możliwością zapisu
pinScore integer W przypadku przypiętych elementów określa to kolejność, w jakiej dany element jest wyświetlany na osi czasu, a wyższy wynik jest widoczny bliżej zegara. Uwaga: ustawienie tego pola nie jest obecnie obsługiwane.
recipients[] list Lista użytkowników lub grup, którym udostępniono ten element. z możliwością zapisu
sourceItemId string Nieprzezroczysty ciąg znaków, którego możesz używać do zmapowania elementu osi czasu na dane w swojej usłudze. z możliwością zapisu
speakableText string Wypowiadająca się na głos wersja zawartości tego elementu. W tym polu oprócz pozycji menu READ_ALOUD możesz podać tekst, który będzie wyraźniejszy podczas czytania na głos, lub podać rozszerzone informacje o tym, co jest wyświetlane na ekranie Google Glass.

Glassware powinien też zawierać pole speechableType, które będzie odczytywane przed tym tekstem w przypadkach, gdy dodatkowy kontekst jest przydatny, na przykład gdy użytkownik zażąda odczytania elementu na głos po powiadomieniu.
z możliwością zapisu
speakableType string Mówiony opis typu elementu. Jest to sygnalizowane użytkownikowi przed przeczytaniem treści produktu w przypadkach, gdy przydatny jest dodatkowy kontekst, np. gdy użytkownik poprosi o przeczytanie elementu na głos po powiadomieniu.

To powinno być krótkie, proste wyrażenie, np. „E-mail”, „SMS” lub „Codzienne aktualności na temat planety”.

Zalecamy, aby w przypadku wszystkich elementów osi czasu wypełnić to pole dla oprogramowania Glassware, nawet jeśli nie zawiera on tekstu SayableText ani tekstu, dzięki czemu użytkownik może poznać typ elementu bez patrzenia na ekran.
z możliwością zapisu
text string Zawartość tekstowa tego elementu. z możliwością zapisu
title string Tytuł tego produktu. z możliwością zapisu
updated datetime Czas ostatniej modyfikacji elementu podany w formacie zgodnym ze standardem RFC 3339.

Metody

usuń
Usuwa element osi czasu.
pobierz
Pobiera jeden element osi czasu według identyfikatora.
wstaw
Wstawia nowy element na osi czasu.
list
Pobiera listę elementów osi czasu dla uwierzytelnionego użytkownika.
poprawka
Aktualizuje element osi czasu. Ta metoda obsługuje semantykę poprawki.
zaktualizuj
Aktualizuje element osi czasu.