Method: accounts.listRecommendGoogleLocations

يُرجى إدراج جميع GoogleLocation التي تمت التوصية بها لحساب "الملف التجاري" المحدّد. يتم تقديم اقتراحات للحسابات الشخصية ومجموعات المواقع الجغرافية فقط، وستؤدي الطلبات إلى جميع أنواع الحسابات الأخرى إلى حدوث خطأ. تستند اقتراحات مجموعات المواقع الجغرافية إلى المواقع الجغرافية في تلك المجموعة.

تستند اقتراحات الحسابات الشخصية إلى جميع المواقع الجغرافية التي يمكن للمستخدم الوصول إليها في "الملف التجاري" (بما في ذلك المواقع الجغرافية التي يمكنه الوصول إليها من خلال مجموعات المواقع الجغرافية)، وهي مجموعة رئيسية من جميع الاقتراحات التي تم إنشاؤها للمستخدم.

طلب HTTP

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

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

مَعلمات المسار

المعلمات
name

string

اسم مورد الحساب المطلوب استرجاع مواقع Google الجغرافية المقترَحة له.

معامِلات طلب البحث

المعلمات
pageSize

integer

عدد المواقع الجغرافية المطلوب جلبها لكل صفحة القيمة التلقائية هي 25، والحد الأدنى هو 1، والحد الأقصى لحجم الصفحة هو 100.

pageToken

string

وفي حال تحديده، يتم استرداد الصفحة التالية من المواقع الجغرافية.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

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

رسالة ردّ على GoogleLocations.ListRecommendedGoogleLocations.

ويحتوي التقرير أيضًا على بعض المواقع الجغرافية التي طالب بها مستخدمون آخرون في "الملف التجاري على Google" منذ آخر مرة تمّ اقتراحها فيها باستخدام هذا الحساب على "الملف التجاري على Google".

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

object (GoogleLocation)

المواقع الجغرافية المقترَحة لحساب "الملف التجاري" يمثّل كلٌّ من هذه القيم GoogleLocation معروضة على "خرائط Google". يتم ترتيب المواقع الجغرافية بترتيب تنازلي حسب مدى صلتها بحساب "الملف التجاري على Google".

totalSize

integer

إجمالي عدد المواقع الجغرافية المقترَحة لحساب "الملف التجاري" هذا، بغض النظر عن التقسيم على صفحات.

nextPageToken

string

أثناء التقسيم على صفحات، إذا كان هناك المزيد من المواقع الجغرافية التي يمكن استرجاعها في الصفحة التالية، تتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من المواقع الجغرافية في استدعاء لاحق. إذا لم تكن هناك مواقع جغرافية أخرى لاسترجاعها، هذا يعني أنّ هذا الحقل غير متوفّر في الردّ.

نطاقات التفويض

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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