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

หน้านี้ได้รับการแปลโดย Cloud Translation API

ลงชื่อเข้าใช้ด้วยเอกสารอ้างอิง Google JavaScript API

หน้าข้อมูลอ้างอิงนี้อธิบาย Sign-In JavaScript API คุณสามารถใช้ API นี้เพื่อแสดงข้อความแจ้งแบบแตะครั้งเดียวหรือปุ่มลงชื่อเข้าใช้ด้วย Google ในหน้าเว็บ

เมธอด: google.accounts.id.initialize

เมธอด google.accounts.id.initialize จะเริ่มต้นคลีเอนต์การลงชื่อเข้าใช้ด้วย Google ตามออบเจ็กต์การกําหนดค่า ดูตัวอย่างโค้ดของวิธีต่อไปนี้

google.accounts.id.initialize(IdConfiguration)

ตัวอย่างโค้ดต่อไปนี้ใช้เมธอด google.accounts.id.initialize กับฟังก์ชัน onload

<script>
  window.onload = function () {
    google.accounts.id.initialize({
      client_id: 'YOUR_GOOGLE_CLIENT_ID',
      callback: handleCredentialResponse
    });
    google.accounts.id.prompt();
  };
</script>

เมธอด google.accounts.id.initialize จะสร้างอินสแตนซ์ไคลเอ็นต์ของฟีเจอร์ลงชื่อเข้าใช้ด้วย Google ที่โมดูลทั้งหมดในหน้าเว็บเดียวกันสามารถใช้โดยนัย

คุณเพียงต้องเรียกใช้เมธอด google.accounts.id.initialize เพียงครั้งเดียว แม้ว่าจะใช้โมดูลหลายรายการ (เช่น One Tap, ปุ่มที่ปรับเปลี่ยนในแบบของคุณ, การเพิกถอน ฯลฯ) ในหน้าเว็บเดียวกันก็ตาม
หากคุณเรียกใช้เมธอด google.accounts.id.initialize หลายครั้ง ระบบจะจดจำและใช้เฉพาะการกําหนดค่าในการเรียกใช้ครั้งล่าสุด

คุณรีเซ็ตการกําหนดค่าทุกครั้งที่เรียกใช้เมธอด google.accounts.id.initialize และเมธอดต่อๆ ไปทั้งหมดในหน้าเว็บเดียวกันจะใช้การกําหนดค่าใหม่ทันที

ประเภทข้อมูล: IdConfiguration

ตารางต่อไปนี้แสดงช่องและคําอธิบายของIdConfigurationประเภทข้อมูล

ช่อง
`client_id`	รหัสไคลเอ็นต์ของแอปพลิเคชัน
`auto_select`	เปิดใช้การเลือกอัตโนมัติ
`callback`	ฟังก์ชัน JavaScript ที่จัดการโทเค็นระบุตัวตน Google One Tap และปุ่มลงชื่อเข้าใช้ด้วย Google `popup` โหมด UX ใช้แอตทริบิวต์นี้
`login_uri`	URL ของปลายทางการเข้าสู่ระบบ ปุ่มลงชื่อเข้าใช้ด้วย Google `redirect` โหมด UX ใช้แอตทริบิวต์นี้
`native_callback`	ฟังก์ชัน JavaScript ที่จัดการข้อมูลเข้าสู่ระบบของรหัสผ่าน
`cancel_on_tap_outside`	ยกเลิกพรอมต์หากผู้ใช้คลิกนอกพรอมต์
`prompt_parent_id`	รหัส DOM ขององค์ประกอบคอนเทนเนอร์พรอมต์การชำระเงินแบบไม่ต้องสัมผัส
`nonce`	สตริงแบบสุ่มสําหรับโทเค็นระบุตัวตน
`context`	ชื่อและคำในข้อความแจ้งแบบ One Tap
`state_cookie_domain`	หากต้องการเรียกใช้ One Tap ในโดเมนหลักและโดเมนย่อย ให้ส่งโดเมนหลักไปยังช่องนี้เพื่อให้ระบบใช้คุกกี้ที่แชร์รายการเดียว
`ux_mode`	ขั้นตอน UX ของปุ่มลงชื่อเข้าใช้ด้วย Google
`allowed_parent_origin`	ต้นทางที่ได้รับอนุญาตให้ฝัง iframe ระดับกลาง One Tap จะทำงานในโหมด iframe ระดับกลางหากมีฟิลด์นี้
`intermediate_iframe_close_callback`	ลบล้างลักษณะการทำงานเริ่มต้นของ iframe ระดับกลางเมื่อผู้ใช้ปิด One Tap ด้วยตนเอง
`itp_support`	เปิดใช้ UX แบบแตะครั้งเดียวที่อัปเกรดแล้วในเบราว์เซอร์ ITP
`login_hint`	ข้ามการเลือกบัญชีโดยระบุคำแนะนำผู้ใช้
`hd`	จำกัดการเลือกบัญชีตามโดเมน
`use_fedcm_for_prompt`	อนุญาตให้เบราว์เซอร์ควบคุมข้อความแจ้งให้ผู้ใช้ลงชื่อเข้าใช้และสื่อกลางขั้นตอนการลงชื่อเข้าใช้ระหว่างเว็บไซต์กับ Google
`enable_redirect_uri_validation`	เปิดใช้โฟลว์การเปลี่ยนเส้นทางของปุ่มที่เป็นไปตามกฎการตรวจสอบ URI การเปลี่ยนเส้นทาง

client_id

ช่องนี้คือรหัสไคลเอ็นต์ของแอปพลิเคชัน ซึ่งจะดูและสร้างได้ในคอนโซล Google Cloud ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ใช่	`client_id: "CLIENT_ID.apps.googleusercontent.com"`

auto_select

