Method: devices.patch

Aktualizuje informacje o wybranym urządzeniu.

Jeśli urządzenie nie istnieje lub nie należy do użytkownika, zwracany jest błąd NOT_FOUND.

Żądanie HTTP

PATCH https://photosambient.googleapis.com/v1/devices/{deviceId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
deviceId

string

Wymagane. Unikalny identyfikator tego urządzenia.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Opcjonalnie: Lista AmbientDevice pól do zaktualizowania.

Aby na przykład zaktualizować displayName urządzenia, w polu updateMask żądania musisz podać ścieżkę do pola userSettings.displayName.

Wartość specjalna * może być używana do wskazywania, że należy zaktualizować wszystkie pola (które można zaktualizować).

Jeśli pole jest pominięte, zamiast niego zostanie użyta domyślna maska pola odpowiadająca wszystkim wypełnionym polami w polu device (czyli mającym niepustą wartość).

Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. Przykład: "user.displayName,photo".

Treść żądania

Treść żądania zawiera wystąpienie elementu AmbientDevice.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu AmbientDevice.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/photosambient.mediaitems