Method: devices.create

Tworzy urządzenie z tapetą na koncie Google Photos użytkownika.

Jeśli urządzenie o podanym identyfikatorze requestId już istnieje, zwracany jest błąd ALREADY_EXISTS. Aby uniknąć duplikowania urządzeń:

  • Jeśli znasz deviceId obecnego urządzenia, zadzwoń pod numer devices.get, aby je odzyskać.
  • Jeśli nie znasz wartości deviceId, zadzwoń pod numer devices.delete, podając wartość requestId, aby usunąć urządzenie bez właściciela, zanim spróbujesz ponownie użyć tej metody.

Możesz utworzyć maksymalnie 100 urządzeń na użytkownika aplikacji. Jeśli przekroczysz ten limit, zwrócony zostanie błąd RESOURCE_EXHAUSTED.

Żądanie HTTP

POST https://photosambient.googleapis.com/v1/devices

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
requestId

string

Opcjonalnie. Unikalny identyfikator podany przez klienta dla tego żądania. Służy to ograniczeniu duplikowania zasobów w przypadku awarii sieci.

Identyfikator musi mieć format ciągu znaków UUID (wersja 4) i spełniać te wymagania:

  • Nie może zawierać żadnych poufnych informacji umożliwiających identyfikację użytkownika.
  • Musi zawierać 32 znaki szesnastkowe podzielone na 5 grup rozdzielonych myślnikami w postaci „xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” (lub 8-4-4-4-12).

Treść żądania

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

Treść odpowiedzi

Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję AmbientDevice.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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