استخدام عبارة

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

  1. طلب قائمة كشوفات الحساب من مدير مدرسة معيّن
  2. التحقق لمعرفة ما إذا كانت القائمة تحتوي على عبارة معينة مقابل هدف محدد
  3. تحقق من أن الهدف في العبارة هو الهدف (موقع الويب أو التطبيق) الذي تعتقد أنه
  4. نفّذ الإجراء المحدّد في البيان، إذا اخترت

كثير من حالات الاستخدام يستخدم عبارات لك خلف الكواليس. على سبيل المثال، تستخدم ميزة "ربط تطبيقات Android" بيانات أذونات الروابط التي يتم تقديمها من قِبل موقع إلكتروني لتفعيل الروابط مباشرةً في أحد التطبيقات. ويشير أحد التطبيقات إلى أنه يوافق على أن يكون هدفًا لأي من هذه العبارات عن طريق إضافة رمز خاص (معالج intent) في ملف البيان.

يمكنك تنفيذ الخطوتين 1 و2 أعلاه — طلب بيان والتحقق من صحته — بطريقتين: باستخدام واجهة برمجة التطبيقات أو يدويًا (باستخدام عملية التنفيذ الخاصة بك).

حساب البيانات باستخدام واجهة برمجة تطبيقات روابط مواد العرض الرقمية

تتيح واجهة برمجة تطبيقات روابط مواد العرض الرقمية استخدام طريقتين: Check() وList() للعثور على كشوفات الحساب أو التحقّق من صحتها:

  • تأخذ Check() المصدر والهدف والعلاقة وتتحقق من أن المصدر يُصدر العبارة المقدّمة حول الهدف.
  • تسرد القائمة List() كل البيانات التي أجراها مصدر معيّن.

استهلاك البيانات يدويًا

بروتوكول روابط مواد العرض الرقمية مفتوح، لذا يمكنك إنشاء عملية تنفيذ له بنفسك.

للاطّلاع على العبارات التي تقدّمها مواقع الويب، يمكنك تقديم طلب HTTP GET لقائمة العبارات المناسبة وتحليلها بنفسك. على سبيل المثال، تكون قائمة البيان المقابل لموقع الويب http://example.digitalassetlinks.org في http://example.digitalassetlinks.org/.well-known/assetlinks.json.

للاطّلاع على البيانات التي تقدّمها تطبيقات Android، عليك الوصول إلى ملف بيان حزمة APK المقابلة لها. على أجهزة Android، يمكن تنفيذ ذلك باستخدام واجهة PackageManager.

يُرجى الانتباه بشكل خاص إلى المعاني المحددة لكشوفات روابط مواد العرض الرقمية. راجع مواصفات روابط مواد العرض إذا لم تكن متأكدًا.