คุณสร้าง Dynamic Links แบบสั้นได้ด้วย REST API ของลิงก์แบบไดนามิกของ Firebase API นี้ ยอมรับ Dynamic Link แบบยาวหรือออบเจ็กต์ที่มีพารามิเตอร์ Dynamic Link และ แสดงผล URL เหมือนตัวอย่างต่อไปนี้
https://example.page.link/WXYZ
Dynamic Links แบบสั้นที่สร้างด้วย API และ SDK ของไคลเอ็นต์ (Android/Apple) ไม่แสดง ในคอนโซล Firebase Dynamic Links ดังกล่าวมีไว้เพื่อการแชร์ระหว่างผู้ใช้ สำหรับกรณีการใช้งานด้านการตลาด ให้สร้างลิงก์โดยตรงผ่าน Dynamic Links หน้า ของคอนโซล Firebase
ก่อนเริ่มต้น
- รับคีย์ API คุณจะต้องใช้คีย์ API เพื่อตรวจสอบสิทธิ์คำขอ
กับ API วิธีค้นหาคีย์ API
- เปิดหน้าการตั้งค่า ของคอนโซล Firebase หากระบบขอให้เลือกโปรเจ็กต์ ให้ทำดังนี้ เลือกโปรเจ็กต์ Firebase จากเมนู
- จดบันทึกค่าของช่องคีย์ API ของเว็บ
- ในคอนโซล Firebase ให้เปิดส่วน Dynamic Links
-
หากคุณยังไม่ได้ยอมรับข้อกำหนดในการให้บริการและตั้งค่าโดเมน สำหรับ Dynamic Links ให้ดำเนินการเมื่อได้รับข้อความแจ้ง
หากคุณมีโดเมน Dynamic Links อยู่แล้ว โปรดจดไว้ สิ่งที่คุณต้องทำ ระบุโดเมน Dynamic Links เมื่อคุณสร้าง Dynamic Links แบบเป็นโปรแกรม
กำลังสร้าง Dynamic Link แบบสั้น
สร้างลิงก์แบบสั้นจากลิงก์แบบยาว
คุณสามารถใช้ Firebase Dynamic Links API เพื่อทำให้ Dynamic Link สั้นลง โดยดำเนินการดังนี้
ส่งคำขอ HTTP POST ไปยังปลายทาง shortLinks โดยระบุ
ยาว Dynamic Link ในพารามิเตอร์ longDynamicLink เช่น
POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json
{
"longDynamicLink": "https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibi=com.example.ios"
}
ดูสร้าง URL ด้วยตนเองเพื่อเรียนรู้วิธี เพื่อสร้าง Dynamic Links แบบยาว
สร้างลิงก์แบบสั้นจากพารามิเตอร์
นอกจากนี้ คุณยังสร้าง Dynamic Link แบบสั้นได้โดยการระบุพารามิเตอร์ Dynamic Link
โดยตรง โดยให้ส่งคำขอ HTTP POST ไปยัง shortLinks
ปลายทาง ซึ่งระบุพารามิเตอร์ Dynamic Link ในพารามิเตอร์ dynamicLinkInfo
เช่น
POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json
{
"dynamicLinkInfo": {
"domainUriPrefix": "https://example.page.link",
"link": "https://www.example.com/",
"androidInfo": {
"androidPackageName": "com.example.android"
},
"iosInfo": {
"iosBundleId": "com.example.ios"
}
}
}
สำหรับข้อกำหนดทั้งหมดของออบเจ็กต์ dynamicLinkInfo โปรดดู
การอ้างอิง API
กำหนดความยาวของDynamic Linkแบบสั้น
คุณยังตั้งค่าพารามิเตอร์ suffix เพื่อระบุวิธีที่คอมโพเนนต์เส้นทางของ
สร้าง Dynamic Link แบบสั้นแล้ว
โดยค่าเริ่มต้น หรือหากคุณตั้งค่าพารามิเตอร์เป็น "UNGUESSABLE" คอมโพเนนต์เส้นทาง
จะเป็นสตริงที่มีอักขระ 17 ตัว ดังตัวอย่างต่อไปนี้
https://example.page.link/UVWXYZuvwxyz12345
สตริงดังกล่าวสร้างขึ้นโดยการเข้ารหัส base62 ที่เป็นตัวเลข 96 บิตที่สร้างขึ้นแบบสุ่ม ใช้การตั้งค่านี้เพื่อป้องกันไม่ให้มีการคาดเดาและรวบรวมข้อมูล URL ของ Dynamic Links ซึ่งอาจเปิดเผยข้อมูลที่ละเอียดอ่อนต่อผู้รับที่ไม่ได้ตั้งใจ
หากคุณตั้งค่าพารามิเตอร์เป็น "SHORT" คอมโพเนนต์เส้นทางจะเป็นสตริงที่
มีความยาวได้ไม่เกิน 4 อักขระ
https://example.page.link/WXYZ
ใช้วิธีนี้เมื่อไม่มีการเปิดเผยข้อมูลที่ละเอียดอ่อนหาก Dynamic Link แบบสั้น มีการคาดเดา URL
ตัวอย่างต่อไปนี้แสดงวิธีการตั้งค่าพารามิเตอร์ suffix
POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json
{
"longDynamicLink": "https://example.page.link/?link=http://www.example.com/&apn=com.example.android&ibi=com.example.ios",
"suffix": {
"option": "UNGUESSABLE"
}
}
ตรวจสอบว่า Deep Link ถูกต้อง
อย่างน้อยที่สุด ค่า Deep Link ที่ระบุต้องขึ้นต้นด้วยรูปแบบ http:// หรือ https:// และต้องตรงกับรายการรูปแบบ URL ที่อนุญาตพิเศษที่ป้อนในคอนโซลด้วย ไม่เช่นนั้น API การสร้างจะล้มเหลวโดยมีรหัสข้อผิดพลาด HTTP 400
ขั้นตอนถัดไป
ตอนนี้คุณสร้าง Dynamic Links แล้ว คุณจะต้องตั้งค่าแอปเพื่อรับ Dynamic Linksและส่งผู้ใช้ไปยังตำแหน่งที่ถูกต้องในแอปของคุณหลังจากผู้ใช้เปิดแอป
หากต้องการรับ Dynamic Links ในแอปของคุณ โปรดดูเอกสารประกอบสำหรับ iOS, Android, C++ และ Unity
คำขอจำกัดไว้ที่ 5 คำขอ/ที่อยู่ IP/วินาที และ 200,000 คำขอ/วัน หากเกิน การตอบสนองจะแสดงรหัสข้อผิดพลาด HTTP 429 หากต้องการขอ โควต้าเพิ่มเติม ให้กรอกแบบฟอร์มนี้