ลงทะเบียนอุปกรณ์กับ REST API ด้วยตนเอง

หากต้องการพัฒนาอย่างรวดเร็ว คุณอาจใช้เครื่องมือลงทะเบียนที่มาพร้อม Google Assistant SDK เพื่อลงทะเบียนหรืออัปเดตรุ่นและอินสแตนซ์ของอุปกรณ์ได้อย่างรวดเร็ว

หากไม่ต้องการใช้เครื่องมือนี้ คุณจะลงทะเบียนหรืออัปเดตอุปกรณ์ด้วยตนเองได้โดยใช้ไฟล์ JSON และ REST API คุณสามารถทำได้ บนคอมพิวเตอร์เครื่องใดก็ได้ ก่อนอื่นให้รับโทเค็นเพื่อการเข้าถึง แล้วจึงข้ามไปยังส่วนที่เหมาะสม

รับโทเค็นเพื่อการเข้าถึง

ตรวจสอบว่าเครื่องมือการให้สิทธิ์เป็นเวอร์ชันล่าสุด ดังนี้
```
python -m pip install --upgrade google-auth-oauthlib[tool]
```
รับข้อมูลเข้าสู่ระบบเพื่อลงทะเบียนรุ่นอุปกรณ์ใหม่ อ้างอิงไฟล์ JSON ที่คัดลอกไปยังอุปกรณ์ในขั้นตอน ก้าว
```
google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \
      --headless --client-secrets /path/to/client_secret_client-id.json
```
คุณควรเห็น URL ปรากฏในเทอร์มินัล
```
Please visit this URL to authorize this application: https://...
```
คัดลอก URL และวางลงในเบราว์เซอร์ (ซึ่งทำบนเครื่องพัฒนาซอฟต์แวร์หรือเครื่องอื่นก็ได้) หลังจากที่คุณอนุมัติ รหัส จะปรากฏในเบราว์เซอร์ของคุณ เช่น "4/XXXX" คัดลอกและวางโค้ดนี้ ลงในเทอร์มินัล
```
Enter the authorization code:
```
หากการให้สิทธิ์สำเร็จ คุณจะเห็นการตอบสนอง JSON ที่คล้ายกับตัวอย่างต่อไปนี้
```
{
   "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"
 }
```
หากคุณเห็น UNAUTHENTICATED แทน แสดงว่ามีการป้อนรหัสที่ไม่ถูกต้อง ลองอีกครั้ง โดยคัดลอกและวางโค้ดทั้งหมด
ค้นหา token ในการตอบกลับ JSON คัดลอกโทเค็นเพื่อการเข้าถึงนี้ (ไม่รวมเครื่องหมายคำพูดคู่) ลงในตัวแปรสภาพแวดล้อม ดังนี้
```
ACCESSTOKEN=access-token
```

การดำเนินการของรุ่นอุปกรณ์

กำหนดและลงทะเบียนรุ่นอุปกรณ์

สร้างไฟล์ (เช่น device_model.json) ซึ่งอธิบายลักษณะเฉพาะ ของรุ่นอุปกรณ์ ดูการอ้างอิง JSON ของรุ่นอุปกรณ์สำหรับข้อมูลเพิ่มเติม
ลงทะเบียนรุ่นของอุปกรณ์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id ที่เชื่อมโยงกับรุ่นอุปกรณ์ใน URL ด้านล่าง
- ใช้คำสั่งต่อไปนี้
```
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/
```
- ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
  - URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
  - วิธีการ: POST
  - เนื้อความ: เนื้อหาของ device_model.json
  - ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง
ไม่ว่าจะใช้วิธีใด เซิร์ฟเวอร์ควรส่งคืนสำเนา JSON ของรุ่นอุปกรณ์ที่คุณส่ง หากโมเดลมีอยู่แล้วในเซิร์ฟเวอร์ คุณจะได้รับข้อผิดพลาด ALREADY_EXISTS

ดาวน์โหลดรุ่นอุปกรณ์

รับรุ่นอุปกรณ์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id และ device_model_id ที่เชื่อมโยงกับรุ่นอุปกรณ์ใน URL ด้านล่าง

ใช้คำสั่งต่อไปนี้

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

ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- วิธีการ: GET
- เนื้อความ: ไม่มี
- ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง

