ابحث في جميع المواقع الجغرافية المحتمَلة التي تتطابق مع الطلب المحدَّد.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/googleLocations:search
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "resultCount": integer, // Union field |
الحقول | ||
---|---|---|
resultCount |
عدد التطابقات المطلوب عرضها. القيمة التلقائية هي 3، بحد أقصى 10. يُرجى العِلم أنّ وقت الاستجابة قد يزيد إذا طُلِب المزيد. ليس هناك أي صفحات. |
|
حقل الاتحاد search_query استعلام البحث. يمكن تقديم ذلك إما ككائن موقع أو كاستعلام سلسلة. يمكن أن تكون السمة "search_query " واحدة فقط مما يلي: |
||
location |
الموقع الجغرافي المطلوب البحث عنه. ستظهر المواقع الجغرافية التي تتطابق مع تفاصيل الموقع الجغرافي المقدَّمة، في حال توفّرها. |
|
query |
طلب بحث نصي للبحث عنه. ستكون نتائج البحث من سلسلة طلب البحث أقل دقة مما لو تم توفير موقع دقيق، ولكنها قد توفر المزيد من المطابقات غير الدقيقة. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة رد لـ GoogleLocations.SearchGoogleLocations.
تمثيل JSON | |
---|---|
{
"googleLocations": [
{
object ( |
الحقول | |
---|---|
googleLocations[] |
مجموعة من GoogleLocations التي يُحتمل أن تكون مطابقة للطلب المحدّد، وقد تم إدراجها بالترتيب من الأكثر إلى الأقل دقة. |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.