REST Resource: devices

Zasób: AmbientDevice

Prezentacja urządzenia z ekranem zgodnym z otoczeniem.

Zapis JSON
{
  "id": string,
  "displayName": string,
  "mediaSources": [
    {
      object (AmbientMediaSource)
    }
  ],
  "settingsUri": string,
  "createTime": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaSourcesSet": boolean
}
Pola
id

string

Tylko dane wyjściowe. Unikalny identyfikator tego urządzenia.

displayName

string

Wymagane. Zdefiniowana przez użytkownika wyświetlana nazwa tego urządzenia.

Będzie on widoczny dla użytkowników w ustawieniach aplikacji Zdjęcia Google, ale będzie można go edytować tylko za pomocą tego interfejsu API.

Prawidłowe nazwy wyświetlane muszą mieć od 1 do 100 znaków (włącznie).

mediaSources[]

object (AmbientMediaSource)

Tylko dane wyjściowe. Źródła multimediów skonfigurowane na tym urządzeniu.

Źródła multimediów to albumy lub kolekcje zdjęć, które użytkownik wybiera do wyświetlenia na urządzeniu.

Pamiętaj, że to pole będzie puste, jeśli użytkownik nie wybrał żadnych źródeł multimediów na tym urządzeniu (czyli mediaSourcesSet = FAŁSZ).

settingsUri

string

Tylko dane wyjściowe. Adres URI używany do przekierowania użytkownika do ustawień urządzenia w aplikacji Zdjęcia Google.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tego urządzenia.

Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

pollingConfig

object (PollingConfig)

Tylko dane wyjściowe. Zalecana konfiguracja, której aplikacje powinny używać podczas sondowania devices.get.

mediaSourcesSet

boolean

Tylko dane wyjściowe. Jeśli jest ustawiona, oznacza to, że dla tego urządzenia skonfigurowano źródła multimediów i klienci powinni mieć możliwość żądania listy multimediów dla tego urządzenia.

AmbientMediaSource

Reprezentuje źródło multimediów wybrane przez użytkownika na urządzeniu z trybem nieaktywnym.

Zapis JSON
{
  "id": string,
  "displayName": string
}
Pola
id

string

Tylko dane wyjściowe. Identyfikator źródła multimediów w tle.

displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa tego źródła multimediów.

PollingConfig

Konfiguracja pollingu interfejsu API.

Zapis JSON
{
  "pollInterval": string
}
Pola
pollInterval

string (Duration format)

Tylko dane wyjściowe. Zalecana przerwa między żądaniami głosowania

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

Metody

create

Tworzy urządzenie z tłem na koncie Google Photos użytkownika.

delete

Usuwa określone urządzenie z konta Zdjęć Google użytkownika.

get

Pobiera informacje o wybranym urządzeniu.

patch

Aktualizuje informacje o wybranym urządzeniu.