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

ผ่านสถานะในการดำเนินการอีเมล

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

สิ่งนี้มีประโยชน์อย่างยิ่งในสถานการณ์ทั่วไปต่อไปนี้:

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

ความสามารถในการส่งผ่านสถานะผ่าน URL ดำเนินการต่อเป็นคุณสมบัติอันทรงพลังที่ Firebase Auth มีให้และสามารถปรับปรุงประสบการณ์ผู้ใช้ได้อย่างมาก

การส่ง URL สถานะ/ดำเนินการต่อในการดำเนินการทางอีเมล

ในการส่ง URL ต่อไปอย่างปลอดภัย โดเมนสำหรับ URL นั้นจะต้องอยู่ในรายการที่อนุญาตพิเศษใน คอนโซล Firebase ทำได้ในส่วนการ รับรองความถูกต้อง โดยเพิ่มโดเมนนี้ลงในรายการ โดเมนที่ได้รับอนุญาต ภายใต้แท็บ วิธีการลงชื่อเข้าใช้ หากยังไม่มี

ต้องระบุอินสแตนซ์ FIRActionCodeSettings เมื่อส่งอีเมลรีเซ็ตรหัสผ่านหรืออีเมลยืนยัน อินเทอร์เฟซนี้ใช้พารามิเตอร์ต่อไปนี้:

สวิฟต์

พารามิเตอร์	พิมพ์	คำอธิบาย
`URL`	สตริง	ตั้งค่าลิงก์ (สถานะ/ดำเนินการต่อ URL) ซึ่งมีความหมายต่างกันในบริบทต่างๆ: เมื่อลิงก์ถูกจัดการในวิดเจ็ตการทำงานบนเว็บ นี่คือลิงก์ในรายละเอียดในพารามิเตอร์เคียวรี `continueUrl` เมื่อลิงก์ได้รับการจัดการในแอปโดยตรง นี่คือพารามิเตอร์ข้อความค้นหา `continueUrl` ในลิงก์เชิงลึกของลิงก์ไดนามิก
`iOSBundleID`	สตริง	ตั้งค่ารหัสบันเดิล การดำเนินการนี้จะพยายามเปิดลิงก์ในแอป Apple หากมีการติดตั้งไว้ ต้องลงทะเบียนแอปในคอนโซล หากไม่ได้ระบุ Bundle ID ค่าของฟิลด์นี้จะถูกตั้งค่าเป็น Bundle ID ของ Bundle หลักของแอป
`androidPackageName`	สตริง	ตั้งชื่อแพ็คเกจ Android การดำเนินการนี้จะพยายามเปิดลิงก์ในแอป Android หากมีการติดตั้งไว้
`androidInstallIfNotAvailable`	บูล	ระบุว่าจะติดตั้งแอป Android หรือไม่ หากอุปกรณ์รองรับและยังไม่ได้ติดตั้งแอป หากระบุฟิลด์นี้โดยไม่มีชื่อแพ็กเกจ ข้อผิดพลาดจะเกิดขึ้นโดยอธิบายว่าต้องระบุชื่อแพ็กเกจร่วมกับฟิลด์นี้
`androidMinimumVersion`	สตริง	เวอร์ชันขั้นต่ำของแอปที่รองรับในขั้นตอนนี้ หากมีการระบุเวอร์ชันขั้นต่ำ และติดตั้งแอปเวอร์ชันเก่ากว่า ระบบจะนำผู้ใช้ไปที่ Play Store เพื่ออัปเกรดแอป ต้องลงทะเบียนแอป Android ในคอนโซล
`handleCodeInApp`	บูล	จะเปิดลิงก์การดำเนินการอีเมลในแอปบนอุปกรณ์เคลื่อนที่หรือเว็บลิงก์ก่อน ค่าดีฟอลต์เป็นเท็จ เมื่อตั้งค่าเป็นจริง ลิงก์รหัสการดำเนินการจะถูกส่งเป็น Universal Link หรือ Android App Link และจะเปิดโดยแอปหากมีการติดตั้ง ในกรณีที่เป็นเท็จ รหัสจะถูกส่งไปยังเว็บวิดเจ็ตก่อน จากนั้นดำเนินการต่อ จะเปลี่ยนเส้นทางไปยังแอปหากติดตั้ง
`dynamicLinkDomain`	สตริง	ตั้งค่าโดเมนลิงก์แบบไดนามิก (หรือโดเมนย่อย) เพื่อใช้สำหรับลิงก์ปัจจุบัน หากจะเปิดโดยใช้ลิงก์แบบไดนามิกของ Firebase เนื่องจากสามารถกำหนดค่าโดเมนลิงก์แบบไดนามิกได้หลายโดเมนต่อโปรเจ็กต์ ฟิลด์นี้จึงให้ความสามารถในการเลือกอย่างชัดแจ้ง หากไม่ได้ระบุไว้ โดเมนแรกจะถูกใช้เป็นค่าเริ่มต้น

