Method: debug.datasources.items.searchByViewUrl

يجلب العنصر الذي يتطابق عنوان URL الخاص به تمامًا مع عنوان URL المقدَّم في الطلب.

ملاحظة: تتطلّب واجهة برمجة التطبيقات هذه حساب مشرف ليتم تنفيذها.

طلب HTTP

POST https://cloudsearch.googleapis.com/v1/debug/{name=datasources/*}/items:searchByViewUrl

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
name

string

اسم المصدر، التنسيق: datasources/{sourceId}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "viewUrl": string,
  "pageToken": string,
  "debugOptions": {
    object (DebugOptions)
  }
}
الحقول
viewUrl

string

حدد عنوان URL للعرض الكامل للبحث عن العنصر المقابل. الحد الأقصى لعدد الأحرف هو 2048 حرفًا.
pageToken

string

القيمة nextPageToken التي يتم عرضها من طلب سابق، إن وجدت.
debugOptions

object (DebugOptions)

خيارات تصحيح الأخطاء الشائعة

نص الاستجابة

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

تمثيل JSON 
{
  "items": [
    {
      object (Item)
    }
  ],
  "nextPageToken": string
}
الحقول
items[]

object (Item)
nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج، أو يكون فارغًا إذا لم تكن هناك نتائج أخرى في القائمة.

نطاقات الأذونات

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/cloud_search.debug
  • https://www.googleapis.com/auth/cloud_search

لمزيد من المعلومات، راجِع دليل التفويض.