ใช้เครื่องมือการลงทะเบียนเพื่อการพัฒนาอย่างรวดเร็ว ซึ่งได้รับมาพร้อมกับ 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> เป็นสตริงที่มีโทเค็นเพื่อการเข้าถึง