- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- SuggestResult
- QuerySuggestion
- PeopleSuggestion
- جرِّبه الآن
يوفّر هذا الخيار اقتراحات لإكمال طلب البحث تلقائيًا.
ملاحظة: تتطلّب واجهة برمجة التطبيقات هذه توفّر حساب مستخدم نهائي عادي للتنفيذ. لا يمكن لحساب الخدمة تنفيذ طلبات البيانات من واجهة برمجة التطبيقات لطلب البحث مباشرةً. ولاستخدام حساب خدمة لتنفيذ الطلبات، عليك إعداد تفويض مرجع على مستوى نطاق Google Workspace.
طلب HTTP
POST https://cloudsearch.googleapis.com/v1/query/suggest
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "requestOptions": { object ( |
الحقول | |
---|---|
requestOptions |
خيارات الطلب، مثل تطبيق البحث والمنطقة الزمنية للمستخدم. |
query |
طلب بحث جزئي سيتم عرض اقتراحات الإكمال التلقائي له. على سبيل المثال، إذا كان طلب البحث هو "البحر"، فقد يعرض الخادم الكلمات "موسم" و"بحث" و"طائر النورس" وما إلى ذلك. |
dataSourceRestrictions[] |
المصادر المطلوب استخدامها للاقتراحات. وإذا لم يتم تحديد مصادر البيانات، يتم الحصول عليها من تطبيق البحث الحالي. ملاحظة: يتم دعم الاقتراحات فقط للمصادر التالية:
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رد واجهة برمجة التطبيقات للاقتراح
تمثيل JSON |
---|
{
"suggestResults": [
{
object ( |
الحقول | |
---|---|
suggestResults[] |
قائمة بالاقتراحات |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/cloud_search.query
https://www.googleapis.com/auth/cloud_search
لمزيد من المعلومات، راجِع دليل التفويض.
SuggestResult
نتيجة اقتراح واحدة
تمثيل JSON |
---|
{ "suggestedQuery": string, "source": { object ( |
الحقول | |
---|---|
suggestedQuery |
طلب البحث المقترح الذي سيتم استخدامه للبحث، عندما ينقر المستخدم على الاقتراح |
source |
مصدر الاقتراح. |
حقل الاتحاد suggestion يحتوي على بيانات وصفية إضافية حول طلب البحث المقترَح. كما يشير أيضًا إلى نوع طلب البحث المقترح. على سبيل المثال، إذا كانت ميزة PeopleSuggestion موجودة، فإنها تشير إلى أن suggested_query هي عبارة عن اقتراح شخص. يمكن أن تكون السمة "suggestion " واحدة فقط مما يلي: |
|
querySuggestion |
سيكون هذا الحقل موجودًا إذا كان طلب البحث المقترح عبارة عن إكمال كلمة أو عبارة. |
peopleSuggestion |
وتكون موجودة عندما يشير الاقتراح إلى شخص. يحتوي هذا الإشعار على مزيد من المعلومات عن الشخص - مثل معرّف البريد الإلكتروني والاسم وما إلى ذلك. |
QuerySuggestion
لا يحتوي هذا الحقل على أي شيء اعتبارًا من الآن، وهو يُستخدم فقط كمؤشر على أن نتيجة الاقتراح كانت عبارة عن إكمال عبارة.
PeopleSuggestion
يحتوي هذا الحقل على معلومات حول المستخدم المقترَح.
تمثيل JSON |
---|
{
"person": {
object ( |
الحقول | |
---|---|
person |
الشخص المُقترَح: قد لا تتم تعبئة كل حقول عنصر الشخص. |