ภาพรวม

Google Health API เป็น API ใหม่ที่สร้างขึ้นตั้งแต่ต้นเพื่อให้ผู้พัฒนา ค้นหาข้อมูลผู้ใช้ Fitbit ได้ ไม่ใช่แค่การอัปเดต แต่เป็นการเคลื่อนไหวเชิงกลยุทธ์ เพื่อให้มั่นใจว่าแอปของคุณปลอดภัย เชื่อถือได้ และพร้อมรับ ความก้าวหน้าด้านเทคโนโลยีสุขภาพในอนาคต API รองรับคอนโซลใหม่สำหรับ การลงทะเบียนแอป การรองรับ Google OAuth 2.0 ประเภทข้อมูลใหม่ สคีมาของปลายทางใหม่ และรูปแบบการตอบกลับใหม่

คู่มือนี้ออกแบบมาเพื่อช่วยให้นักพัฒนาแอปย้ายข้อมูลแอป Fitbit Web API ที่มีอยู่ไปยัง Google Health API ใหม่

เหตุผลที่ควรย้ายข้อมูล

ประโยชน์ของการใช้ Google Health API มีดังนี้

• ความปลอดภัยที่ดียิ่งขึ้น: การปฏิบัติตามแนวทางปฏิบัติแนะนำด้านความปลอดภัยของ Google การปฏิบัติตามมาตรฐานด้านความปลอดภัย ความเป็นส่วนตัว และข้อมูลประจำตัวของ Google
• ความสอดคล้อง: ขจัดความไม่สอดคล้องเดิมในรูปแบบข้อมูล เขตเวลา หน่วยวัด และการจัดการข้อผิดพลาด เพื่อให้ประสบการณ์การใช้งานของนักพัฒนาซอฟต์แวร์เป็นไปอย่างราบรื่นยิ่งขึ้น
• ความสามารถในการปรับขนาดและการเตรียมพร้อมสำหรับอนาคต: ออกแบบมาเพื่อปรับขนาดให้ตรงกับความต้องการในอนาคต และรองรับโปรโตคอลที่ทันสมัย เช่น gRPC

ย้ายข้อมูลผู้ใช้

การย้ายข้อมูลจาก Fitbit Web API ไปยัง Google Health API ไม่ใช่แค่การอัปเดตทางเทคนิค ผู้ใช้ต้องให้ความยินยอมอีกครั้งสำหรับการผสานรวมใหม่เนื่องจากมีการเปลี่ยนแปลงไลบรารี OAuth โทเค็นเพื่อการเข้าถึงและโทเค็นการรีเฟรชจะโอนไปยัง Google Health API และใช้งานไม่ได้ เพื่อช่วยรักษาผู้ใช้ไว้ในระหว่างการย้ายข้อมูล เรามีคำแนะนำทางเทคนิคและเชิงกลยุทธ์บางอย่างสำหรับการย้ายข้อมูลที่ประสบความสำเร็จ

กลยุทธ์ห้องสมุดคู่

เนื่องจาก Fitbit Web API และ Google Health API ใช้ไลบรารี OAuth2 ที่แตกต่างกัน คุณจึงต้องจัดการช่วง "การบริดจ์" ที่ทั้ง 2 ไลบรารีมีอยู่ในฐานของโค้ด

การจัดการการให้สิทธิ์แบบคู่ขนาน

• แคปซูลไคลเอ็นต์: สร้างเลเยอร์หรืออินเทอร์เฟซการแยกข้อมูลสำหรับ "บริการด้านสุขภาพ" ซึ่งจะช่วยให้ส่วนอื่นๆ ของแอปขอข้อมูลได้ โดยไม่ต้องทราบว่าไลบรารีใด (Fitbit OAuth กับ Google OAuth) ที่ ใช้งานอยู่สำหรับผู้ใช้รายนั้นๆ
• การอัปเดตสคีมาฐานข้อมูล: อัปเดตตารางผู้ใช้ให้มีแฟล็ก oauth_type เช่น ใช้ fitbit สำหรับ Fitbit OAuth และ google สำหรับ Google OAuth
  • ผู้ใช้ใหม่: ใช้ Google Health API และไลบรารี Google OAuth โดยค่าเริ่มต้น ตั้งค่า oauth_type เป็น google
  • ผู้ใช้เดิม: ใช้ Fitbit Web API ต่อไปจนกว่าผู้ใช้จะทำตาม ขั้นตอนการขอความยินยอมใหม่อย่างสมบูรณ์ ตั้งค่า oauth_type เป็น fitbit

ขั้นตอนการขอความยินยอมอีกครั้งแบบ "Step-Up"

แทนที่จะบังคับให้ออกจากระบบ ให้ใช้แนวทางการให้สิทธิ์แบบเพิ่มทีละรายการ