วัตถุประสงค์-C

พารามิเตอร์	พิมพ์	คำอธิบาย
`URL`	NSString	ตั้งค่าลิงก์ (สถานะ/ดำเนินการต่อ URL) ซึ่งมีความหมายต่างกันในบริบทต่างๆ: เมื่อลิงก์ถูกจัดการในวิดเจ็ตการทำงานบนเว็บ นี่คือลิงก์ในรายละเอียดในพารามิเตอร์เคียวรี `continueUrl` เมื่อลิงก์ได้รับการจัดการในแอปโดยตรง นี่คือพารามิเตอร์ข้อความค้นหา `continueUrl` ในลิงก์เชิงลึกของลิงก์ไดนามิก
`iOSBundleID`	NSString	ตั้งค่ารหัสบันเดิล การดำเนินการนี้จะพยายามเปิดลิงก์ในแอป Apple หากมีการติดตั้งไว้ ต้องลงทะเบียนแอปในคอนโซล
`androidPackageName`	NSString	ตั้งชื่อแพ็คเกจ Android การดำเนินการนี้จะพยายามเปิดลิงก์ในแอป Android หากมีการติดตั้งไว้
`androidInstallIfNotAvailable`	บูล	ระบุว่าจะติดตั้งแอพ Android หรือไม่หากอุปกรณ์รองรับและยังไม่ได้ติดตั้งแอพ หากระบุฟิลด์นี้โดยไม่มีชื่อแพ็กเกจ ข้อผิดพลาดจะเกิดขึ้นโดยอธิบายว่าต้องระบุชื่อแพ็กเกจร่วมกับฟิลด์นี้
`androidMinimumVersion`	NSString	เวอร์ชันขั้นต่ำของแอปที่รองรับในขั้นตอนนี้ หากมีการระบุเวอร์ชันขั้นต่ำ และติดตั้งแอปเวอร์ชันเก่ากว่า ระบบจะนำผู้ใช้ไปที่ Play Store เพื่ออัปเกรดแอป ต้องลงทะเบียนแอป Android ในคอนโซล
`handleCodeInApp`	บูล	จะเปิดลิงก์การดำเนินการอีเมลในแอปบนอุปกรณ์เคลื่อนที่หรือเว็บลิงก์ก่อน ค่าดีฟอลต์เป็นเท็จ เมื่อตั้งค่าเป็นจริง ลิงก์รหัสการดำเนินการจะถูกส่งเป็น Universal Link หรือ Android App Link และจะเปิดโดยแอปหากมีการติดตั้ง ในกรณีที่เป็นเท็จ รหัสจะถูกส่งไปยังเว็บวิดเจ็ตก่อน จากนั้นดำเนินการต่อ จะเปลี่ยนเส้นทางไปยังแอปหากติดตั้ง
`dynamicLinkDomain`	NSString	ตั้งค่าโดเมนลิงก์แบบไดนามิก (หรือโดเมนย่อย) เพื่อใช้สำหรับลิงก์ปัจจุบัน หากจะเปิดโดยใช้ลิงก์แบบไดนามิกของ Firebase เนื่องจากสามารถกำหนดค่าโดเมนลิงก์แบบไดนามิกได้หลายโดเมนต่อโปรเจ็กต์ ฟิลด์นี้จึงให้ความสามารถในการเลือกอย่างชัดแจ้ง หากไม่ได้ระบุไว้ โดเมนแรกจะถูกใช้เป็นค่าเริ่มต้น

ตัวอย่างต่อไปนี้แสดงวิธีส่งลิงก์ยืนยันอีเมลที่จะเปิดในแอปบนอุปกรณ์เคลื่อนที่ก่อนเป็น Firebase Dynamic Link โดยใช้โดเมนลิงก์แบบไดนามิกที่กำหนดเอง example.page.link (แอป iOS com.example.ios หรือแอป Android com.example.android ที่แอพจะติดตั้งหากยังไม่ได้ติดตั้งและเวอร์ชันขั้นต่ำคือ 12 ) ลิงก์ในรายละเอียดจะมีเพย์โหลด URL ต่อไป https://www.example.com/?email=user@example.com

สวิฟต์


