ลงทะเบียนอุปกรณ์กับ 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> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง