דף זה תורגם על ידי Cloud Translation API.

התחביר של רשימת הדוחות

רשימת הצהרות היא קובץ או קטע טקסט בקידוד JSON במיקום ידוע.

מיקום רשימת דפי החשבון

למידע נוסף על מיקום האחסון של הרשימה, ראו יצירת רשימת דפי חשבון.

תחביר

רשימת ההצהרה או קטע הקוד מורכבים ממערך JSON שמכיל הצהרה אחת או יותר של אתר או אפליקציה כאובייקט JSON. ההצהרות האלה יכולות להיות בכל סדר שתרצו. זהו התחביר הכללי:

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

relation

מערך של מחרוזת אחת או יותר שמתארת את הקשר שצוין לגבי היעד. לעיון ברשימה של מחרוזות קשר מוגדרות. לדוגמה: 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. יעד אתר יכול להיות דומיין בסיסי בלבד; לא ניתן להגביל ספריית משנה ספציפית; כל הספריות ברמה הבסיסית (root) יהיו תואמות. אין להחשיב תת-דומיינים תואמים: כלומר, אם קובץ ההצהרה מתארח ב-www.example.com, אין להחשיב את הכתובת www.puPPes.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 באפליקציה שלך, אז טביעת האצבע לאישור שנוצרה על ידי הרצה של keytool או openssl באופן מקומי בדרך כלל לא תואמת לזו שבמכשירים של המשתמשים. בחשבון הפיתוח ב-Play Console אפשר לבדוק אם האפליקציה משמשת אותך בחתימת אפליקציה ב-Play. בקטע Release > Setup > App Integrity. אם כן, יופיע גם קטע הקוד הנכון של ה-JSON עם ה-Digital Asset Links באותו דף.

רשימת משפטים לדוגמה

הנה דוגמה לרשימת הצהרות אתר שמכילה הצהרות לגבי אתרים ואפליקציות: http://example.digitalassetlinks.org/.well-known/assetlinks.json

התאמה לעשרות הצהרות או יותר

בחלק מהמקרים, יכול להיות שחשבון המשתמש ירצה להצהיר הצהרות שונות ושונות על יעדים שונים, או שיהיה צורך להוציא הצהרות מחשבונות משתמשים שונים לאותה קבוצת יעדים. לדוגמה, יכול להיות שיש אתר זמין בכמה דומיינים שונים ברמה העליונה בכל מדינה, וכולם צריכים להצהיר על אותה אפליקציה לנייד.

במצבים כאלה, מומלץ לכלול הצהרות. באמצעות המנגנון הזה אפשר להגדיר מצביעות מחשבונות משתמשים שונים ומגוונים למיקום מרכזי אחד, שמגדיר הצהרות לכל חשבונות המשתמשים.

לדוגמה, יכול להיות שתרצו לקבוע שהמיקום המרכזי הוא https://example.com/includedstatements.json.json. אפשר להגדיר את הקובץ כך שיכלול את אותו התוכן כמו בדוגמאות שלמעלה.

כדי להגדיר מצביע מאתר אינטרנט לקובץ ה-include, צריך לשנות את הכתובת 'https://example.com/.well-known/assetlinks.json' כך:

[{
  "include": "https://example.com/includedstatements.json"
}]

כדי להגדיר מצביע מאפליקציה ל-Android לקובץ ה-include, משנים את 'res/values/strings.xml' כך:

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

מידע נוסף

במסמך המפרט שלנו יש הסבר מפורט יותר על הפורמט של רשימת דפי החשבון ועל המושגים הבסיסיים בשימוש.