مصرف بیانیه

هر بیانیه ای با در نظر گرفتن یک مصرف کننده طراحی شده است. مصرف کننده بیانیه کسی است که بیانیه ای را که توسط یک مدیر صادر شده است را می خواند و تأیید می کند، سپس بر اساس آن بیانیه اقدام می کند. به طور خاص، مصرف کننده این مراحل اساسی را انجام می دهد:

1. لیست بیانیه را از یک مدیر خاص درخواست کنید
2. بررسی کنید که آیا لیست حاوی یک عبارت معین در برابر یک هدف معین است یا خیر
3. تأیید کنید که هدف در بیانیه هدف (وب‌سایت یا برنامه) است که فکر می‌کنید همان است
4. در صورت تمایل، عمل مشخص شده توسط عبارت را انجام دهید

بسیاری از موارد استفاده از بیانیه ها برای شما در پشت صحنه استفاده می کنند. به عنوان مثال، Android App Linking، بیانیه‌های مجوز پیوند را که توسط یک وب‌سایت ایجاد شده است مصرف می‌کند تا پیوندها را مستقیماً به یک برنامه فعال کند. یک برنامه نشان می‌دهد که با افزودن کد ویژه (یک کنترل‌کننده قصد) در مانیفست خود، موافقت می‌کند که هدف چنین عباراتی باشد.

مطمئن شوید که سناریوی شما مکانیسم خاصی برای مصرف یا اجرای یک عبارت ندارد قبل از اینکه به صورت دستی آن را مدیریت کنید.

می‌توانید مراحل 1 و 2 بالا - درخواست و تأیید یک بیانیه - را به دو روش انجام دهید: با استفاده از API ما یا به صورت دستی (با استفاده از پیاده‌سازی خودتان).

مصرف بیانیه ها با استفاده از Digital Asset Links API

Digital Asset Links API از دو روش پشتیبانی می کند: Check() و List() برای یافتن یا اعتبارسنجی عبارات:

• Check() یک منبع، هدف و رابطه را می گیرد و تأیید می کند که منبع بیانیه ارسال شده در مورد هدف را ارائه می دهد.
• List() تمام عبارات ساخته شده توسط یک منبع معین را فهرست می کند.

برای استفاده از API، به یک کلید API نیاز دارید و ابتدا باید API را برای پروژه خود فعال کنید. برای انجام این کار، این مراحل را دنبال کنید:

1. به Google Developers Console بروید.

   ممکن است کنسول از شما بخواهد که ابتدا وارد سیستم شوید.

2. یک پروژه را انتخاب یا ایجاد کنید.

   اگر چندین پروژه دارید، مطمئن شوید که در پروژه ای هستید که می خواهید Digital Asset Links API را برای آن فعال کنید و روی Continue کلیک کنید. یا اگر پروژه ای ندارید، Create a new project را انتخاب کنید و روی Create کلیک کنید.

3. در نمای کلی Digital Asset Links API، روی Enable API کلیک کنید.

   اگر API از قبل برای پروژه شما فعال شده باشد، Disable API را مشاهده خواهید کرد.

4. در منوی سمت چپ، روی Credentials کلیک کنید و یک کلید API را انتخاب یا ایجاد کنید.

   اطلاعات بیشتر در مورد ایجاد کلیدهای API .

مصرف دستی بیانیه ها

پروتکل Digital Asset Links باز است، بنابراین می توانید پیاده سازی آن را برای خود ایجاد کنید.

برای مصرف عبارات ساخته شده توسط وب سایت ها ، می توانید یک درخواست HTTP GET برای لیست بیانیه مربوطه داشته باشید و خودتان آن را تجزیه کنید. برای مثال، فهرست بیانیه مربوط به وب سایت http://example.digitalassetlinks.org در http://example.digitalassetlinks.org/.well-known/assetlinks.json است.

برای استفاده از اظهارات ارائه شده توسط برنامه های Android ، باید به مانیفست بسته APK مربوطه دسترسی داشته باشید. در دستگاه های اندرویدی، این کار را می توان با استفاده از رابط PackageManager انجام داد.

لطفاً به معانی خاص بیانیه های پیوندهای دارایی دیجیتال توجه ویژه ای داشته باشید. اگر مطمئن نیستید به مشخصات پیوندهای دارایی مراجعه کنید.