ช่องนี้จะกำหนดว่าระบบจะแสดงโทเค็นระบุตัวตนโดยอัตโนมัติโดยที่ผู้ใช้ไม่ต้องดำเนินการใดๆ หรือไม่เมื่อมีเซสชัน Google เพียงเซสชันเดียวที่อนุมัติแอปของคุณก่อนหน้านี้ ค่าเริ่มต้นคือ false ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
บูลีน	ไม่บังคับ	`auto_select: true`

Callback

ช่องนี้เป็นฟังก์ชัน JavaScript ที่จัดการโทเค็นระบุตัวตนที่แสดงผลจากพรอมต์การแตะครั้งเดียวหรือหน้าต่างป๊อปอัป ต้องระบุแอตทริบิวต์นี้หากใช้โหมด UX ของ Google popup One Tap หรือปุ่มลงชื่อเข้าใช้ด้วย Google ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
ฟังก์ชัน	ต้องระบุสำหรับ One Tap และ`popup`โหมด UX	`callback: handleResponse`

login_uri

แอตทริบิวต์นี้เป็น URI ของปลายทางการเข้าสู่ระบบ

ค่าต้องตรงกับ URI การเปลี่ยนเส้นทางที่ได้รับอนุญาตรายการใดรายการหนึ่งสำหรับไคลเอ็นต์ OAuth 2.0 ที่คุณกําหนดค่าในคอนโซล Google Cloud และต้องเป็นไปตามกฎการตรวจสอบ URI การเปลี่ยนเส้นทาง

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

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

ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ไม่บังคับ	ตัวอย่าง
URL	ค่าเริ่มต้นคือ URI ของหน้าปัจจุบันหรือค่าที่คุณระบุ ใช้เฉพาะเมื่อมีการตั้งค่า `ux_mode: "redirect"`	`login_uri: "https://www.example.com/login"`

ปลายทางการเข้าสู่ระบบต้องจัดการคําขอ POST ที่มีคีย์ credential ที่มีค่าโทเค็นรหัสในส่วนเนื้อหา

ต่อไปนี้เป็นตัวอย่างคำขอไปยังปลายทางการเข้าสู่ระบบ

POST /login HTTP/1.1
Host: www.example.com
Content-Type: application/x-www-form-urlencoded

credential=ID_TOKEN

โดยอัตโนมัติ

native_callback

ช่องนี้เป็นชื่อของฟังก์ชัน JavaScript ที่จัดการข้อมูลเข้าสู่ระบบที่เป็นรหัสผ่านซึ่งแสดงผลจากเครื่องมือจัดการข้อมูลเข้าสู่ระบบในตัวของเบราว์เซอร์ ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
ฟังก์ชัน	ไม่บังคับ	`native_callback: handleResponse`

cancel_on_tap_outside

ฟิลด์นี้จะตั้งค่าว่าจะยกเลิกคำขอการชำระเงินแบบไม่ต้องสัมผัสหรือไม่หากผู้ใช้คลิกนอกพรอมต์ ค่าเริ่มต้นคือ true คุณสามารถปิดใช้ได้โดยตั้งค่าเป็น false ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
บูลีน	ไม่บังคับ	`cancel_on_tap_outside: false`

prompt_parent_id

แอตทริบิวต์นี้จะตั้งค่ารหัส DOM ขององค์ประกอบคอนเทนเนอร์ หากไม่ได้ตั้งค่าไว้ ระบบจะแสดงข้อความแจ้ง "แตะครั้งเดียว" ที่มุมขวาบนของหน้าต่าง ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`prompt_parent_id: 'parent_id'`

ค่าที่ได้จากการสุ่ม

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

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`nonce: "biaqbm70g23"`

ความยาวของ Nonce จะจำกัดตามขนาด JWT สูงสุดที่สภาพแวดล้อมของคุณรองรับ และข้อจำกัดขนาด HTTP ของเบราว์เซอร์และเซิร์ฟเวอร์แต่ละรายการ

บริบท

ช่องนี้จะเปลี่ยนข้อความของชื่อและข้อความในพรอมต์การแตะครั้งเดียว ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`context: "use"`

ตารางต่อไปนี้แสดงบริบททั้งหมดที่ใช้ได้และคําอธิบาย

บริบท
`signin`	"ลงชื่อเข้าใช้ด้วย Google"
`signup`	"ลงชื่อสมัครใช้ด้วย Google"
`use`	"ใช้กับ Google"

state_cookie_domain

หากต้องการแสดง One Tap ในโดเมนหลักและโดเมนย่อย ให้ส่งโดเมนหลักไปยังช่องนี้เพื่อให้ระบบใช้คุกกี้สถานะที่ใช้ร่วมกันรายการเดียว ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`state_cookie_domain: "example.com"`

ux_mode

ใช้ช่องนี้เพื่อตั้งค่าขั้นตอน UX ที่ปุ่มลงชื่อเข้าใช้ด้วย Google ใช้ ค่าเริ่มต้นคือ popup แอตทริบิวต์นี้ไม่มีผลต่อ UX ของ OneTap ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`ux_mode: "redirect"`

ตารางต่อไปนี้แสดงโหมด UX ที่มีและคำอธิบาย

โหมด UX
`popup`	ดำเนินการตามโฟลว์ UX การลงชื่อเข้าใช้ในหน้าต่างป๊อปอัป
`redirect`	ดำเนินการตามขั้นตอนการลงชื่อเข้าใช้ UX ด้วยการเปลี่ยนเส้นทางทั้งหน้า

allowed_parent_origin

ต้นทางที่ได้รับอนุญาตให้ฝัง iframe ระดับกลาง One Tap จะทํางานในโหมด iframe ระดับกลางหากมีช่องนี้ ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริงหรืออาร์เรย์สตริง	ไม่บังคับ	`allowed_parent_origin: "https://example.com"`

