أدرِج كل GoogleLocation
التي تم اقتراحها لحساب "الملف التجاري" المحدّد. يتمّ تقديم اقتراحات للحسابات الشخصية ومجموعات المواقع الجغرافية فقط، وستؤدي الطلبات المتعلّقة بجميع أنواع الحسابات الأخرى إلى حدوث خطأ. تستند اقتراحات مجموعات المواقع الجغرافية إلى المواقع الجغرافية في تلك المجموعة.
تستند اقتراحات الحسابات الشخصية إلى جميع المواقع الجغرافية التي يمكن للمستخدم الوصول إليها في "الملف التجاري" (بما في ذلك المواقع الجغرافية التي يمكنه الوصول إليها من خلال مجموعات المواقع الجغرافية)، وهي مجموعة شاملة من جميع الاقتراحات التي يتم إنشاؤها للمستخدم.
طلب HTTP
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
اسم مورد الحساب المطلوب جلب مواقع Google الجغرافية المقترَحة لها |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
عدد المواقع الجغرافية المطلوب جلبها لكل صفحة. الإعداد التلقائي هو 25 والحد الأدنى هو 1 والحد الأقصى لحجم الصفحة هو 100. |
pageToken |
وفي حال تحديد ذلك، يتم استرداد الصفحة التالية من المواقع الجغرافية. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة رد بشأن GoogleLocations.ListRecommendedGoogleLocations.
ويتضمّن التقرير أيضًا بعض المواقع الجغرافية التي طالب بها مستخدمو "الملف التجاري" الآخرون منذ آخر مرة تم اقتراحها لهم على هذا الحساب على "الملف التجاري".
تمثيل 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.