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

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

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

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

ไวยากรณ์

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

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

relation

อาร์เรย์ของสตริงอย่างน้อย 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.puppy.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

  package_name

  ชื่อแพ็กเกจที่สมบูรณ์ในตัวเองของแอปที่จะใช้กับข้อความนี้ เช่น 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

ปรับขนาดข้อความหลายสิบรายการขึ้นไป

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

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

ตัวอย่างเช่น คุณอาจตัดสินใจว่าตำแหน่งส่วนกลางควรเป็น "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>

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

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