ตารางต่อไปนี้แสดงประเภทค่าที่รองรับและคําอธิบาย

ประเภทค่า
`string`	URI ของโดเมนเดียว	`"https://example.com"`
`string array`	อาร์เรย์ของ URI ของโดเมน	`["https://news.example.com", "https://local.example.com"]`

นอกจากนี้ ระบบยังรองรับคำนำหน้าไวลด์การ์ดด้วย เช่น "https://*.example.com" จะตรงกับ example.com และโดเมนย่อยของ example.com ทุกระดับ (เช่น news.example.com, login.news.example.com) สิ่งที่ควรทราบเมื่อใช้ไวลด์การ์ด

สตริงรูปแบบต้องประกอบด้วยไวลด์การ์ดและโดเมนระดับบนสุดเท่านั้น เช่น https://.com และ https://.co.uk ไม่ถูกต้อง ดังที่ระบุไว้ข้างต้น "https://.example.com" จะตรงกับ example.com และโดเมนย่อยของ example.com นอกจากนี้ คุณยังใช้อาร์เรย์เพื่อแสดงโดเมน 2 โดเมนที่แตกต่างกันได้ด้วย เช่น ["https://example1.com", "https://.example2.com"] จะตรงกับโดเมน example1.com, example2.com และโดเมนย่อยของ example2.com
โดเมนไวลด์การ์ดต้องขึ้นต้นด้วยชุดรูปแบบ https:// ที่ปลอดภัย ระบบจึงจะถือว่า "*.example.com" ไม่ถูกต้อง

หากค่าของฟิลด์ allowed_parent_origin ไม่ถูกต้อง การเปิดใช้งานโหมด iframe กลางของการชำระเงินแบบไม่ต้องสัมผัสจะดำเนินการไม่สำเร็จและหยุดลง

intermediate_iframe_close_callback

ลบล้างลักษณะการทำงานเริ่มต้นของ iframe ระดับกลางเมื่อผู้ใช้ปิด One Tap ด้วยตนเองโดยการแตะปุ่ม "X" ใน UI ของ One Tap ลักษณะการทำงานเริ่มต้นคือการนำ iframe ระดับกลางออกจาก DOM ทันที

ช่อง intermediate_iframe_close_callback จะมีผลเฉพาะในโหมด iframe ระดับกลางเท่านั้น และจะมีผลกับ iframe ระดับกลางเท่านั้น ไม่ใช่ iframe ของ One Tap ระบบจะนำ UI ของ One Tap ออกก่อนที่จะเรียกใช้การติดต่อกลับ

ประเภท	ต้องระบุ	ตัวอย่าง
ฟังก์ชัน	ไม่บังคับ	`intermediate_iframe_close_callback: logBeforeClose`

itp_support

ช่องนี้จะกำหนดว่าควรเปิดใช้ UX การแตะครั้งเดียวที่อัปเกรดแล้วในเบราว์เซอร์ที่รองรับ Intelligent Tracking Prevention (ITP) หรือไม่ ค่าเริ่มต้นคือ false ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
บูลีน	ไม่บังคับ	`itp_support: true`

login_hint

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

ดูข้อมูลเพิ่มเติมได้ที่ช่อง login_hint ในเอกสารประกอบของ OpenID Connect

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง อีเมล หรือค่าจากช่อง`sub`โทเค็นระบุตัวตน	ไม่บังคับ	`login_hint: 'elisa.beckett@gmail.com'`

HD

เมื่อผู้ใช้มีหลายบัญชีและควรลงชื่อเข้าใช้ด้วยบัญชี Workspace เท่านั้น ให้ใช้แอตทริบิวต์นี้เพื่อระบุคำแนะนำชื่อโดเมนแก่ Google เมื่อดำเนินการเสร็จสิ้นแล้ว บัญชีผู้ใช้ที่แสดงระหว่างการเลือกบัญชีจะจำกัดอยู่ในโดเมนที่ระบุ ค่าไวลด์การ์ด: * เสนอเฉพาะบัญชี Workspace ให้แก่ผู้ใช้และยกเว้นบัญชีผู้ใช้ทั่วไป (user@gmail.com) ในระหว่างการเลือกบัญชี

ดูข้อมูลเพิ่มเติมได้ที่ช่อง hd ในเอกสารประกอบของ OpenID Connect

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง ชื่อโดเมนที่สมบูรณ์ในตัวเองหรือ *	ไม่บังคับ	`hd: '*'`

use_fedcm_for_prompt

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

ประเภท	ต้องระบุ	ตัวอย่าง
บูลีน	ไม่บังคับ	`use_fedcm_for_prompt: true`

enable_redirect_uri_validation

เปิดใช้โฟลว์การเปลี่ยนเส้นทางของปุ่มที่เป็นไปตามกฎการตรวจสอบ URI การเปลี่ยนเส้นทาง

ประเภท	ต้องระบุ	ตัวอย่าง
บูลีน	ไม่บังคับ	`enable_redirect_uri_validation: true`

เมธอด: google.accounts.id.prompt

เมธอด google.accounts.id.prompt จะแสดงข้อความแจ้งแบบแตะครั้งเดียวหรือเครื่องมือจัดการข้อมูลเข้าสู่ระบบเนทีฟของเบราว์เซอร์หลังจากเรียกใช้เมธอด initialize() ดูตัวอย่างโค้ดของเมธอดต่อไปนี้

 google.accounts.id.prompt(/**
 @type{(function(!PromptMomentNotification):void)=} */ momentListener)

โดยทั่วไปแล้ว ระบบจะเรียกใช้เมธอด prompt() เมื่อโหลดหน้าเว็บ UI ของข้อความแจ้งแบบแตะครั้งเดียวอาจไม่แสดงเนื่องจากสถานะเซสชันและการตั้งค่าผู้ใช้ในฝั่ง Google หากต้องการรับการแจ้งเตือนเกี่ยวกับสถานะ UI ในช่วงเวลาต่างๆ ให้ส่งผ่านฟังก์ชันเพื่อรับการแจ้งเตือนสถานะ UI

