يُرجى إدراج جميع GoogleLocation
التي تمت التوصية بها لحساب "الملف التجاري" المحدّد. يتم تقديم اقتراحات للحسابات الشخصية ومجموعات المواقع الجغرافية فقط، وستؤدي الطلبات إلى جميع أنواع الحسابات الأخرى إلى حدوث خطأ. تستند اقتراحات مجموعات المواقع الجغرافية إلى المواقع الجغرافية في تلك المجموعة.
تستند اقتراحات الحسابات الشخصية إلى جميع المواقع الجغرافية التي يمكن للمستخدم الوصول إليها في "الملف التجاري" (بما في ذلك المواقع الجغرافية التي يمكنه الوصول إليها من خلال مجموعات المواقع الجغرافية)، وهي مجموعة رئيسية من جميع الاقتراحات التي تم إنشاؤها للمستخدم.
طلب HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
name |
اسم مورد الحساب المطلوب استرجاع مواقع Google الجغرافية المقترَحة له. |
معامِلات طلب البحث
المعلمات | |
---|---|
pageSize |
عدد المواقع الجغرافية المطلوب جلبها لكل صفحة القيمة التلقائية هي 25، والحد الأدنى هو 1، والحد الأقصى لحجم الصفحة هو 100. |
pageToken |
وفي حال تحديده، يتم استرداد الصفحة التالية من المواقع الجغرافية. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ على GoogleLocations.ListRecommendedGoogleLocations.
ويحتوي التقرير أيضًا على بعض المواقع الجغرافية التي طالب بها مستخدمون آخرون في "الملف التجاري على Google" منذ آخر مرة تمّ اقتراحها فيها باستخدام هذا الحساب على "الملف التجاري على Google".
تمثيل JSON | |
---|---|
{
"googleLocations": [
{
object ( |
الحقول | |
---|---|
googleLocations[] |
المواقع الجغرافية المقترَحة لحساب "الملف التجاري" يمثّل كلٌّ من هذه القيم |
totalSize |
إجمالي عدد المواقع الجغرافية المقترَحة لحساب "الملف التجاري" هذا، بغض النظر عن التقسيم على صفحات. |
nextPageToken |
أثناء التقسيم على صفحات، إذا كان هناك المزيد من المواقع الجغرافية التي يمكن استرجاعها في الصفحة التالية، تتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من المواقع الجغرافية في استدعاء لاحق. إذا لم تكن هناك مواقع جغرافية أخرى لاسترجاعها، هذا يعني أنّ هذا الحقل غير متوفّر في الردّ. |
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.