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. Produkty, 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
menuItems[]	list	Lista pozycji menu wyświetlanych użytkownikowi po wybraniu tego elementu na osi czasu.	z możliwością zapisu
menuItems[].action	string	Kontroluje zachowanie, gdy użytkownik wybierze opcję menu. Dozwolone wartości to: CUSTOM – działanie niestandardowe ustawione przez usługę. Gdy użytkownik wybierze wartość menuItem, interfejs API wywoła powiadomienie w elemencie callbackUrl z parametrem userActions.type ustawionym na CUSTOM, a w opcji userActions.payload ustawioną na ID tego elementu menu. jest to wartość domyślna Wbudowane działania: REPLY – zainicjuj odpowiedź na element osi czasu, używając interfejsu nagrywania głosowego. Aby to menu było dostępne, musi być ustawiony atrybut creator w elemencie osi czasu. REPLY_ALL – działa tak samo jak REPLY. Do odpowiedzi zostanie dodany element recipients pierwotnego elementu na osi czasu. DELETE – usuń element osi czasu. SHARE – udostępnij element osi czasu dostępnym kontaktom. READ_ALOUD – odczytuje na głos tekst speakableText elementu na osi czasu. jeśli to pole nie jest ustawione, przeczytaj pole text; Jeśli nie ustawisz żadnego z tych pól, ta pozycja menu zostanie zignorowana. GET_MEDIA_INPUT – zezwalaj użytkownikom na przekazywanie ładunków multimedialnych do Glassware z poziomu pozycji menu (obecnie obsługiwane są tylko transkrypcje tekstu z rozpoznawania mowy). Subskrybuj powiadomienia, gdy użytkownicy wywołają tę pozycję menu, aby otrzymać identyfikator elementu osi czasu. Pobierz multimedia z elementu osi czasu we właściwości payload. VOICE_CALL – nawiąż połączenie telefoniczne, używając atrybutu creator.phoneNumber elementu osi czasu jako odbiorcy. NAVIGATE – przejdź do elementu location elementu osi czasu. TOGGLE_PINNED – przełącz stan isPinned elementu na osi czasu. OPEN_URI – otwórz payload pozycji menu w przeglądarce. PLAY_VIDEO – otwórz payload z menu w odtwarzaczu Google Glass. SEND_MESSAGE – zainicjuj wysyłanie wiadomości do elementu na osi czasu (creator): Jeśli creator.phoneNumber jest skonfigurowany, a Glass jest połączony z telefonem z Androidem, wiadomość jest SMS-em. W przeciwnym razie, jeśli skonfigurowana jest zasada creator.email, wiadomość jest e-mailem.	z możliwością zapisu
menuItems[].id	string	Identyfikator tej pozycji menu. Jest on generowany przez aplikację i traktowany jako nieprzejrzysty token.	z możliwością zapisu
menuItems[].payload	string	Ogólny ładunek, którego znaczenie zmienia się w zależności od działania tego elementu MenuItem. W przypadku działania OPEN_URI ładunkiem jest adres URL witryny, która ma zostać wyświetlona. Gdy działaniem jest PLAY_VIDEO, ładunkiem jest adres URL strumienia wideo. Gdy działaniem jest GET_MEDIA_INPUT, ładunkiem jest transkrypcja tekstu wpisywanego przez użytkownika.	z możliwością zapisu
menuItems[].removeWhenSelected	boolean	Jeśli w przypadku elementu menu CUSTOM ustawiona jest wartość Prawda, po wybraniu elementu zostanie on usunięty z menu.	z możliwością zapisu
menuItems[].values[]	list	W przypadku elementów CUSTOM lista wartości, które kontrolują wygląd pozycji menu w każdym z jej stanów. Musisz podać wartość stanu DEFAULT. Jeśli brakuje stanu PENDING lub CONFIRMED, nie będą one wyświetlane.	z możliwością zapisu
menuItems[].values[].displayName	string	Wyświetlana nazwa pozycji menu. Jeśli określisz tę właściwość na potrzeby wbudowanej pozycji menu, domyślne kontekstowe polecenie głosowe tego elementu nie będzie wyświetlane.	z możliwością zapisu
menuItems[].values[].iconUrl	string	Adres URL ikony wyświetlanej z pozycją menu.	z możliwością zapisu
menuItems[].values[].state	string	Stan, do którego odnosi się dana wartość. Dozwolone wartości to: DEFAULT – wartość domyślna wyświetlana na liście menuItems. PENDING – wartość, która wyświetla się, gdy użytkownik wybrał opcję menuItem, ale można ją anulować. CONFIRMED – wartość wyświetlana, gdy użytkownik wybrał element menuItem i nie można go już anulować.	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
selfLink	string	Adres URL, za pomocą którego można pobrać ten element.
sourceItemId	string	Nieprzezroczysty ciąg znaków, którego możesz używać do mapowania elementu osi czasu na dane w Twojej 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.