การแจ้งเตือนจะแสดงในลักษณะต่อไปนี้

การแสดงผล: การดำเนินการนี้จะเกิดขึ้นหลังจากเรียกใช้เมธอด prompt() การแจ้งเตือนมีค่าบูลีนเพื่อระบุว่า UI แสดงอยู่หรือไม่
ช่วงเวลาที่ข้าม: กรณีนี้เกิดขึ้นเมื่อข้อความแจ้งให้แตะครั้งเดียวถูกปิดด้วยการยกเลิกอัตโนมัติ การยกเลิกด้วยตนเอง หรือเมื่อ Google ออกข้อมูลเข้าสู่ระบบไม่ได้ เช่น เมื่อเซสชันที่เลือกออกจากระบบ Google แล้ว

ในกรณีเหล่านี้ เราขอแนะนำให้คุณเปลี่ยนไปใช้ผู้ให้บริการข้อมูลประจำตัวรายถัดไป หากมี
ช่วงเวลาที่ปิด: เกิดขึ้นเมื่อ Google ดึงข้อมูลเข้าสู่ระบบได้สําเร็จหรือผู้ใช้ต้องการหยุดขั้นตอนการดึงข้อมูลเข้าสู่ระบบ ตัวอย่างเช่น เมื่อผู้ใช้เริ่มป้อนชื่อผู้ใช้และรหัสผ่านในกล่องโต้ตอบการเข้าสู่ระบบ คุณสามารถเรียกใช้เมธอด google.accounts.id.cancel() เพื่อปิดข้อความแจ้งแบบแตะครั้งเดียวและทริกเกอร์ช่วงเวลาที่ปิด

คำเตือน: เมื่ออยู่ในช่วงเวลาที่ปิดอยู่ อย่าลองใช้ผู้ให้บริการข้อมูลประจำตัวรายถัดไป

ตัวอย่างโค้ดต่อไปนี้ใช้ช่วงเวลาที่ข้าม

<script>
  window.onload = function () {
    google.accounts.id.initialize(...);
    google.accounts.id.prompt((notification) => {
      if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
        // continue with another identity provider.
      }
    });
  };
</script>

ประเภทข้อมูล: PromptMomentNotification

ตารางต่อไปนี้แสดงเมธอดและคําอธิบายของประเภทข้อมูล PromptMomentNotification

วิธีการ
`isDisplayMoment()`	การแจ้งเตือนนี้สำหรับการแสดงผลใช่ไหม หมายเหตุ: เมื่อเปิดใช้ FedCM ระบบจะไม่แสดงการแจ้งเตือนนี้ ดูข้อมูลเพิ่มเติมที่หน้าย้ายข้อมูลไปยัง FedCM
`isDisplayed()`	การแจ้งเตือนนี้แสดงในการแสดงผลและ UI แสดงอยู่ไหม หมายเหตุ: เมื่อเปิดใช้ FedCM ระบบจะไม่แสดงการแจ้งเตือนนี้ ดูข้อมูลเพิ่มเติมที่หน้าย้ายข้อมูลไปยัง FedCM
`isNotDisplayed()`	การแจ้งเตือนนี้สำหรับการแสดงผลในบางช่วงเวลา และ UI ไม่แสดงใช่ไหม หมายเหตุ: เมื่อเปิดใช้ FedCM ระบบจะไม่แสดงการแจ้งเตือนนี้ ดูข้อมูลเพิ่มเติมที่หน้าย้ายข้อมูลไปยัง FedCM
`getNotDisplayedReason()`	เหตุผลโดยละเอียดที่ UI ไม่แสดง ค่าที่เป็นไปได้มีดังนี้ `browser_not_supported` `invalid_client` `missing_client_id` `opt_out_or_no_session` `secure_http_required` `suppressed_by_user` `unregistered_origin` `unknown_reason` หมายเหตุ: เมื่อเปิดใช้ FedCM ระบบจะไม่รองรับวิธีนี้ ดูข้อมูลเพิ่มเติมที่หน้าย้ายข้อมูลไปยัง FedCM
`isSkippedMoment()`	การแจ้งเตือนนี้เกี่ยวข้องกับช่วงเวลาที่ข้ามไปใช่ไหม
`getSkippedReason()`	เหตุผลโดยละเอียดของช่วงเวลาที่ข้าม ค่าที่เป็นไปได้มีดังนี้ `auto_cancel` `user_cancel` `tap_outside` `issuing_failed` หมายเหตุ: เมื่อเปิดใช้ FedCM ระบบจะไม่รองรับวิธีการนี้ ดูข้อมูลเพิ่มเติมที่หน้าย้ายข้อมูลไปยัง FedCM
`isDismissedMoment()`	การแจ้งเตือนนี้สำหรับช่วงเวลาที่ปิดไปแล้วใช่ไหม
`getDismissedReason()`	เหตุผลโดยละเอียดของการปิด ค่าที่เป็นไปได้มีดังนี้ `credential_returned` `cancel_called` `flow_restarted`
`getMomentType()`	แสดงผลสตริงสำหรับประเภทของช่วงเวลา ค่าที่เป็นไปได้มีดังนี้ `display` `skipped` `dismissed`

ประเภทข้อมูล: CredentialResponse

เมื่อเรียกใช้ฟังก์ชัน callback ระบบจะส่งออบเจ็กต์ CredentialResponse เป็นพารามิเตอร์ ตารางต่อไปนี้แสดงรายการช่องที่อยู่ในออบเจ็กต์การตอบกลับข้อมูลเข้าสู่ระบบ