ระบุรุ่นของอุปกรณ์

แสดงรายการรุ่นอุปกรณ์ทั้งหมดสำหรับโปรเจ็กต์ที่ระบุโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id ที่เชื่อมโยงกับรุ่นอุปกรณ์ใน URL ด้านล่าง

ใช้คำสั่งต่อไปนี้

curl -s -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/

ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- วิธีการ: GET
- เนื้อความ: ไม่มี
- ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง

อัปเดตรุ่นอุปกรณ์

อัปเดตรุ่นอุปกรณ์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id และ device_model_id ที่เชื่อมโยงกับรุ่นอุปกรณ์ของคุณ

ใช้คำสั่งต่อไปนี้

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

ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- วิธีการ: PUT
- เนื้อความ: เนื้อหาของ device_model.json
- ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง

ไม่ว่าจะใช้วิธีใด เซิร์ฟเวอร์ควรส่งคืนสำเนา JSON ของรุ่นอุปกรณ์ที่อัปเดตแล้วที่คุณส่ง

ลบรุ่นอุปกรณ์

ลบรุ่นอุปกรณ์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id และ device_model_id ที่เชื่อมโยงกับรุ่นอุปกรณ์ใน URL ด้านล่าง

ใช้คำสั่งต่อไปนี้

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

ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- วิธีการ: DELETE
- เนื้อความ: ไม่มี
- ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง

การดำเนินการอินสแตนซ์ของอุปกรณ์

กำหนดและลงทะเบียนอินสแตนซ์ของอุปกรณ์

สร้างไฟล์ (เช่น test_device.json) ที่ระบุอุปกรณ์ของคุณ ดูการอ้างอิง JSON ของอินสแตนซ์อุปกรณ์สำหรับข้อมูลเพิ่มเติม
ลงทะเบียนอุปกรณ์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id ที่เชื่อมโยงกับรุ่นอุปกรณ์ใน URL ด้านล่าง
- ใช้คำสั่งต่อไปนี้
```
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/
```
- ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
  - URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
  - วิธีการ: POST
  - เนื้อความ: เนื้อหาของ test_device.json
  - ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง
ไม่ว่าจะใช้วิธีใด เซิร์ฟเวอร์ควรส่งคืนสำเนา JSON ของอินสแตนซ์อุปกรณ์ที่คุณส่ง หากมีอินสแตนซ์อยู่แล้วในเซิร์ฟเวอร์ คุณจะได้รับข้อผิดพลาด ALREADY_EXISTS

รับอินสแตนซ์ของอุปกรณ์

รับอินสแตนซ์ของอุปกรณ์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id ที่เชื่อมโยงกับรุ่นอุปกรณ์และอุปกรณ์ id ใน URL ด้านล่าง

ใช้คำสั่งต่อไปนี้

curl -s -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id

ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- วิธีการ: GET
- เนื้อความ: ไม่มี
- ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง

แสดงรายการอินสแตนซ์ของอุปกรณ์

แสดงรายการอินสแตนซ์อุปกรณ์ทั้งหมดสำหรับโปรเจ็กต์ที่ระบุโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมใช้ project_id ที่เชื่อมโยงกับอินสแตนซ์ของอุปกรณ์ใน URL ด้านล่างแทน

ใช้คำสั่งต่อไปนี้

curl -s -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/

ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- วิธีการ: GET
- เนื้อความ: ไม่มี
- ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง

ลบอินสแตนซ์ของอุปกรณ์

ลบอินสแตนซ์ของอุปกรณ์โดยใช้วิธีใดวิธีหนึ่งต่อไปนี้ อย่าลืมแทนที่ project_id ที่เชื่อมโยงกับรุ่นอุปกรณ์และอุปกรณ์ id ใน URL ด้านล่าง

ใช้คำสั่งต่อไปนี้

curl -s -X DELETE -H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESSTOKEN" \
https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id

ส่งคำขอ HTTPS ที่มีแอตทริบิวต์ต่อไปนี้
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- วิธีการ: DELETE
- เนื้อความ: ไม่มี
- ส่วนหัว: Authorization: Bearer <access-token> โดยที่ <access-token> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง