การ์ดบัญชี
ฝังการ์ดผู้ใช้ที่แสดงผู้ที่ลงชื่อเข้าใช้ พร้อมปุ่มจัดการบัญชี ช่วยเหลือ และออกจากระบบ แล้วรับเหตุการณ์ที่หน้าของคุณต้องจัดการ
widget account แสดงการ์ดของผู้ใช้ที่ token หรือ API key เป็นของ คือรูป ชื่อ และอีเมล พร้อมปุ่ม จัดการบัญชีของคุณ ช่วยเหลือ และ ออกจากระบบ เมื่อผู้ใช้กดปุ่มแรกและปุ่มสุดท้าย widget ส่งข้อความถึงหน้าของคุณ ส่วนปุ่ม ช่วยเหลือ ทำงานเอง
URL และพารามิเตอร์
พารามิเตอร์ที่ขึ้นต้นด้วย _ ที่ไม่ใช่สองตัวล่างนี้เหมือนกันทุก widget ดู Widgets
| พารามิเตอร์ | ความหมาย | จำเป็น |
|---|---|---|
_app | id ของแอปที่แสดงการ์ด เช่น drive ปุ่ม ช่วยเหลือ เปิดคู่มือของแอปนั้น | ไม่ |
_release | เวอร์ชันที่แอปนั้นรัน เช่น 5.0.3 ปุ่ม ช่วยเหลือ เปิดคู่มือของเวอร์ชันนี้ | ไม่ |
ถ้าไม่ส่ง _app และ _release ปุ่ม ช่วยเหลือ เปิดหน้าแรกของคู่มือเวอร์ชันของแพลตฟอร์ม
ข้อความ
widget นี้ไม่ส่ง ready และไม่รับ post-widget-parameters ข้อความทั่วไปที่เหลือดู Widgets
| action | ทิศทาง | payload |
|---|---|---|
view-account | widget ถึงหน้าของคุณ | รายการของแอป Account จากรายการแอปของแพลตฟอร์ม ใช้ url ของมันพาผู้ใช้ไปที่ Account |
sign-out | widget ถึงหน้าของคุณ | ไม่มี |
widget ไม่ออกจากระบบและไม่เปลี่ยนหน้าเอง เมื่อได้ sign-out หน้าของคุณต้องล้าง token และพาผู้ใช้ออกไปเอง
ปุ่ม ช่วยเหลือ เป็นลิงก์ที่เปิดแท็บใหม่ และไม่ส่งข้อความ
ตัวอย่าง
const messageToken = crypto.randomUUID()
const params = new URLSearchParams({
_credential_type: 'bearer-token',
_token: token,
_origin: location.origin,
_message_token: messageToken,
_locale: 'th',
_app: 'my-app',
_release: '5.0.3',
})
frame.src = `${site}/widgets/account?${params}`
addEventListener('message', (e) => {
if (e.origin !== site || e.data.messageToken !== messageToken) return
if (e.data.action === 'view-account') window.open(e.data.payload.url, '_blank')
if (e.data.action === 'sign-out') signOut() // ล้าง token ของคุณเอง
})