ช่อง
`credential`	ช่องนี้เป็นโทเค็นรหัสที่แสดงผล
`select_by`	ช่องนี้จะกำหนดวิธีเลือกข้อมูลเข้าสู่ระบบ
`state`	ช่องนี้จะกำหนดเฉพาะเมื่อผู้ใช้คลิกปุ่มลงชื่อเข้าใช้ด้วย Google เพื่อลงชื่อเข้าใช้ และระบุแอตทริบิวต์ `state` ของปุ่ม

ข้อมูล เข้าสู่ระบบ

ช่องนี้เป็นโทเค็นระบุตัวตนในรูปแบบสตริง JSON Web Token (JWT) ที่เข้ารหัสฐาน 64

เมื่อถอดรหัสแล้ว JWT จะมีลักษณะดังตัวอย่างต่อไปนี้

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's GSuite email address
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Elisa",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

ช่อง sub คือตัวระบุที่ไม่ซ้ำกันทั่วโลกสำหรับบัญชี Google ใช้ช่อง sub เป็นตัวระบุผู้ใช้เท่านั้น เนื่องจากเป็นค่าที่ไม่ซ้ำกันสำหรับบัญชี Google ทั้งหมดและจะไม่นำกลับมาใช้ซ้ำ อย่าใช้อีเมลเป็นตัวระบุเนื่องจากบัญชี Google อาจมีอีเมลหลายรายการในช่วงเวลาต่างๆ

การใช้ฟิลด์ email, email_verified และ hd ช่วยให้คุณระบุได้ว่า Google โฮสต์และเป็นผู้กำหนดสิทธิ์สำหรับอีเมลหรือไม่ ในกรณีที่ Google มีสิทธิ์ตัดสินใจ ผู้ใช้จะได้รับการยืนยันว่าเป็นเจ้าของบัญชีที่ถูกต้อง

กรณีที่ Google เป็นผู้ให้ข้อมูล

email มีนามสกุล @gmail.com แสดงว่าเป็นบัญชี Gmail
email_verified เป็นจริงและมีการตั้งค่า hd แสดงว่าเป็นบัญชี Google Workspace

ผู้ใช้สามารถลงทะเบียนบัญชี Google ได้โดยไม่ต้องใช้ Gmail หรือ Google Workspace เมื่อ email ไม่มีส่วนต่อท้าย @gmail.com และไม่มี hd แสดงว่า Google ไม่มีสิทธิ์ในการตรวจสอบ และขอแนะนำให้ใช้รหัสผ่านหรือวิธีการยืนยันตัวตนอื่นๆ เพื่อยืนยันตัวตนผู้ใช้ email_verfied อาจเป็นจริงได้เนื่องจาก Google ยืนยันผู้ใช้ตั้งแต่แรกเมื่อสร้างบัญชี Google แต่ความเป็นเจ้าของบัญชีอีเมลของบุคคลที่สามอาจเปลี่ยนแปลงไปตั้งแต่นั้น

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

select_by

ตารางต่อไปนี้แสดงค่าที่เป็นไปได้สำหรับช่อง select_by ประเภทปุ่มที่ใช้ร่วมกับเซสชันและสถานะความยินยอมจะใช้เพื่อตั้งค่าค่า

ผู้ใช้กดปุ่ม One Tap หรือลงชื่อเข้าใช้ด้วย Google หรือใช้กระบวนการลงชื่อเข้าใช้โดยอัตโนมัติแบบไม่ต้องสัมผัส
พบเซสชันที่มีอยู่ หรือผู้ใช้เลือกและลงชื่อเข้าใช้บัญชี Google เพื่อสร้างเซสชันใหม่
ก่อนที่จะแชร์ข้อมูลเข้าสู่ระบบโทเค็นระบุตัวตนกับแอป ผู้ใช้ต้องดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- กดปุ่ม "ยืนยัน" เพื่อให้ความยินยอมในการแชร์ข้อมูลเข้าสู่ระบบ หรือ
- เคยให้ความยินยอมและใช้ "เลือกบัญชี" เพื่อเลือกบัญชี Google

ค่าของช่องนี้จะตั้งค่าเป็นประเภทใดประเภทหนึ่งต่อไปนี้

