تمت ترجمة هذه الصفحة بواسطة 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"
}
```
namespace

يجب أن يكون 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"]
}
```
namespace

يجب أن يكون 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 لتطبيقك في حساب المطوِّر الخاص بك على Play Console ضمن Release > Setup > App Integrity. وفي حال إجراء ذلك، ستجد أيضًا مقتطف JSON الصحيح لروابط مواد العرض الرقمية الخاصة بتطبيقك في الصفحة نفسها.

أمثلة على قائمة العبارات

في ما يلي مثال على قائمة عبارات الموقع الإلكتروني التي تتضمّن بيانات حول المواقع الإلكترونية والتطبيقات: 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>

مزيد من المعلومات

يتوفر شرح أكثر تفصيلاً لتنسيق قائمة العبارات والمفاهيم الأساسية في مستند المواصفات.