Method: googleLocations.search

ابحث في جميع المواقع الجغرافية المحتمَلة التي تتطابق مع الطلب المحدَّد.

طلب HTTP

POST https://mybusiness.googleapis.com/v4/googleLocations:search

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

نص الطلب

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

تمثيل JSON 
{
  "resultCount": integer,

  // Union field search_query can be only one of the following:
  "location": {
    object (Location)
  },
  "query": string
  // End of list of possible types for union field search_query.
}
الحقول
resultCount

integer

عدد التطابقات المطلوب عرضها. القيمة التلقائية هي 3، بحد أقصى 10. يُرجى العِلم أنّ وقت الاستجابة قد يزيد إذا طُلِب المزيد. ليس هناك أي صفحات.
حقل الاتحاد search_query استعلام البحث. يمكن تقديم ذلك إما ككائن موقع أو كاستعلام سلسلة. يمكن أن تكون السمة "search_query" واحدة فقط مما يلي:
location

object (Location)

الموقع الجغرافي المطلوب البحث عنه. ستظهر المواقع الجغرافية التي تتطابق مع تفاصيل الموقع الجغرافي المقدَّمة، في حال توفّرها.
query

string

طلب بحث نصي للبحث عنه. ستكون نتائج البحث من سلسلة طلب البحث أقل دقة مما لو تم توفير موقع دقيق، ولكنها قد توفر المزيد من المطابقات غير الدقيقة.

نص الاستجابة

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

رسالة رد لـ GoogleLocations.SearchGoogleLocations.

تمثيل JSON 
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ]
}
الحقول
googleLocations[]

object (GoogleLocation)

مجموعة من GoogleLocations التي يُحتمل أن تكون مطابقة للطلب المحدّد، وقد تم إدراجها بالترتيب من الأكثر إلى الأقل دقة.

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

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

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.