هر بیانیه ای با در نظر گرفتن یک مصرف کننده طراحی شده است. مصرف کننده بیانیه کسی است که بیانیه ای را که توسط یک مدیر صادر شده است را می خواند و تأیید می کند، سپس بر اساس آن بیانیه اقدام می کند. به طور خاص، مصرف کننده این مراحل اساسی را انجام می دهد:
- لیست بیانیه را از یک مدیر خاص درخواست کنید
- بررسی کنید که آیا لیست حاوی یک عبارت معین در برابر یک هدف معین است یا خیر
- تأیید کنید که هدف در بیانیه هدف (وب‌سایت یا برنامه) است که فکر می‌کنید همان است
- در صورت تمایل، عمل مشخص شده توسط عبارت را انجام دهید
بسیاری از موارد استفاده از بیانیه ها برای شما در پشت صحنه استفاده می کنند. به عنوان مثال، Android App Linking، بیانیه‌های مجوز پیوند را که توسط یک وب‌سایت ایجاد شده است مصرف می‌کند تا پیوندها را مستقیماً به یک برنامه فعال کند. یک برنامه نشان می‌دهد که با افزودن کد ویژه (یک کنترل‌کننده قصد) در مانیفست خود، موافقت می‌کند که هدف چنین عباراتی باشد.
می‌توانید مراحل 1 و 2 بالا - درخواست و تأیید یک بیانیه - را به دو روش انجام دهید: با استفاده از API ما یا به صورت دستی (با استفاده از پیاده‌سازی خودتان).
مصرف بیانیه ها با استفاده از Digital Asset Links API
Digital Asset Links API از دو روش پشتیبانی می کند: Check() و List() برای یافتن یا اعتبارسنجی عبارات:
-
Check()یک منبع، هدف و رابطه را می گیرد و تأیید می کند که منبع بیانیه ارسال شده در مورد هدف را ارائه می دهد. -
List()تمام عبارات ساخته شده توسط یک منبع معین را فهرست می کند.
مصرف دستی بیانیه ها
پروتکل Digital Asset Links باز است، بنابراین می توانید پیاده سازی آن را برای خود ایجاد کنید.
برای مصرف عبارات ساخته شده توسط وب سایت ها ، می توانید یک درخواست HTTP GET برای لیست بیانیه مربوطه داشته باشید و خودتان آن را تجزیه کنید. برای مثال، فهرست بیانیه مربوط به وب سایت http://example.digitalassetlinks.org در http://example.digitalassetlinks.org/.well-known/assetlinks.json است.
برای استفاده از اظهارات ارائه شده توسط برنامه های Android ، باید به مانیفست بسته APK مربوطه دسترسی داشته باشید. در دستگاه های اندرویدی، این کار را می توان با استفاده از رابط PackageManager انجام داد.
لطفاً به معانی خاص بیانیه های پیوندهای دارایی دیجیتال توجه ویژه ای داشته باشید. اگر مطمئن نیستید به مشخصات پیوندهای دارایی مراجعه کنید.