Mendaftarkan Perangkat secara Manual dengan REST API

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

  1. Pastikan alat otorisasi sudah yang terbaru: 

    python -m pip install --upgrade google-auth-oauthlib[tool]

  2. 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://...

  3. 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.

  4. 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

  1. Buat file (misalnya, device_model.json) yang menjelaskan karakteristik model perangkat Anda. Lihat referensi JSON model perangkat untuk mengetahui informasi selengkapnya.

  2. 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:

    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.

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.

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.

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.

Operasi instance perangkat

Menentukan dan mendaftarkan instance perangkat

  1. Buat file (misalnya, test_device.json) yang mengidentifikasi perangkat Anda. Baca referensi JSON instance perangkat untuk mengetahui informasi lebih lanjut.

  2. 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:

    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.

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:

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: