Method assetlinks.check

لتحديد ما إذا كانت العلاقة المحددة (الاتجاهية) موجودة بين مواد العرض المصدر والهدف المحددة.

توضح العلاقة القصد من الرابط بين مادتي العرض كما هو مطلوب في مادة العرض المصدر. ومن أمثلة هذه العلاقات تفويض الامتيازات أو الأذونات.

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

ملاحظة حول الأمان: إذا حدّدت مادة عرض آمنة باعتبارها مصدرًا، مثل موقع إلكتروني يستخدم بروتوكول HTTPS أو تطبيقًا متوافقًا مع Android، ستضمن واجهة برمجة التطبيقات أنّ أي بيانات مستخدَمة لإنشاء الرد قد أدلى بها مالك مادة العرض تلك بطريقة آمنة. وبالعكس، إذا كانت مادة العرض المصدر عبارة عن موقع إلكتروني غير آمن يستخدم بروتوكول HTTP (أي أن عنوان URL يبدأ بالبادئة http:// بدلاً من https://)، يتعذّر على واجهة برمجة التطبيقات التحقّق من بياناتها بشكل آمن، ولا يمكن ضمان عدم تغيير بيانات الموقع الإلكتروني من قِبل جهة خارجية. ولمزيد من المعلومات، يمكنك الاطّلاع على مواصفات التصميم الفني لروابط مواد العرض الرقمية.

طلب HTTP

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

معامِلات طلب البحث

اسم المعلَمة النوع الوصف
source object(Asset) المصدر الذي يستضيف قائمة العبارات. يُستخدم هذا الخيار لتوجيه استدعاء Check() إلى المصدر الصحيح.
relation string

سلسلة طلب البحث للعلاقة.

نحدّد العلاقات باستخدام سلاسل بالتنسيق <kind>/<detail>، حيث يجب أن تكون <kind> واحدة من مجموعة فئات الأغراض المحددة مسبقًا، و<detail> عبارة عن سلسلة أبجدية رقمية صغيرة حرة الشكل تصف حالة الاستخدام المحددة للعبارة.

ارجع إلى وثائق واجهة برمجة التطبيقات للاطّلاع على القائمة الحالية للعلاقات المتوافقة.

ولكي يتطابق طلب البحث مع رابط مادة عرض، يجب أن تتطابق كلٌّ من سلاسل علاقة طلب البحث ورابط رابط مادة العرض تمامًا.

مثال: يتطابق طلب البحث ذو العلاقة 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 يمكنك ضبط هذه القيمة على "صحيح" إذا كانت الأصول المحدّدة في الطلب مرتبطة بالعلاقة المحدّدة في الطلب. مطلوب
maxAge string

من وقت العرض، إلى أي مدى يجب اعتبار الاستجابة صالحة لمنع إجراء المزيد من التحديثات. مطلوب

عبارة عن مدة بالثواني تحتوي على ما يصل إلى تسعة أرقام كسرية، ويتم إنهاؤها بـ "s". مثال: "3.5s".
debugString string

رسالة يمكن للمستخدمين قراءتها وتحتوي على معلومات تهدف إلى مساعدة المستخدمين النهائيين على فهم النتيجة وإعادة إنتاجها وتصحيح الأخطاء فيها.

ستكون الرسالة باللغة الإنجليزية، ولا نخطط حاليًا لتقديم أي ترجمات.

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

جرِّب هذه الميزة الآن.

استخدِم مستكشف واجهات برمجة التطبيقات لاستدعاء هذه الطريقة في البيانات المباشرة والاطّلاع على الاستجابة.