var actionCodeSettings =  ActionCodeSettings.init()
actionCodeSettings.canHandleInApp = true
let user = Auth.auth().currentUser()
actionCodeSettings.URL =
    String(format: "https://www.example.com/?email=%@", user.email)
actionCodeSettings.iOSbundleID = Bundle.main.bundleIdentifier!
actionCodeSettings.setAndroidPakageName("com.example.android",
                                         installIfNotAvailable:true,
                                         minumumVersion:"12")
// When multiple custom dynamic link domains are defined, specify which one to use.
actionCodeSettings.dynamicLinkDomain = "example.page.link"
user.sendEmailVerification(withActionCodeSettings:actionCodeSettings { error in
  if error {
    // Error occurred. Inspect error.code and handle error.
    return
  }
  // Email verification sent.
})

วัตถุประสงค์-C

 FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init];
 actionCodeSettings.handleCodeInApp = YES;
 FIRUser *user = [FIRAuth auth].currentUser;
 NSString *urlString =
     [NSString stringWithFormat:@"https://www.example.com/?email=%@", user.email];
 actionCodeSettings.URL = [NSURL URLWithString:urlString];
 actionCodeSettings.iOSBundleID = [NSBundle mainBundle].bundleIdentifier;
 // When multiple custom dynamic link domains are defined, specify which one to use.
 actionCodeSettings.dynamicLinkDomain = @"example.page.link";
 [actionCodeSettings setAndroidPackageName:@"com.example.android"
                     installIfNotAvailable:YES
                            minimumVersion:'12'];
 [user sendEmailVerificationWithActionCodeSettings:actionCodeSettings
                                        completion:^(NSError *_Nullable error) {
   if (error) {
     // Error occurred. Inspect error.code and handle error.
     return;
   }
   // Email verification sent.
 }];

การกำหนดค่าลิงก์ไดนามิกของ Firebase

Firebase Auth ใช้ Firebase Dynamic Links เมื่อส่งลิงก์ที่ต้องการเปิดในแอปพลิเคชันมือถือ หากต้องการใช้ฟีเจอร์นี้ ลิงก์แบบไดนามิกต้องได้รับการกำหนดค่าในคอนโซล Firebase

เปิดใช้ลิงก์ไดนามิกของ Firebase:
1. ใน คอนโซล Firebase ให้เปิดส่วน ลิงก์แบบไดนามิก
2. หากคุณยังไม่ได้ยอมรับข้อกำหนดของ Dynamic Links และสร้างโดเมน Dynamic Links ให้ดำเนินการทันที
  หากคุณสร้างโดเมนลิงก์แบบไดนามิกแล้ว โปรดจดบันทึกไว้ โดยทั่วไปแล้วโดเมนลิงก์แบบไดนามิกจะมีลักษณะดังนี้:
```
example.page.link
```
  คุณจะต้องใช้ค่านี้เมื่อคุณกำหนดค่าแอป Apple หรือ Android เพื่อสกัดกั้นลิงก์ขาเข้า
การกำหนดค่าแอปพลิเคชัน Android:
1. หากคุณวางแผนที่จะจัดการลิงก์เหล่านี้จากแอปพลิเคชัน Android คุณต้องระบุชื่อแพ็กเกจ Android ในการตั้งค่าโปรเจ็กต์คอนโซล Firebase นอกจากนี้ จำเป็นต้องมี SHA-1 และ SHA-256 ของใบรับรองการสมัคร
2. คุณจะต้องกำหนดค่าตัวกรองความตั้งใจสำหรับลิงก์ในรายละเอียดในไฟล์ AndroidManifest.xml
3. สำหรับข้อมูลเพิ่มเติม โปรดดูคำแนะนำในการ รับ Android Dynamic Links
การกำหนดค่าแอปพลิเคชัน Apple:
1. หากคุณวางแผนที่จะจัดการลิงก์เหล่านี้จากแอปพลิเคชันของคุณ จะต้องระบุรหัสบันเดิลในการตั้งค่าโปรเจ็กต์คอนโซล Firebase นอกจากนี้ จำเป็นต้องระบุ ID ของ App Store และ Apple Developer Team ID ด้วย
2. คุณจะต้องกำหนดค่าโดเมนลิงก์สากล FDL เป็นโดเมนที่เกี่ยวข้องในความสามารถของแอปพลิเคชันของคุณ
3. หากคุณวางแผนที่จะเผยแพร่แอปพลิเคชันของคุณไปยัง iOS เวอร์ชัน 8 หรือต่ำกว่า คุณจะต้องตั้งค่า Bundle ID เป็นแบบแผนที่กำหนดเองสำหรับ URL ขาเข้า
4. สำหรับข้อมูลเพิ่มเติม โปรดดูคำแนะนำการ รับลิงก์แบบไดนามิกของแพลตฟอร์ม Apple

