Method assetlinks.check

تعیین می کند که آیا رابطه مشخص (جهت دار) بین منبع مشخص شده و دارایی هدف وجود دارد یا خیر.

این رابطه هدف از پیوند بین دو دارایی را همانطور که توسط دارایی منبع ادعا شده است، توصیف می کند. نمونه ای برای چنین روابطی تفویض امتیازات یا مجوزها است.

این دستور اغلب توسط سیستم های زیرساخت برای بررسی پیش شرط های یک اقدام استفاده می شود. به عنوان مثال، یک مشتری ممکن است بخواهد بداند که آیا ارسال URL وب به یک برنامه تلفن همراه خاص مشکلی ندارد یا خیر. مشتری می تواند پیوند دارایی مربوطه را از وب سایت به برنامه تلفن همراه بررسی کند تا تصمیم بگیرد که آیا عملیات باید مجاز باشد یا خیر.

نکته ای در مورد امنیت: اگر یک دارایی ایمن را به عنوان منبع مشخص کنید، مانند یک وب سایت HTTPS یا یک برنامه Android، API اطمینان حاصل می کند که هر عباراتی که برای ایجاد پاسخ استفاده می شود به روشی ایمن توسط مالک آن دارایی بیان شده است. . برعکس، اگر دارایی منبع یک وب‌سایت HTTP ناامن باشد (یعنی نشانی اینترنتی به جای https:// با http:// شروع می‌شود)، API نمی‌تواند اظهارات آن را به‌طور ایمن تأیید کند، و نمی‌توان از بیانیه‌های وب‌سایت اطمینان حاصل کرد. توسط شخص ثالث تغییر داده نشده است. برای اطلاعات بیشتر، مشخصات طراحی فنی پیوندهای دارایی دیجیتال را ببینید.

درخواست HTTP

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

پارامترهای پرس و جو

نام پارامتر تایپ کنید شرح
source object( Asset ) منبع میزبان لیست بیانیه. این برای هدایت فراخوانی Check() به منبع مناسب استفاده می شود.
relation string

رشته پرس و جو برای رابطه.

ما روابط را با رشته‌هایی با قالب <kind>/<detail> شناسایی می‌کنیم، که در آن <kind> باید یکی از مجموعه‌ای از مقوله‌های هدف از پیش تعریف شده باشد، و <detail> یک رشته حروف عددی با حروف کوچک آزاد است که کاربرد خاص را توصیف می‌کند. مورد بیانیه

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

برای اینکه یک پرس و جو با پیوند دارایی مطابقت داشته باشد، هر دو رشته رابطه پرس و جو و پیوند دارایی باید دقیقاً مطابقت داشته باشند.

مثال: یک پرس و جو با رابطه delegate_permission/common.handle_all_urls پیوند دارایی را با رابطه delegate_permission/common.handle_all_urls می دهد.

target object( Asset ) دارایی هدف بیانیه.

درخواست بدن

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

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پیام پاسخ برای تماس CheckAssetLinks.

نمایندگی JSON
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
نام زمینه تایپ کنید شرح
linked boolean اگر دارایی های مشخص شده در درخواست با رابطه مشخص شده در درخواست به هم مرتبط باشند، روی true تنظیم کنید. ضروری
maxAge string

از زمان ارائه، چه مدت دیگر پاسخ باید معتبر در نظر گرفته شود و به‌روزرسانی‌های بیشتر ممنوع شود. ضروری

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' خاتمه می یابد. مثال: "3.5s" .

debugString string

پیام قابل خواندن توسط انسان حاوی اطلاعاتی است که برای کمک به کاربران نهایی در درک، بازتولید و اشکال زدایی نتیجه است.

پیام به زبان انگلیسی خواهد بود و ما در حال حاضر قصد نداریم ترجمه ای ارائه دهیم.

لطفاً توجه داشته باشید که هیچ تضمینی در مورد محتوا یا قالب این رشته وجود ندارد. هر جنبه ای از آن ممکن است بدون اطلاع قبلی تغییر کند. شما نباید سعی کنید این داده ها را به صورت برنامه نویسی تجزیه کنید. اگر احساس می کنید که باید این کار را انجام دهید زیرا اطلاعات مورد نیاز شما توسط API در معرض دید دیگری قرار نمی گیرد، لطفاً ابتدا با ما تماس بگیرید.

آن را امتحان کنید!

از APIs Explorer برای فراخوانی این روش روی داده های زنده و دیدن پاسخ استفاده کنید.