ค่า	คำอธิบาย
`auto`	การลงชื่อเข้าใช้โดยอัตโนมัติของผู้ใช้ที่มีเซสชันที่มีอยู่ซึ่งเคยให้ความยินยอมในการแชร์ข้อมูลเข้าสู่ระบบ ใช้กับเบราว์เซอร์ที่ไม่รองรับ FedCM เท่านั้น
`user`	ผู้ใช้ที่มีเซสชันเดิมซึ่งเคยให้ความยินยอมแล้วกดปุ่ม "ดำเนินการต่อในฐานะ" ของ One Tap เพื่อแชร์ข้อมูลเข้าสู่ระบบ ใช้กับเบราว์เซอร์ที่ไม่รองรับ FedCM เท่านั้น
`fedcm`	ผู้ใช้กดปุ่ม "ดำเนินการต่อในฐานะ" ของ One Tap เพื่อแชร์ข้อมูลเข้าสู่ระบบโดยใช้ FedCM ใช้กับเบราว์เซอร์ที่รองรับ FedCM เท่านั้น
`fedcm_auto`	การลงชื่อเข้าใช้โดยอัตโนมัติของผู้ใช้ที่มีเซสชันที่มีอยู่ซึ่งเคยให้ความยินยอมในการแชร์ข้อมูลเข้าสู่ระบบโดยใช้ FedCM One Tap ใช้กับเบราว์เซอร์ที่รองรับ FedCM เท่านั้น
`user_1tap`	ผู้ใช้ที่มีเซสชันเดิมกดปุ่ม "ดำเนินการต่อในฐานะ" ของ One Tap เพื่อให้ความยินยอมและแชร์ข้อมูลเข้าสู่ระบบ ใช้ได้กับ Chrome เวอร์ชัน 75 ขึ้นไปเท่านั้น
`user_2tap`	ผู้ใช้ที่ไม่มีเซสชันที่มีอยู่กดปุ่ม "ดำเนินการต่อในฐานะ" ของ One Tap เพื่อเลือกบัญชี แล้วกดปุ่มยืนยันในหน้าต่างป๊อปอัปเพื่อให้ความยินยอมและแชร์ข้อมูลเข้าสู่ระบบ ใช้กับเบราว์เซอร์ที่ไม่อิงตาม Chromium
`itp`	ผู้ใช้ที่มีเซสชันเดิมซึ่งเคยให้ความยินยอมแล้วกด "แตะครั้งเดียว" ในเบราว์เซอร์ ITP
`itp_confirm`	ผู้ใช้ที่มีเซสชันอยู่แล้วกด One Tap บนเบราว์เซอร์ ITP แล้วกดปุ่มยืนยันเพื่อให้ความยินยอมและแชร์ข้อมูลเข้าสู่ระบบ
`itp_add_session`	ผู้ใช้ที่ไม่มีเซสชันที่มีอยู่ซึ่งเคยให้ความยินยอมกด "แตะครั้งเดียว" ในเบราว์เซอร์ ITP เพื่อเลือกบัญชี Google และแชร์ข้อมูลเข้าสู่ระบบ
`itp_confirm_add_session`	ผู้ใช้ที่ไม่มีเซสชันที่มีอยู่ก่อนกด One Tap ในเบราว์เซอร์ ITP เพื่อเลือกบัญชี Google แล้วกดปุ่มยืนยันเพื่อให้ความยินยอมและแชร์ข้อมูลเข้าสู่ระบบ
`btn`	ผู้ใช้ที่มีเซสชันที่มีอยู่ซึ่งเคยให้ความยินยอมกดปุ่มลงชื่อเข้าใช้ด้วย Google และเลือกบัญชี Google จาก "เลือกบัญชี" เพื่อแชร์ข้อมูลเข้าสู่ระบบ
`btn_confirm`	ผู้ใช้ที่มีเซสชันเดิมกดปุ่มลงชื่อเข้าใช้ด้วย Google และกดปุ่มยืนยันเพื่อให้ความยินยอมและแชร์ข้อมูลเข้าสู่ระบบ
`btn_add_session`	ผู้ใช้ที่ไม่มีเซสชันเดิมซึ่งเคยให้ความยินยอมกดปุ่มลงชื่อเข้าใช้ด้วย Google เพื่อเลือกบัญชี Google และแชร์ข้อมูลเข้าสู่ระบบ
`btn_confirm_add_session`	ผู้ใช้ที่ไม่มีเซสชันที่มีอยู่ก่อนกดปุ่มลงชื่อเข้าใช้ด้วย Google เพื่อเลือกบัญชี Google แล้วกดปุ่มยืนยันเพื่อให้ความยินยอมและแชร์ข้อมูลเข้าสู่ระบบ

รัฐ

ช่องนี้จะกำหนดเฉพาะเมื่อผู้ใช้คลิกปุ่มลงชื่อเข้าใช้ด้วย Google เพื่อลงชื่อเข้าใช้ และระบุแอตทริบิวต์ state ของปุ่มที่คลิก ค่าของช่องนี้คือค่าเดียวกับที่คุณระบุไว้ในแอตทริบิวต์ state ของปุ่ม

เนื่องจากระบบแสดงผลปุ่มลงชื่อเข้าใช้ด้วย Google ได้หลายปุ่มในหน้าเดียวกัน คุณจึงกำหนดสตริงที่ไม่ซ้ำกันให้กับแต่ละปุ่มได้ คุณจึงใช้ช่อง state นี้เพื่อระบุปุ่มที่ผู้ใช้คลิกเพื่อลงชื่อเข้าใช้ได้

เมธอด: google.accounts.id.renderButton

วิธีการ google.accounts.id.renderButton จะแสดงผลปุ่มลงชื่อเข้าใช้ด้วย Google ในหน้าเว็บ

ดูตัวอย่างโค้ดของเมธอดต่อไปนี้

google.accounts.id.renderButton(
      /** @type{!HTMLElement} */ parent,
      /** @type{!GsiButtonConfiguration} */ options
    )

ประเภทข้อมูล: GsiButtonConfiguration

ตารางต่อไปนี้แสดงช่องและคําอธิบายของประเภทข้อมูล GsiButtonConfiguration

แอตทริบิวต์
`type`	ประเภทปุ่ม: ไอคอนหรือปุ่มมาตรฐาน
`theme`	ธีมปุ่ม เช่น filled_blue หรือ filled_black
`size`	ขนาดปุ่ม เช่น เล็กหรือใหญ่
`text`	ข้อความบนปุ่ม เช่น "ลงชื่อเข้าใช้ด้วย Google" หรือ "ลงชื่อสมัครใช้ด้วย Google"
`shape`	รูปร่างของปุ่ม เช่น สี่เหลี่ยมผืนผ้าหรือกลม
`logo_alignment`	การจัดแนวโลโก้ Google: ซ้ายหรือตรงกลาง
`width`	ความกว้างของปุ่มในหน่วยพิกเซล
`locale`	หากตั้งค่าไว้ ระบบจะแสดงผลภาษาของปุ่ม
`click_listener`	หากตั้งค่าไว้ ระบบจะเรียกใช้ฟังก์ชันนี้เมื่อมีการคลิกปุ่มลงชื่อเข้าใช้ด้วย Google
`state`	หากตั้งค่าไว้ สตริงนี้จะแสดงพร้อมกับโทเค็นระบุตัวตน

ประเภทแอตทริบิวต์