จัดการการดำเนินการทางอีเมลในเว็บแอปพลิเคชัน

คุณสามารถระบุได้ว่าคุณต้องการจัดการลิงก์โค้ดการดำเนินการจากเว็บแอปพลิเคชันก่อน จากนั้นจึงเปลี่ยนเส้นทางไปยังหน้าเว็บหรือแอปพลิเคชันมือถืออื่นหลังจากทำสำเร็จ โดยต้องมีแอปพลิเคชันมือถือพร้อมใช้งาน สิ่งนี้ทำได้โดยการตั้งค่า handleCodeInApp false ใน FIRActionCodeSettings (Obj-C) หรือ ActionCodeSettings (Swift) แม้ว่ารหัสบันเดิลหรือชื่อแพ็คเกจ Android จะไม่จำเป็น แต่การระบุรหัสเหล่านี้จะช่วยให้ผู้ใช้เปลี่ยนเส้นทางกลับไปยังแอปที่ระบุเมื่อกรอกรหัสการดำเนินการทางอีเมล

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

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

เมื่อจัดการการดำเนินการทางอีเมล เช่น การยืนยันอีเมล โค้ดการดำเนินการจากพารามิเตอร์การค้นหา oobCode จะต้องแยกวิเคราะห์จากลิงก์ในรายละเอียด จากนั้นนำไปใช้ผ่าน applyActionCode เพื่อให้การเปลี่ยนแปลงมีผล กล่าวคือ อีเมลต้องได้รับการยืนยัน

จัดการการดำเนินการทางอีเมลในแอปพลิเคชันมือถือ

คุณสามารถระบุได้ว่าคุณต้องการจัดการลิงก์โค้ดการดำเนินการภายในแอปพลิเคชันบนมือถือของคุณก่อนหรือไม่ โดยต้องติดตั้งไว้ ด้วยแอปพลิเคชัน Android คุณยังสามารถระบุผ่าน androidInstallIfNotAvailable ว่าจะติดตั้งแอปหากอุปกรณ์รองรับและยังไม่ได้ติดตั้ง หากมีการคลิกลิงก์จากอุปกรณ์ที่ไม่รองรับแอปพลิเคชันบนมือถือ ลิงก์นั้นจะถูกเปิดจากหน้าเว็บแทน สิ่งนี้ทำได้โดยการตั้งค่า handleCodeInApp true ใน FIRActionCodeSettings (Obj-C) หรือ ActionCodeSettings (Swift) จะต้องระบุชื่อแพ็กเกจ Android หรือ Bundle ID ของแอปพลิเคชันมือถือ URL ของเว็บทางเลือกที่ใช้ที่นี่เมื่อไม่มีแอปบนอุปกรณ์เคลื่อนที่คือ URL ที่กำหนดค่าในส่วนเทมเพลตการดำเนินการอีเมล มีการเตรียมใช้งานค่าเริ่มต้นสำหรับทุกโครงการ โปรดดูที่การ ปรับแต่งตัวจัดการอีเมล เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับวิธีปรับแต่งตัวจัดการการดำเนินการอีเมล

ในกรณีนี้ ลิงก์แอปบนอุปกรณ์เคลื่อนที่ที่ส่งไปยังผู้ใช้จะเป็นลิงก์ FDL ซึ่งเพย์โหลดคือ URL โค้ดการดำเนินการ ซึ่งกำหนดค่าใน Console ด้วยพารามิเตอร์การค้นหา oobCode , mode , apiKey และ continueUrl ส่วนหลังจะเป็น URL ดั้งเดิมที่ระบุใน FIRActionCodeSettings (Obj-C) หรือ ActionCodeSettings (Swift) แม้ว่าคุณจะสามารถสกัดกั้นและจัดการลิงก์ขาเข้าจากแอปของคุณได้โดยไม่ต้องพึ่งพาเพิ่มเติม แต่เราขอแนะนำให้ใช้ไลบรารีไคลเอ็นต์ FDL เพื่อแยกวิเคราะห์ลิงก์ในรายละเอียดสำหรับคุณ สามารถใช้รหัสการดำเนินการได้โดยตรงจากแอปพลิเคชันมือถือ คล้ายกับวิธีจัดการจากเว็บโฟลว์ที่อธิบายไว้ในส่วนการ ปรับแต่งตัวจัดการอีเมล