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

ไวยากรณ์ของรายการใบแจ้งยอด

รายการคําสั่งคือไฟล์หรือข้อมูลโค้ดที่เข้ารหัสด้วย JSON ในตําแหน่งที่รู้จัก

ตําแหน่งของรายการใบแจ้งยอด

โปรดดูการสร้างรายการใบแจ้งยอดเพื่อดูว่าควรเก็บรายการนี้ไว้ที่ใด

ไวยากรณ์

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

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]

ความสัมพันธ์

อาร์เรย์ของสตริงอย่างน้อย 1 สตริงที่อธิบายความสัมพันธ์ที่ประกาศเกี่ยวกับเป้าหมาย ดูรายการสตริงความสัมพันธ์ที่กําหนด เช่น delegate_permission/common.handle_all_urls

เป้าหมาย

เนื้อหาเป้าหมายที่ข้อความนี้มีผลบังคับใช้ ประเภทเป้าหมายที่ใช้ได้

เป้าหมายเว็บไซต์
```
"target": {
  "namespace": "web",
  "site": "site_root_url"
}
```
เนมสเปซ

ต้องเป็น web สําหรับเว็บไซต์

เว็บไซต์

URI ของเว็บไซต์ที่เป็นเป้าหมายของคําสั่งในรูปแบบ http[s]://<hostname>[:<port>] ซึ่ง <hostname> เข้าเกณฑ์โดยสมบูรณ์ และต้องละเว้น <port> เมื่อใช้พอร์ต 80 สําหรับ HTTP หรือพอร์ต 443 สําหรับ HTTPS เป้าหมายเว็บไซต์ต้องเป็นโดเมนรากเท่านั้น คุณจึงจํากัดไปยังไดเรกทอรีย่อยที่เจาะจงไม่ได้ ไดเรกทอรีทั้งหมดภายใต้รูทนี้จะตรงกัน โดเมนย่อยไม่ควรถือว่าตรงกัน กล่าวคือหากไฟล์ข้อความโฮสต์บน www.example.com แล้ว www.puppies.example.com ไม่ควรถือเป็นรายการที่ตรงกัน ดูกฎและตัวอย่างเกี่ยวกับการจับคู่เป้าหมายในเว็บไซต์ได้ที่เอกสารประกอบของเป้าหมาย เช่น http://www.example.com
เป้าหมายแอป Android
```
"target": {
  "namespace": "android_app",
  "package_name": "fully_qualified_package_name",
  "sha256_cert_fingerprints": ["cert_fingerprint"]
}
```
เนมสเปซ

ต้องเป็น android_app สําหรับแอป Android

ชื่อแพ็กเกจ

ชื่อแพ็กเกจแบบเต็มของแอปที่มีข้อความดังกล่าว เช่น com.google.android.apps.maps

ลายนิ้วมือ sha256_cert_fingerprints
ลายนิ้วมือ SHA265 ตัวพิมพ์ใหญ่ของใบรับรองสําหรับแอปตามคําสั่งนี้ คุณคํานวณได้โดยใช้ openssl หรือ Java keytool ดังที่แสดงที่นี่
- openssl x509 -in $CERTFILE -noout -fingerprint -sha256
- keytool -printcert -file $CERTFILE | grep SHA256
เช่น ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
หากคุณใช้ Play App Signing สําหรับแอปของคุณ ลายนิ้วมือของใบรับรองที่สร้างขึ้นด้วยการเรียกใช้ keytool หรือ openssl มักจะไม่ตรงกับลายนิ้วมือในอุปกรณ์ของผู้ใช้ คุณตรวจสอบได้ว่าคุณกําลังใช้ Play App Signing สําหรับแอปในบัญชีนักพัฒนาแอป Play Console ในส่วน Release > Setup > App Integrity หรือไม่ หากมี ก็จะเห็นข้อมูลโค้ด JSON ของลิงก์เนื้อหาดิจิทัล (Digital Asset Links) สําหรับแอปเดียวกันในหน้าเดียวกัน

ตัวอย่างรายการใบแจ้งยอด

ต่อไปนี้เป็นตัวอย่างรายการข้อความเกี่ยวกับเว็บไซต์ที่มีข้อความเกี่ยวกับทั้งเว็บไซต์และแอป http://example.digitalassetlinks.org/.well-known/assetlinks.json

การปรับขนาดใบแจ้งยอดหลายสิบรายการขึ้นไป

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

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

เช่น คุณอาจเลือกว่าตําแหน่งส่วนกลางควรเป็น '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>

ข้อมูลเพิ่มเติม

มีคําอธิบายโดยละเอียดเกี่ยวกับรูปแบบรายการข้อความและแนวคิดสําคัญในเอกสารเฉพาะของเรา