Method: devices.create

Membuat perangkat standby di akun Google Foto pengguna.

Jika perangkat dengan requestId yang diberikan sudah ada, error ALREADY_EXISTS akan ditampilkan. Untuk membantu mencegah perangkat duplikat, lakukan hal berikut:

  • Jika Anda mengetahui deviceId perangkat yang ada, panggil devices.get untuk mengambilnya.
  • Jika Anda tidak mengetahui deviceId, panggil devices.delete dengan requestId untuk menghapus perangkat yang tidak memiliki induk sebelum mencoba kembali metode ini.

Anda dapat membuat hingga 100 perangkat per pengguna aplikasi. Jika batas tersebut terlampaui, error RESOURCE_EXHAUSTED akan ditampilkan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
requestId

string

Opsional. ID unik yang diberikan klien untuk permintaan ini. Hal ini digunakan untuk mengurangi duplikasi resource jika terjadi kegagalan jaringan.

ID ini harus memiliki format string UUID (versi 4) dan mengikuti persyaratan berikut:

  • Tidak boleh berisi informasi identitas sensitif apa pun tentang pengguna.
  • Harus berisi 32 karakter heksadesimal yang dibagi menjadi lima grup yang dipisahkan dengan tanda hubung, dalam format "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (atau 8-4-4-4-12).

Isi permintaan

Isi permintaan memuat instance AmbientDevice.

Isi respons

Jika berhasil, isi respons memuat instance AmbientDevice yang baru dibuat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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