รายการคำสั่งคือไฟล์หรือตัวอย่างข้อมูลที่เข้ารหัส JSON ในตำแหน่งที่รู้จักกันดี
ตำแหน่งของรายการใบแจ้งยอด
ดูการสร้างรายการคำสั่งเพื่อเรียนรู้ว่าควรจัดเก็บรายการนี้ไว้ที่ใด
ไวยากรณ์
รายการคำสั่งหรือตัวอย่างข้อมูลประกอบด้วยอาร์เรย์ JSON ของคำสั่งเว็บไซต์หรือแอปอย่างน้อย 1 รายการเป็นออบเจ็กต์ JSON ใบแจ้งยอดเหล่านี้จะเรียงลำดับแบบใดก็ได้ ไวยากรณ์ทั่วไปมีดังนี้
[ { "relation": ["relation_string"], "target": {target_object} } , ... ]
- relation
- อาร์เรย์ของสตริงอย่างน้อย 1 รายการที่อธิบายความสัมพันธ์ที่ประกาศเกี่ยวกับเป้าหมาย ดูรายการสตริงความสัมพันธ์ที่กำหนดไว้ เช่น
delegate_permission/common.handle_all_urls
- เป้าหมาย
- เนื้อหาเป้าหมายที่เกี่ยวข้องกับการใช้ข้อความนี้ ประเภทเป้าหมายที่ใช้ได้
ตัวอย่างรายการข้อความ
ตัวอย่างรายการคำสั่งเว็บไซต์ที่มีข้อความเกี่ยวกับทั้งเว็บไซต์และแอปที่ http://example.digitalassetlinks.org/.well-known/assetlinks.json
ปรับขนาดข้อความหลายสิบรายการขึ้นไป
ในบางกรณี ครูใหญ่อาจต้องการแถลงข้อความที่หลากหลายเกี่ยวกับเป้าหมายที่แตกต่างกัน หรืออาจต้องออกคำชี้แจงจากผู้ใช้หลักคนละคนไปยังเป้าหมายชุดเดียวกัน เช่น เว็บไซต์หนึ่งอาจให้บริการบนโดเมนระดับบนสุดที่แตกต่างกันไปในแต่ละประเทศ และโดเมนเหล่านั้นทั้งหมดอาจต้องการระบุถึงแอปบนอุปกรณ์เคลื่อนที่เดียวกัน
สําหรับสถานการณ์เหล่านี้ รวมคำสั่งก็อาจเป็นประโยชน์ เมื่อใช้กลไกนี้ คุณสามารถตั้งค่าตัวชี้จากผู้ใช้หลักจำนวนมากไปยังตำแหน่งส่วนกลางเพียงแห่งเดียว ซึ่งจะกำหนดคำสั่งสำหรับผู้ใช้หลักทั้งหมด
ตัวอย่างเช่น คุณอาจตัดสินใจว่าตำแหน่งส่วนกลางควรเป็น "https://example.com/includedstatements.json" ซึ่งสามารถกำหนดค่าไฟล์นี้ให้มีเนื้อหาเดียวกันกับในตัวอย่างด้านบน
หากต้องการตั้งค่าตัวชี้จากเว็บไซต์ไปยังไฟล์รวม ให้เปลี่ยน "https://example.com/.well-known/assetlinks.json" เป็นดังนี้
[{ "include": "https://example.com/includedstatements.json" }]
หากต้องการตั้งค่าตัวชี้จากแอป Android ไปยังไฟล์รวม ให้เปลี่ยน "res/values/strings.xml" เป็น
<resources> ... <string name="asset_statements"> [{ \"include\": \"https://example.com/includedstatements.json\" }] </string> </resources>
ข้อมูลเพิ่มเติม
มีคำอธิบายโดยละเอียดเพิ่มเติมเกี่ยวกับรูปแบบรายการคำสั่งและแนวคิดสำคัญในเอกสารข้อกำหนดของเรา