Method statements.list

لاسترداد قائمة بجميع العبارات من مصدر معين تطابق السلسلة المحددة للهدف والعبارة.

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

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

طلب HTTP

GET https://digitalassetlinks.googleapis.com/v1/statements:list

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

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

استخدِم فقط الارتباطات التي تتطابق مع العلاقة المحدّدة.

يمكنك الاطِّلاع على رسالة Statement للحصول على تعريف تفصيلي لسلاسل العلاقات.

لكي يطابق طلب البحث عبارة، يجب أن يكون أي مما يلي صحيحًا:

  • كل من سلاسل علاقة طلب البحث وعبارة المطابقة التامة، أو
  • سلسلة علاقة طلب البحث فارغة أو ناقصة.

مثال: يتطابق طلب البحث ذو العلاقة delegate_permission/common.handle_all_urls مع رابط مادة عرض ذو صلة delegate_permission/common.handle_all_urls.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

رسالة رد على مكالمة القائمة.

تمثيل JSON 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
اسم الحقل النوع الوصف
statements[] object(Statement) قائمة بكل العبارات المطابقة التي تم العثور عليها.
maxAge string

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

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

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

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

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

العبارات

يصف بيانًا موثوقًا به تم إجراؤه حول العلاقة بين مادة العرض المصدر ومادة العرض المستهدفة.

يتم إعداد كشوفات الحساب دائمًا بواسطة مادة العرض المصدر، إما بشكل مباشر أو من خلال تفويض إلى قائمة كشوفات الحساب المخزنة في مكان آخر.

للحصول على تعريفات أكثر تفصيلاً للبيانات ومواد العرض، يُرجى الرجوع إلى الصفحة المقصودة لوثائق واجهة برمجة التطبيقات.

تمثيل JSON 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
اسم الحقل النوع الوصف
source object(Asset) لكل كشف مادة عرض مصدر. مطلوب
relation string

تحدد العلاقة استخدام العبارة على النحو المقصود من قِبل مالك مادة العرض المصدر (أي الشخص أو الكيان الذي أصدر العبارة). لكل بيان كامل علاقة.

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

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

مثال: delegate_permission/common.handle_all_urls مطلوب
target object(Asset) لكل كشف مادة عرض مستهدفة. مطلوب

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

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