إنشاء قائمة العبارات

تتم استضافة العبارات في قائمة عبارات مرمّزة بترميز JSON في موقع معروف على عنصر أساسي، وفقًا لما تنص عليه مواصفات روابط مواد العرض. تحتوي قائمة العبارات على عبارة واحدة أو أكثر، ويمكن أن يكون لدى المدير قائمة عبارات واحدة فقط.

بنية قائمة العبارات

راجِع بنية قائمة العبارات.

موقع قائمة كشوفات الحساب

قائمة العبارات مستضافة في موقع معروف يعتمد على نوع المستخدم الرئيسي (الموقع الإلكتروني أو التطبيق الذي يقدّم البيانات).

قوائم بيانات موقع الويب

قائمة الكشف على موقع الويب هي ملف نصي موجود على العنوان التالي:

scheme://domain/.well-known/assetlinks.json

سجِّل النقطة في اسم المجلد .well-known.

يتم التعامل مع أي استجابة من الخادم إلى جانب HTTP 200 على أنها خطأ، وسينتج عن ذلك قائمة عبارات فارغة. بالنسبة إلى HTTPS، سيؤدي أيضًا أي اتصال بدون سلسلة شهادات يمكن إثبات ملكيتها باستخدام قائمة الجذر الموثوق بها إلى قائمة عبارات فارغة.

مثال

في ما يلي مثال على قائمة كشوفات الحساب على موقع إلكتروني: http://example.digitalassetlinks.org/.well-known/assetlinks.json.

قوائم كشف حساب تطبيق Android

وفي تطبيق Android، تكون قائمة العبارات عبارة عن مقتطف JSON له البنية نفسها لملف بيان الموقع الإلكتروني، ولكنها مضمّنة في ملف items.xml، وتتم الإشارة إليها في البيان كما هو موضّح بعد ذلك.

في ملف AndroidManifest.xml:

<manifest>
  <application>
    ...
    <meta-data android:name="asset_statements" android:resource="@string/asset_statements" />
    ...
  </application>
</manifest>

في res/values/strings.xml:

<resources>
  ...
  <string name="asset_statements">
    ... statement list ...
  </string>
</resources>

مثال

في ما يلي مثال على مقتطف res/values/strings.xml لأحد تطبيقات Android التي تتيح مشاركة الموقع الجغرافي مع التطبيق (ميزة في Android غير متاحة حاليًا):

<resources>
    ...
    <string name="asset_statements">
      [{
        \"relation\": [\"delegate_permission/common.share_location\"],
        \"target\": {
          \"namespace\": \"web\",
          \"site\": \"https://example.com\"
        }
      }]
    </string>
</resources>

مطابقة هدف

تتناول كل عبارة هدفًا. عند استخدام عبارة، يجب مطابقة الهدف في عبارة مقابل كيان معيّن. في حالة تطابق هدف العبارة مع الكيان، يتم تطبيق العبارة. في ما يلي قواعد تحديد ما إذا كان الاستهداف يتطابق مع كيان معيّن:

استهدافات المواقع الإلكترونية

بالنسبة إلى الموقع الإلكتروني، يجب أن يتطابق مخطط الموقع ومضيفه ومنفذه تمامًا. يُفترض بشكل ضمني المنافذ الافتراضية لـ HTTP وHTTPS (80 و443 على التوالي)؛ إذا كانت هدف العبارة يصف http://www.example.com:80، يُعتبر الموقع الإلكتروني http://www.example.com مطابقًا.

مثال

استنادًا إلى هدف العبارة التالي

"target": {
  "namespace": "web",
  "site": "https://www.google.com"
}

سوف تتطابق معرِّفات الموارد المنتظمة (URI) التالية:

• https://www.google.com/
• https://www.google.com:443/
• https://www.google.com/foo
• https://www.google.com/foo?bar
• https://www.google.com/foo#bar
• https://user@password:www.google.com/

لن تتطابق عناوين URL التالية:

• http://www.google.com/ (مخطط خاطئ)
• https://google.com/ (اسم المضيف غير متطابق)
• https://www.google.com:444/ (المنفذ غير متطابق)

استهدافات التطبيقات

بالنسبة إلى التطبيقات، يجب أن تتطابق تجزئة الشهادة واسم حزمة الهدف مع التطبيق.