Method: accounts.listRecommendGoogleLocations

همه GoogleLocation هایی را که به حساب نمایه کسب و کار مشخص شده توصیه شده اند فهرست کنید. توصیه‌ها فقط برای حساب‌های شخصی و گروه‌های مکان ارائه شده‌اند، درخواست‌ها برای همه انواع حساب‌های دیگر منجر به خطا می‌شوند. توصیه‌ها برای گروه‌های مکان براساس مکان‌های آن گروه است.

توصیه‌های مربوط به حساب‌های شخصی بر اساس همه مکان‌هایی است که کاربر در نمایه کسب‌وکار (که شامل مکان‌هایی است که می‌توانند از طریق گروه‌های مکان به آن‌ها دسترسی داشته باشند) دسترسی دارد، و مجموعه‌ای از همه توصیه‌های ایجاد شده برای کاربر است.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
name

string

نام منبع حساب برای واکشی مکان‌های پیشنهادی Google برای.

پارامترهای پرس و جو

پارامترها
pageSize

integer

چند مکان برای واکشی در هر صفحه. پیش فرض 25، حداقل 1 و حداکثر اندازه صفحه 100 است.

pageToken

string

در صورت مشخص شدن، صفحه بعدی مکان ها بازیابی می شود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پیام پاسخ برای GoogleLocations.ListRecommendedGoogleLocations.

همچنین حاوی مکان‌هایی است که سایر کاربران نمایه کسب‌وکار از آخرین باری که به این حساب نمایه کسب‌وکار توصیه شده‌اند، ادعا شده است.

نمایندگی JSON 
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
فیلدها
googleLocations[]

object ( GoogleLocation )

مکان‌هایی که به حساب نمایه کسب‌وکار توصیه می‌شوند. هر یک از اینها نشان دهنده یک GoogleLocation است که در Maps وجود دارد. مکان ها به ترتیب نزولی مربوط به حساب نمایه کسب و کار مرتب شده اند.

totalSize

integer

تعداد کل مکان‌های توصیه‌شده برای این حساب نمایه کسب‌وکار، صرف نظر از صفحه‌بندی.

nextPageToken

string

در حین صفحه‌بندی، اگر مکان‌های بیشتری برای واکشی در صفحه بعدی وجود داشته باشد، این فیلد با نشانه‌ای پر می‌شود تا صفحه بعدی مکان‌ها را در تماس بعدی واکشی کند. اگر مکان دیگری برای واکشی وجود نداشته باشد، این فیلد در پاسخ وجود ندارد.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.