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 REQUIRED
target object(Asset) تحتوي كل عبارة على مادة عرض مستهدفة. مطلوب

تجربة

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