ส่วนต่อไปนี้มีรายละเอียดเกี่ยวกับประเภทของแอตทริบิวต์แต่ละรายการและตัวอย่าง

ประเภท

ประเภทปุ่ม ค่าเริ่มต้นคือ standard

ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ใช่	`type: "icon"`

ตารางต่อไปนี้แสดงประเภทปุ่มที่ใช้ได้และคำอธิบาย

ประเภท
`standard`	ปุ่มที่มีข้อความหรือข้อมูลที่ปรับเปลี่ยนในแบบของคุณ
`icon`	ปุ่มไอคอนที่ไม่มีข้อความ

ธีม [theme]

ธีมปุ่ม ค่าเริ่มต้นคือ outline ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`theme: "filled_blue"`

ตารางต่อไปนี้แสดงธีมที่มีและคำอธิบายธีม

ธีม
`outline`	ธีมปุ่มมาตรฐาน
`filled_blue`	ธีมปุ่มสีน้ำเงิน
`filled_black`	ธีมปุ่มสีดํา

ขนาด

ขนาดปุ่ม ค่าเริ่มต้นคือ large ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`size: "small"`

ตารางต่อไปนี้แสดงขนาดปุ่มที่ใช้ได้และคําอธิบาย

ขนาด
`large`	ปุ่มขนาดใหญ่
`medium`	ปุ่มขนาดกลาง
`small`	ปุ่มขนาดเล็ก

ข้อความ

ข้อความบนปุ่ม ค่าเริ่มต้นคือ signin_with ข้อความของปุ่มไอคอนที่มีแอตทริบิวต์ text ต่างกันไม่มีความแตกต่างทางภาพ ยกเว้นในกรณีที่อ่านข้อความเพื่อความสามารถในการเข้าถึงหน้าจอเท่านั้น

ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`text: "signup_with"`

ตารางต่อไปนี้แสดงข้อความทั้งหมดของปุ่มที่ใช้ได้และคำอธิบาย

ข้อความ
`signin_with`	ข้อความบนปุ่มคือ "ลงชื่อเข้าใช้ด้วย Google"
`signup_with`	ข้อความบนปุ่มคือ "ลงชื่อสมัครใช้ด้วย Google"
`continue_with`	ข้อความบนปุ่มคือ "ดำเนินการต่อด้วย Google"
`signin`	ข้อความบนปุ่มคือ "ลงชื่อเข้าใช้"

รูปร่าง

รูปร่างของปุ่ม ค่าเริ่มต้นคือ rectangular ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`shape: "rectangular"`

ตารางต่อไปนี้แสดงรูปร่างของปุ่มที่ใช้ได้และคำอธิบาย

รูปร่าง
`rectangular`	ปุ่มสี่เหลี่ยมผืนผ้า หากใช้กับปุ่มประเภท `icon` จะเป็นค่าเดียวกับ `square`
`pill`	ปุ่มทรงยาเม็ด หากใช้กับปุ่มประเภท `icon` จะเป็นค่าเดียวกับ `circle`
`circle`	ปุ่มรูปวงกลม หากใช้กับปุ่มประเภท `standard` จะเป็นค่าเดียวกับ `pill`
`square`	ปุ่มสี่เหลี่ยมจัตุรัส หากใช้กับปุ่มประเภท `standard` จะเป็นค่าเดียวกับ `rectangular`

logo_alignment

การจัดแนวโลโก้ Google ค่าเริ่มต้นคือ left แอตทริบิวต์นี้ใช้กับปุ่มประเภท standard เท่านั้น ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`logo_alignment: "center"`

ตารางต่อไปนี้แสดงการจัดแนวที่ใช้ได้และคำอธิบาย

logo_alignment
`left`	จัดแนวโลโก้ Google ไปทางซ้าย
`center`	จัดแนวโลโก้ Google ไว้กึ่งกลาง

ความกว้าง

ความกว้างขั้นต่ำของปุ่มในหน่วยพิกเซล ความกว้างสูงสุดคือ 400 พิกเซล

ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`width: "400"`

ภาษา

ไม่บังคับ แสดงข้อความปุ่มโดยใช้ภาษาที่ระบุ มิเช่นนั้นจะใช้การตั้งค่าบัญชี Google หรือเบราว์เซอร์ของผู้ใช้โดยค่าเริ่มต้น เพิ่มพารามิเตอร์ hl และโค้ดภาษาลงในคําสั่ง src เมื่อโหลดไลบรารี เช่น gsi/client?hl=<iso-639-code>

หากไม่ได้ตั้งค่าไว้ ระบบจะใช้ภาษาเริ่มต้นของเบราว์เซอร์หรือค่ากําหนดของผู้ใช้เซสชัน Google ผู้ใช้แต่ละรายจึงอาจเห็นปุ่มที่แปลแล้วเวอร์ชันต่างๆ และอาจมีขนาดต่างกัน

ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`locale: "zh_CN"`

click_listener

คุณสามารถกําหนดฟังก์ชัน JavaScript ให้เรียกใช้เมื่อมีการคลิกปุ่มลงชื่อเข้าใช้ด้วย Google โดยใช้แอตทริบิวต์ click_listener

  google.accounts.id.renderButton(document.getElementById("signinDiv"), {
      theme: 'outline',
      size: 'large',
      click_listener: onClickHandler
    });

  
  function onClickHandler(){
    console.log("Sign in with Google button clicked...")
  }

ในตัวอย่างนี้ ระบบจะบันทึกข้อความว่าคลิกปุ่มลงชื่อเข้าใช้ด้วย Google... ลงในคอนโซลเมื่อมีการคลิกปุ่มลงชื่อเข้าใช้ด้วย Google

รัฐ

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

ดูข้อมูลเพิ่มเติมได้ในตารางต่อไปนี้

ประเภท	ต้องระบุ	ตัวอย่าง
สตริง	ไม่บังคับ	`data-state: "button 1"`

