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

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

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

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

تجربة

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