يشير إلى الاستطلاعات للعناصر غير المحجوزة من قائمة انتظار الفهرسة ووضع علامة على مجموعة باعتبارها محجوزة، بدءًا من العناصر التي لها أقدم طابع زمني من ItemStatus
ذات الأولوية القصوى. في ما يلي ترتيب الأولويات:
يضمن الاحتفاظ بالعناصر أن الاستقصاء من سلاسل التعليمات الأخرى لا يمكن أن يُنشئ مجموعات متداخلة.
بعد معالجة السلع المحجوزة، على العميل إعادة السلع إلى حالة "غير محجوزة"، إما من خلال الاتصال بـ index,
أو من خلال طلب الرقم push
بالنوع REQUEUE.
.
تصبح السلع متوفّرة تلقائيًا (غير محجوزة) بعد 4 ساعات حتى في حال عدم طلب طريقة تعديل أو دفع.
تتطلّب واجهة برمجة التطبيقات هذه مشرفًا أو حساب خدمة لتنفيذها. حساب الخدمة المستخدَم هو حساب الخدمة المُضافة إلى القائمة البيضاء في مصدر البيانات المقابل.
طلب HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*}/items:poll
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
اسم مصدر البيانات لاستطلاع العناصر. التنسيق: مصادر البيانات/{sourceId} |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "connectorName": string, "statusCodes": [ enum ( |
الحقول | |
---|---|
connectorName |
اسم الموصّل الذي يجري هذا الاستدعاء. التنسيق: datasources/{sourceId}/connectors/{ID} |
statusCodes[] |
يمكنك قصر العناصر التي تم استطلاع استطلاعاتها على تلك التي لها هذه الحالات. |
limit |
الحدّ الأقصى لعدد السلع المطلوب إرجاعها الحد الأقصى للقيمة هو 100 والقيمة التلقائية هي 20. |
queue |
اسم قائمة الانتظار المطلوب جلب العناصر منها. في حال عدم تحديد ذلك، سيتم جلب items.poll من قائمة الانتظار "default". الحدّ الأقصى لعدد الأحرف المسموح به هو 100 حرف. |
debugOptions |
خيارات تصحيح الأخطاء الشائعة |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"items": [
{
object ( |
الحقول | |
---|---|
items[] |
مجموعة عناصر من قائمة الانتظار المتاحة للموصِّل للمعالجة. تحتوي هذه العناصر على المجموعة الفرعية التالية من الحقول التي تمت تعبئتها: |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
لمزيد من المعلومات، راجِع دليل التفويض.