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

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

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

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

  1. ตรวจสอบว่าเครื่องมือการให้สิทธิ์เป็นเวอร์ชันล่าสุด โดยทำดังนี้

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

  2. ขอรับข้อมูลเข้าสู่ระบบเพื่อลงทะเบียนอุปกรณ์รุ่นใหม่ อ้างอิงไฟล์ 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://...

  3. คัดลอก 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 แทน แสดงว่าป้อนรหัสไม่ถูกต้อง ลองอีกครั้ง โดยคัดลอกและวางโค้ดทั้งหมด

  4. ค้นหา token ในการตอบกลับ JSON คัดลอกโทเค็นเพื่อการเข้าถึงนี้ (ไม่รวม เครื่องหมายอัญประกาศคู่) ลงในตัวแปรสภาพแวดล้อม

    ACCESSTOKEN=access-token

การดำเนินการตามรุ่นอุปกรณ์

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

  1. สร้างไฟล์ (เช่น device_model.json) ซึ่งอธิบายลักษณะเฉพาะ ตามรุ่นอุปกรณ์ของคุณ ดูข้อมูลอ้างอิง JSON ของรุ่นอุปกรณ์ เพื่อดูข้อมูลเพิ่มเติม

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

    ไม่ว่าจะเลือกวิธีใด เซิร์ฟเวอร์ควรแสดงผลสำเนา JSON ของรุ่นอุปกรณ์ ที่คุณส่งไป หากมีโมเดลอยู่แล้วบนเซิร์ฟเวอร์ คุณจะได้รับ ข้อผิดพลาด ALREADY_EXISTS

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

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

แสดงรายการรุ่นของอุปกรณ์

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

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

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

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

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

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

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

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

  1. สร้างไฟล์ (เช่น test_device.json) ที่ระบุอุปกรณ์ของคุณ ดูการอ้างอิงอินสแตนซ์ของอุปกรณ์ JSON เพื่อดูข้อมูลเพิ่มเติม

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

    ไม่ว่าจะเป็นวิธีการใดก็ตาม เซิร์ฟเวอร์ควรแสดงผลสำเนา JSON ของอินสแตนซ์อุปกรณ์ ที่คุณส่งไป หากมีอินสแตนซ์อยู่แล้วบนเซิร์ฟเวอร์ คุณจะได้รับ ข้อผิดพลาด ALREADY_EXISTS

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

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

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

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

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

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