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.

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

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

object (GoogleLocation)

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

integer

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

string

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

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

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

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

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