تعديلات Item
قائمة التحكّم بالوصول والبيانات الوصفية والمحتوى سيتم إدراج Item
إذا لم يكن متوفّرًا. لا تتيح هذه الطريقة إجراء تعديلات جزئية. يتم محو الحقول التي لا تحتوي على قيم في فهرس Cloud Search.
تتطلّب واجهة برمجة التطبيقات هذه حساب مشرف أو حساب خدمة لتنفيذها. حساب الخدمة المستخدَم هو الحساب المدرَج في القائمة المسموح بها في مصدر البيانات المقابل.
طلب HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{item.name=datasources/*/items/*}:index
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
item.name |
اسم السلعة. التنسيق: datasources/{sourceId}/items/{itemId} هذا الحقل إلزامي. الحد الأقصى للطول هو 1536 حرفًا. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "item": { "name": string, "acl": { "inheritAclFrom": string, "aclInheritanceType": enum ( |
الحقول | |
---|---|
item.acl |
قائمة التحكّم في الوصول لهذا العنصر |
item.metadata |
معلومات البيانات الوصفية |
item.structuredData |
البيانات المنظَّمة للعنصر التي يجب أن تتوافق مع تعريف كائن مسجَّل في مخطّط مصدر البيانات |
item.content |
محتوى العنصر الذي سيتم فهرسته وتحويله إلى نص قابل للبحث |
item.version |
مطلوب. يخزِّن نظام الفهرسة الإصدار من مصدر البيانات كسلسلة من وحدات البايت ويقارن إصدار السلعة في الفهرس بإصدار السلعة في "قائمة الانتظار" باستخدام الترتيب المعجمي. لن يفهرس محرّك بحث Cloud Search أو يحذف أي عنصر في "قائمة الانتظار" إذا كانت قيمة الإصدار أقل من أو مساوية لقيمة الإصدار للعنصر المفهرَس حاليًا. الحد الأقصى لطول هذا الحقل هو 1024 بايت. للحصول على معلومات عن كيفية تأثير إصدار العنصر في عملية الحذف، يُرجى الرجوع إلى مقالة معالجة المراجعات بعد عمليات الحذف اليدوي. سلسلة بترميز base64 |
item.status |
حالة العنصر. حقل للإخراج فقط |
item.queue |
قائمة المحتوى التي ينتمي إليها هذا العنصر. الحد الأقصى للطول هو 100 حرف. |
item.payload |
يمكن لموصّل الحالة الإضافي تخزين هذا العنصر. الحد الأقصى للطول هو 10,000 بايت. سلسلة بترميز base64 |
item.itemType |
نوع هذا العنصر |
connectorName |
اسم الموصِّل الذي يُجري هذا الطلب التنسيق: datasources/{sourceId}/connectors/{ID} |
mode |
مطلوب. وضع الطلب لهذا الطلب. |
debugOptions |
خيارات تصحيح الأخطاء الشائعة |
indexItemOptions |
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation
.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/cloud_search.indexing
https://www.googleapis.com/auth/cloud_search
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
IndexItemOptions
تمثيل JSON |
---|
{ "allowUnknownGsuitePrincipals": boolean } |
الحقول | |
---|---|
allowUnknownGsuitePrincipals |
تُحدِّد ما إذا كان طلب الفهرسة يجب أن يسمح بمستخدمي Google Workspace الأساسيين غير المتوفّرين أو المحذوفين. |