1. ตรวจหาโทเค็นโอเพนซอร์สของ Fitbit: เมื่อผู้ใช้ Fitbit Web API เปิดแอป ให้ทริกเกอร์การแจ้งเตือน "การอัปเดตบริการ"
2. เปิดใช้ขั้นตอนของ Google OAuth: เมื่อผู้ใช้คลิก "อัปเดต" ให้เริ่มขั้นตอนของไลบรารี OAuth2 ของ Google
3. แทนที่และเพิกถอน: เมื่อได้รับโทเค็น Google OAuth เรียบร้อยแล้ว ให้บันทึกลงในโปรไฟล์ผู้ใช้ อัปเดต oauth_type จาก fitbit เป็น google และเพิกถอนโทเค็น fitbit เก่าโดยอัตโนมัติ (หากเป็นไปได้) เพื่อให้โปรไฟล์ความปลอดภัยของผู้ใช้สะอาดอยู่เสมอ

เพิ่มการคงผู้ใช้ไว้ให้ได้สูงสุด

การขอความยินยอมอีกครั้งถือเป็น "จุดอันตราย" ที่ทำให้เกิดการเลิกใช้งาน เพื่อป้องกันไม่ให้ผู้ใช้ทิ้งแอป โปรดปฏิบัติตามแนวทางปฏิบัติแนะนำด้าน UX ดังนี้

การสื่อสารแบบ "เน้นคุณค่าเป็นอันดับแรก"

อย่าขึ้นต้นด้วย "เราได้อัปเดต API" แต่ให้ขึ้นต้นด้วยประโยชน์ของระบบใหม่ที่ Google สนับสนุน ดังนี้

• การรักษาความปลอดภัยที่ดียิ่งขึ้น: กล่าวถึงการปกป้องบัญชีและ 2FA ที่เป็นผู้นำในอุตสาหกรรมของ Google
• ความน่าเชื่อถือ: เวลาในการซิงค์เร็วขึ้นและการเชื่อมต่อข้อมูลที่เสถียรมากขึ้น
• การจำกัดการเข้าถึงฟีเจอร์: แจ้งให้ผู้ใช้ทราบว่าฟีเจอร์ใหม่และ ประเภทข้อมูลใหม่ต้องมีการอัปเดต

การกำหนดเวลาอัจฉริยะ

• อย่าขัดจังหวะงานที่มีคุณค่าสูง: อย่าทริกเกอร์หน้าจอขอความยินยอมอีกครั้ง ขณะที่ผู้ใช้กำลังออกกำลังกายหรือบันทึกอาหาร
• ระยะ "กระตุ้น": ใช้แบนเนอร์ที่ปิดได้ในช่วง 30 วันแรก
• ระยะ "การหยุดให้บริการอย่างถาวร": บังคับให้ขอความยินยอมอีกครั้งหลังจากได้รับคำเตือนเป็นเวลาหลายสัปดาห์ ซึ่งตรงกับกำหนดเวลาการเลิกใช้งาน Fitbit Web API อย่างเป็นทางการ

การเปรียบเทียบขั้นตอนการย้ายข้อมูล

ความแตกต่างที่ชัดเจนระหว่างโฟลว์เก่าและโฟลว์ใหม่จะช่วยให้ นักพัฒนาแอปเข้าใจว่าตรรกะแยกออกเป็น 2 ทางตรงจุดใด

ฟีเจอร์	Fitbit Web API (เดิม)	Google Health API (Google-Identity)
ไลบรารีการตรวจสอบสิทธิ์	โอเพนซอร์สมาตรฐาน	Google Identity Services (GIS) / Google Auth
บัญชีผู้ใช้	ข้อมูลเข้าสู่ระบบเดิมของ Fitbit	บัญชี Google
ประเภทโทเค็น	การเข้าถึง / การรีเฟรชเฉพาะ Fitbit	โทเค็นเพื่อการเข้าถึง/โทเค็นการรีเฟรชที่ Google ออกให้
การจัดการขอบเขต	สิทธิ์แบบกว้าง	สิทธิ์แบบละเอียด / แบบเพิ่ม

จัดการความแตกต่างของการย้ายข้อมูลบัญชี

ตามเอกสารประกอบของ Fitbit ผู้ใช้ที่ย้ายข้อมูลบัญชีไปยัง Google มักจะไม่สูญเสียการเชื่อมต่อกับบุคคลที่สามในทันที แต่การเปลี่ยนเวอร์ชัน API เป็นข้อกำหนดฝั่งนักพัฒนาแอป

• ตรวจสอบความถูกต้องของโทเค็น: ใช้ Backgroundworker เพื่อตรวจสอบว่าโทเค็น Fitbit ล้มเหลวเนื่องจากข้อผิดพลาด "ไม่ได้รับอนุญาต" หรือไม่ ซึ่งอาจบ่งชี้ว่าผู้ใช้ได้ย้ายข้อมูลบัญชีแล้ว แต่แอปของคุณยังไม่ได้อัปเดต
• การทำงานล้มเหลวอย่างราบรื่น: หากการเรียกใช้ Fitbit OAuth ล้มเหลว ให้เปลี่ยนเส้นทางผู้ใช้ ไปยังหน้า "เชื่อมต่อ Fitbit อีกครั้ง" ที่กำหนดเองซึ่งใช้โฟลว์ Google OAuth ใหม่โดยเฉพาะ