Untuk pengembangan cepat, Anda dapat menggunakan alat pendaftaran yang disediakan bersama SDK Asisten Google untuk mendaftarkan atau mengupdate model dan instance perangkat dengan cepat.
Jika tidak ingin menggunakan alat ini, Anda dapat mendaftarkan atau mengupdate perangkat secara manual menggunakan file JSON dan REST API. Anda dapat melakukan ini di komputer mana pun. Pertama-tama, dapatkan token akses, lalu lanjutkan ke bagian yang sesuai.
Mendapatkan token akses
Pastikan alat otorisasi sudah yang terbaru:
python -m pip install --upgrade google-auth-oauthlib[tool]
Mendapatkan kredensial agar dapat mendaftarkan model perangkat baru. Referensikan file JSON yang Anda salin ke perangkat di langkah langkah.
google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \ --headless --client-secrets /path/to/client_secret_client-id.json
Anda akan melihat URL yang ditampilkan di terminal:
Please visit this URL to authorize this application: https://...
Salin URL dan tempelkan ke browser (ini dapat dilakukan di mesin pengembangan, atau mesin lainnya). Setelah Anda menyetujuinya, kode akan muncul di browser, seperti "4/XXXX". Salin dan tempel kode ini ke terminal:
Enter the authorization code:
Jika otorisasi berhasil, Anda akan melihat respons JSON yang mirip dengan yang berikut ini:
{ "scopes": ["https://www.googleapis.com/auth/assistant-sdk-prototype"], "token_uri": "https://accounts.google.com/o/oauth2/token", "token": "ya29.GlujBLa_kuXZ5GnGBPBe_A6NpczLcpOtglEC0wHVORnmEhHETzlSW", "client_id": "795595571889-6iesr9a3nkmnipbdfnqi6gehiklm2m28.apps.googleusercontent.com", "client_secret": "Un8_TNFnb55555auSAGasvAg", "refresh_token": "1/4ZMBhTR3bTYWVEMatYWLOxW755555hlQXZI5uC02F2U" }
Jika Anda melihat
UNAUTHENTICATED
, berarti kode yang tidak valid telah dimasukkan. Coba lagi, pastikan untuk menyalin dan menempelkan seluruh kode.Temukan
token
dalam respons JSON. Salin token akses ini (tidak termasuk tanda kutip ganda) ke variabel lingkungan:ACCESSTOKEN=access-token
Operasi model perangkat
Menentukan dan mendaftarkan model perangkat
Buat file (misalnya,
device_model.json
) yang menjelaskan karakteristik model perangkat Anda. Lihat referensi JSON model perangkat untuk mengetahui informasi selengkapnya.Daftarkan model perangkat Anda menggunakan salah satu metode berikut. Jangan lupa mengganti
project_id
yang terkait dengan model perangkat dalam URL di bawah.Gunakan perintah berikut:
curl -s -X POST -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- Metode:
POST
- Body: Konten
device_model.json
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Untuk kedua metode tersebut, server harus menampilkan salinan JSON model perangkat yang Anda kirim. Jika model sudah ada di server, Anda akan menerima error
ALREADY_EXISTS
.
Mendapatkan model perangkat
Dapatkan model perangkat menggunakan salah satu metode berikut. Jangan lupa
mengganti project_id
dan device_model_id
yang terkait dengan model perangkat Anda dalam URL di bawah.
Gunakan perintah berikut:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- Metode:
GET
- Isi: Tidak ada
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Mencantumkan model perangkat
Tampilkan daftar semua model perangkat Anda untuk project tertentu menggunakan salah satu metode berikut. Jangan lupa
mengganti project_id
yang terkait dengan model perangkat Anda dalam URL di bawah.
Gunakan perintah berikut:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- Metode:
GET
- Isi: Tidak ada
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Mengupdate model perangkat
Update model perangkat menggunakan salah satu metode berikut. Jangan lupa
mengganti project_id
dan device_model_id
yang terkait dengan model perangkat Anda.
Gunakan perintah berikut:
curl -s -X PUT -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- Metode:
PUT
- Body: Konten
device_model.json
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Untuk kedua metode tersebut, server harus menampilkan salinan JSON model perangkat yang telah diupdate, yang Anda kirim.
Menghapus model perangkat
Menghapus model perangkat menggunakan salah satu metode berikut. Jangan lupa
mengganti project_id
dan device_model_id
yang terkait dengan model perangkat Anda dalam URL di bawah.
Gunakan perintah berikut:
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- Metode:
DELETE
- Isi: Tidak ada
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Operasi instance perangkat
Menentukan dan mendaftarkan instance perangkat
Buat file (misalnya,
test_device.json
) yang mengidentifikasi perangkat Anda. Baca referensi JSON instance perangkat untuk mengetahui informasi lebih lanjut.Daftarkan perangkat Anda menggunakan salah satu metode berikut. Jangan lupa mengganti
project_id
yang terkait dengan model perangkat dalam URL di bawah.Gunakan perintah berikut:
curl -s -X POST -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @test_device.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- Metode:
POST
- Body: Konten
test_device.json
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Untuk kedua metode tersebut, server harus menampilkan salinan JSON instance perangkat yang Anda kirim. Jika instance sudah ada di server, Anda akan menerima error
ALREADY_EXISTS
.
Mendapatkan instance perangkat
Dapatkan instance perangkat Anda menggunakan salah satu metode berikut. Jangan lupa
mengganti project_id
yang terkait dengan model perangkat dan perangkat id
pada URL di bawah.
Gunakan perintah berikut:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- Metode:
GET
- Isi: Tidak ada
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Mencantumkan instance perangkat
Tampilkan daftar semua instance perangkat untuk project tertentu menggunakan salah satu
metode berikut. Jangan lupa mengganti project_id
yang terkait dengan instance perangkat pada URL di bawah.
Gunakan perintah berikut:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- Metode:
GET
- Isi: Tidak ada
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses
Menghapus instance perangkat
Hapus instance perangkat Anda menggunakan salah satu metode berikut. Jangan lupa
mengganti project_id
yang terkait dengan model perangkat dan perangkat id
pada URL di bawah.
Gunakan perintah berikut:
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
Kirim permintaan HTTPS dengan atribut berikut:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- Metode:
DELETE
- Isi: Tidak ada
- Header:
Authorization: Bearer <access-token>
dengan <access-token> adalah string yang berisi token akses