يتم تصميم كل عبارة مع وضع المستهلك في الاعتبار. والمستهلك هو الشخص الذي يقرأ ويتحقق من العبارة التي يصدرها المدير الأساسي، ثم يتخذ إجراءً بناءً على هذه العبارة. وبشكل أكثر تحديدًا، ينفذ المستهلك هذه الخطوات الأساسية:
- طلب قائمة الكشف من مدير معين
- التحقق لمعرفة ما إذا كانت القائمة تحتوي على عبارة معينة مقابل هدف معين
- تحقق من أن الهدف في العبارة هو الهدف (الموقع الإلكتروني أو التطبيق) الذي تعتقد أنه
- نفِّذ الإجراء المحدد في العبارة، إذا اخترت
تؤدي العديد من حالات الاستخدام إلى استهلاك البيانات لك من وراء الكواليس. على سبيل المثال، تستهلك ميزة "ربط تطبيق Android" بيانات أذونات الروابط التي أصدرها الموقع الإلكتروني لتفعيل الروابط مباشرةً في التطبيق. ويشير التطبيق إلى موافقة التطبيق على أن يكون مستهدفًا لأي من هذه العبارات من خلال إضافة رمز خاص (معالج intent) في ملف البيان الخاص به.
يمكنك تنفيذ الخطوتين 1 و2 أعلاه، وهما طلب بيان وإثبات صحته بطريقتَين، هما: استخدام واجهة برمجة التطبيقات الخاصة بنا أو إجراء يدوي (باستخدام عملية التنفيذ الخاصة بك).
عرض البيانات باستخدام واجهة Digital Asset Links API
تتيح واجهة Digital Asset Links API استخدام طريقتَين: Check() وList() للعثور على العبارات أو التحقّق من صحتها:
- تحصل الدالة
Check()على المصدر والاستهداف والعلاقة وتتحقّق من أنّ المصدر يقدّم البيان الذي تم إرساله حول الهدف. - تتضمّن السمة
List()جميع العبارات التي وردت من مصدر معيّن.
استخدام العبارات يدويًا
بروتوكول "روابط مواد العرض الرقمية" مفتوح، لذا يمكنك تنفيذه بنفسك.
للاطّلاع على العبارات التي تم إنشاؤها من خلال المواقع الإلكترونية، يمكنك إنشاء طلب HTTP GET لقائمة العبارات المقابلة وتحليله بنفسك. على سبيل المثال، تتوفّر قائمة كشف الحساب المطابِقة للموقع الإلكتروني http://example.digitalassetlinks.org في http://example.digitalassetlinks.org/.well-known/assetlinks.json.
للاطّلاع على البيانات الصادرة عن تطبيقات Android، عليك الوصول إلى بيان حزمة APK المقابلة. على أجهزة Android، يمكن تنفيذ ذلك باستخدام واجهة PackageManager.
يُرجى الانتباه بشكل خاص إلى المعاني المحددة لعبارات "روابط مواد العرض الرقمية". راجِع مواصفات روابط مواد العرض إذا لم تكن متأكدًا من ذلك.