ประเภทข้อมูล: ข้อมูลเข้าสู่ระบบ

เมื่อเรียกใช้ฟังก์ชัน native_callback ระบบจะส่งออบเจ็กต์ Credential เป็นพารามิเตอร์ ตารางต่อไปนี้แสดงรายการช่องที่อยู่ในออบเจ็กต์

ช่อง
`id`	ระบุผู้ใช้
`password`	รหัสผ่าน

เมธอด: google.accounts.id.disableAutoSelect

เมื่อผู้ใช้ออกจากระบบเว็บไซต์ คุณต้องเรียกใช้เมธอด google.accounts.id.disableAutoSelect เพื่อบันทึกสถานะในคุกกี้ วิธีนี้ช่วยป้องกันไม่ให้ UX วนซ้ำ ดูข้อมูลโค้ดต่อไปนี้ของเมธอด

google.accounts.id.disableAutoSelect()

ตัวอย่างโค้ดต่อไปนี้ใช้google.accounts.id.disableAutoSelect เมธอดกับฟังก์ชัน onSignout()

<script>
  function onSignout() {
    google.accounts.id.disableAutoSelect();
  }
</script>

เมธอด: google.accounts.id.storeCredential

เมธอดนี้เป็น Wrapper สําหรับเมธอด store() ของ API เครื่องมือจัดการข้อมูลเข้าสู่ระบบแบบเนทีฟของเบราว์เซอร์ จึงใช้ได้เฉพาะกับการจัดเก็บข้อมูลเข้าสู่ระบบที่เป็นรหัสผ่านเท่านั้น ดูตัวอย่างโค้ดของเมธอดต่อไปนี้

google.accounts.id.storeCredential(Credential, callback)

ตัวอย่างโค้ดต่อไปนี้ใช้google.accounts.id.storeCredential เมธอดกับฟังก์ชัน onSignIn()

<script>
  function onSignIn() {
    let cred = {id: '...', password: '...'};
    google.accounts.id.storeCredential(cred);
  }
</script>

เมธอด: google.accounts.id.cancel

คุณสามารถยกเลิกขั้นตอนการแตะครั้งเดียวได้หากนำข้อความแจ้งออกจาก DOM ของบุคคลที่เชื่อถือ ระบบจะไม่สนใจการดำเนินการยกเลิกหากเลือกข้อมูลเข้าสู่ระบบไว้แล้ว ดูตัวอย่างโค้ดของเมธอดต่อไปนี้

google.accounts.id.cancel()

ตัวอย่างโค้ดต่อไปนี้ใช้เมธอด google.accounts.id.cancel() กับฟังก์ชัน onNextButtonClicked()

<script>
  function onNextButtonClicked() {
    google.accounts.id.cancel();
    showPasswordPage();
  }
</script>

การเรียกกลับการโหลดคลัง: onGoogleLibraryLoad

คุณสามารถลงทะเบียนonGoogleLibraryLoadการโทรกลับ ระบบจะแจ้งให้ทราบหลังจากโหลดไลบรารี JavaScript ของฟีเจอร์ลงชื่อเข้าใช้ด้วย Google แล้ว

window.onGoogleLibraryLoad = () => {
    ...
};

การเรียกกลับนี้เป็นเพียงทางลัดสําหรับการเรียกกลับ window.onload ไม่มีความแตกต่างในลักษณะการทํางาน

ตัวอย่างโค้ดต่อไปนี้ใช้ onGoogleLibraryLoad callback

<script>
  window.onGoogleLibraryLoad = () => {
   google.accounts.id.initialize({
     ...
   });
   google.accounts.id.prompt();
  };
</script>

วิธีการ: google.accounts.id.revoke

เมธอด google.accounts.id.revoke จะเพิกถอนการให้สิทธิ์ OAuth ที่ใช้เพื่อแชร์โทเค็นรหัสผู้ใช้สำหรับผู้ใช้ที่ระบุ ดูข้อมูลโค้ดต่อไปนี้ของเมธอด javascript google.accounts.id.revoke(login_hint, callback)

พารามิเตอร์	ประเภท	คำอธิบาย
`login_hint`	สตริง	อีเมลหรือรหัสที่ไม่ซ้ำของบัญชี Google ของผู้ใช้ รหัสคือพร็อพเพอร์ตี้ `sub` ของเพย์โหลดข้อมูลเข้าสู่ระบบ
`callback`	ฟังก์ชัน	แฮนเดิล RevocationResponse ไม่บังคับ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้เมธอด revoke ที่มีรหัส

  google.accounts.id.revoke('1618033988749895', done => {
    console.log(done.error);
  });

ประเภทข้อมูล: RevocationResponse

เมื่อเรียกใช้ฟังก์ชัน callback ระบบจะส่งออบเจ็กต์ RevocationResponse เป็นพารามิเตอร์ ตารางต่อไปนี้แสดงรายการช่องที่อยู่ในออบเจ็กต์การตอบกลับการเพิกถอน

ช่อง
`successful`	ฟิลด์นี้เป็นค่าที่แสดงผลของการเรียกใช้เมธอด
`error`	ช่องนี้มีข้อความการตอบกลับข้อผิดพลาดโดยละเอียด (ไม่บังคับ)

สำเร็จ

ช่องนี้เป็นค่าบูลีนที่ตั้งค่าเป็น "จริง" หากการเรียกใช้เมธอดเพิกถอนสำเร็จ หรือ "เท็จ" หากไม่สำเร็จ

ข้อผิดพลาด

ช่องนี้เป็นค่าสตริงและมีข้อความแสดงข้อผิดพลาดโดยละเอียดหากการเรียกใช้เมธอดเพิกถอนไม่สำเร็จ ช่องนี้จะไม่มีการกําหนดหากสําเร็จ