تغییر گزارش

v4.9

ویژگی‌های جدید

‫۲۰۲۶-۱۰-۰۹

Food Menus Dietary Restrictions: اکنون DietaryRestriction enum از ویژگی‌های GLUTEN_FREE و DAIRY_FREE برای موارد منو غذا بااستفاده از accounts.locations.getFoodMenus و accounts.locations.updateFoodMenus پشتیبانی می‌کند.

‫۲۰۲۶-۰۷-۲۴

‫review_reply_url: اکنون می‌توان reviewReplyUrl را بااستفاده از accounts.locations.reviews.get، accounts.locations.reviews.list، و accounts.locations.batchGetReviews بازیابی کرد.

‫۲۰۲۶-۰۷-۰۱

Policy Violation: فیلد PolicyViolation اکنون در ReviewReply برای مرورها گنجانده شده است. PolicyViolation را می‌توان بااستفاده از accounts.locations.reviews.get، accounts.locations.reviews.list، و accounts.locations.batchGetReviews بازیابی کرد. این ویژگی دید بیشتری درباره دلیل رد شدن پاسخ مرور درطول گردانندگی ارائه می‌دهد.

۲۰۲۶-۰۴-۲۰

‫Review Media Items: اکنون می‌توان ReviewMediaItems را به‌عنوان بخشی از مرورها بازیابی کرد. ReviewMediaItems را می‌توان بااستفاده از accounts.locations.reviews.get، accounts.locations.reviews.list، و accounts.locations.batchGetReviews بازیابی کرد.

۲۰۲۶-۰۴-۰۷

‫Recurrence Info: اکنون می‌توانید با تنظیم RecurrenceInfo هنگام ایجاد LocalPost، پست‌های تکرارشونده را زمان‌بندی کنید

‫Food Menus: اکنون می‌توانید حداکثر ۲۰۰ عکس غذا را در «منوهای غذا» بااستفاده از accounts.locations.updateFoodMenus مدیریت کنید

۲۰۲۶-۰۴-۰۱

‫Review Reply State: ReviewReplyState اکنون می‌تواند به‌عنوان بخشی از مرورها بازیابی شود. ReviewReplyState را می‌توان بااستفاده از accounts.locations.reviews.get، accounts.locations.reviews.list، و accounts.locations.batchGetReviews بازیابی کرد. این ویژگی دید بیشتری نسبت‌به وضعیت نظارت بر پاسخ‌های ارسالی شما به مرورها ارائه می‌دهد.

‫۲۰۲۱-۰۲-۲۴

MoreHours : اکنون می‌توان MoreHours را به‌عنوان بخشی از فهرستگان کسب‌وکار تنظیم کرد. : MoreHourTypes را می‌توان برای هر دسته بااستفاده از categories.batchGet بازیابی کرد.

تغییرات رفتاری

منسوخ شدن حساب‌های نسخه ۴.x
حساب‌ها، accounts.admins، accounts.invitations، و accounts.locations.admins اکنون در Google My Business API منسوخ شده‌اند. برای اطلاعات بیشتر، گزارش تغییر منسوخ شدن را ببینید.
پست‌های «دعوت به اقدام»

در فصل دوم ۲۰۲۱، CallToAction پست با

GET_OFFER ‫ActionType دیگر معتبر نخواهد بود.

v4.8

ویژگی‌های جدید

امکانات اقامتگاه : بازیابی و به‌روزرسانی امکانات اقامتگاه. اطلاعات بیشتر : افزودن نقطه پایانی GetGoogleUpdated برای «اقامتگاه». : افزودن مقدار بولی canOperateLodgingData در LocationState

مشخصه‌های ارائه‌دهنده خدمات بهداشت و درمان : بازیابی و به‌روزرسانی «مشخصه‌های ارائه‌دهنده خدمات بهداشت و درمان». اطلاعات بیشتر : اضافه شدن مقدار بولی canOperateHealthData در LocationState

شبکه‌های بیمه : فهرست شبکه‌های بیمه پذیرفته‌شده توسط مکان‌ها. اطلاعات بیشتر

تغییرات رفتاری

شناسه‌های مرور
‫
شناسه مرور به قالب جدیدی منتقل شده است. این شناسه جدید اکنون در همه پاسخ‌های API مربوطه برگردانده خواهد شد. برای مدت کوتاهی، شناسه‌های قدیمی مرور همچنان هنگام استفاده برای فراخوانی API قابل‌حل خواهند بود، اما بسیار مهم است که همه شناسه‌های مرور ذخیره‌شده در سیستم خود را ظرف ۳۰ روز مطابق با خط‌مشی‌های ما با فراخوانی نقطه پایانی listReviews بازآوری کنید.
کسب‌وکار با منطقه خدماتی

در سه‌ماهه اول ۲۰۲۱، Address دیگر در

شیء مکان برای CUSTOMER_LOCATION_ONLY کسب‌وکارها.

v4.7

ویژگی‌های جدید

منوهای غذا : واکشی و به‌روزرسانی «منوهای غذا». اطلاعات بیشتر

v4.6

ویژگی‌های جدید

فهرست‌های خدمات

اکنون می‌توانید

خدماتی را که کسب‌وکار ارائه می‌دهد بازیابی و به‌روزرسانی می‌کند. اطلاعات بیشتر

افزودن مقدار بولی canModifyServiceList در «وضعیت مکان»

نشان می‌دهد آیا مکان برای اصلاح فهرست‌های خدمات واجدشرایط است یا نه اطلاعات بیشتر

ServiceTypes ازپیش تعریف‌شده برای «دسته‌ها»

انواع سرویس ازپیش تعریف‌شده اکنون در شیء دسته‌ها اضافه شده است. اطلاعات بیشتر

CategoryView

امکان مشخص کردن نمای BASIC یا FULL برای دسته‌ها. نمای FULL جزئیات بیشتری مثل انواع خدمات را برمی‌گرداند. اطلاعات بیشتر

روش Categories.BatchGet

این روش جدید به شما امکان می‌دهد فهرستی از دسته‌ها را وارد کنید و فقط اطلاعات مربوط به آن دسته‌ها را برمی‌گرداند. اطلاعات بیشتر

v4.5 به‌روزرسانی ۲ کووید-۱۹

ویژگی‌های جدید

نوع پست هشدار کووید-۱۹

اکنون می‌توانید بااستفاده از API پست COVID_19 ایجاد کنید.

اطلاعات بیشتر.

v4.5 COVID-19 Update 1

ویژگی‌های جدید

موقتاً بسته
اکنون می‌توانید کسب‌وکاری را بااستفاده از API روی CLOSED_TEMPORARILY تنظیم کنید. اطلاعات بیشتر.

v4.5

ویژگی‌های جدید

‫Pub/Sub برای پرسش و پاسخ
اکنون می‌توانید اعلان‌های Google Cloud Pub/Sub را برای پرسش‌ها و پاسخ‌های جدید یا به‌روزشده در مکان دریافت کنید. اطلاعات بیشتر.
‫Pub/Sub برای وضعیت فهرستگان
اکنون می‌توانید اعلان‌های Google Cloud Pub/Sub را برای تغییر در وضعیت فهرستگان دریافت کنید. اطلاعات بیشتر.

v4.4

ویژگی‌های جدید

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

اکنون می‌توانید فراداده‌های مربوط به دنبال‌کنندگان را بازیابی کنید.

اطلاعات بیشتر.

گروه‌های کاربر و گروه‌های مکان

اکنون می‌توان گروه‌های کاربر و گروه‌های مکان را ازطریق API ایجاد کرد. اطلاعات بیشتر

افزودن فیلد hasPendingEdits در LocationState

نشان می‌دهد که آیا ویژگی‌های مکان در وضعیت تعلیق ویرایش است یا نه. اطلاعات بیشتر

تغییرات رفتار

تاریخ دلخواه
اکنون می‌توانید تاریخ افتتاح را برای فهرستگان در آینده تنظیم کنید.

PointRadius : PointRadius اکنون فقط خواندنی است. ویرایش یا ایجاد کسب‌وکارهای خدمات محلی مستلزم استفاده از مکان‌ها است.

v4.3

ویژگی‌های جدید

میاناهای برنامه‌سازی کاربردی پرسش و پاسخ
پرسش‌ها را بازیابی کنید، پاسخ‌ها را پست کنید، و پرسش‌های پرتکرار را در مکان‌های کسب‌وکارتان ارائه دهید. اطلاعات بیشتر.
خواندن مرورهای انبوه

مرورهای چندین مکان را در یک تماس واحد بازیابی کنید.

اطلاعات بیشتر.

‫GoogleLocations توصیه‌شده

مکان‌های ادعانشده‌ای را که Google فکر می‌کند ممکن است به شما تعلق داشته باشند ببینید. اطلاعات بیشتر.

گزارش کردن مشکلات «مکان Google»

مشکلات مربوط به نتایج RecommendedGoogleLocations یا GoogleLocations را گزارش کنید. اطلاعات بیشتر.

«خدمات شمارشی» برای PriceList بخش

بخش PriceList را به‌عنوان حاوی موارد «غذا» یا «خدمات» ارائه‌شده مشخص کنید. اطلاعات بیشتر.

شرح رسانه

هنگام بارگذاری رسانه جدید، زیرنویس ناشنوایان ارائه دهید.

اطلاعات بیشتر.

‫CHAINS_QUERIES اطلاعات آماری

تعداد دفعاتی را که مکان به‌عنوان نتیجه جستجوی زنجیره‌ای که به آن تعلق دارد نشان داده شده است بازیابی کنید. اطلاعات بیشتر.

تغییرات رفتار

اعلان‌های مربوط به «حساب‌های سازمانی» و «گروه‌های مکان»
حساب‌هایی که برای اعلان‌های Pub/Sub پیکربندی شده‌اند اکنون این اعلان‌ها را برای فهرستگان‌های موجود در «حساب سازمان» یا «گروه‌های مکان» که سرپرست آن هستند نیز دریافت خواهند کرد.
‫ListLocations برای «حساب سازمانی» و «گروه‌های مکان»
accounts.locations.list تماس با «گروه کاربر» یا حساب «سازمان» اکنون همه مکان‌هایی را که با آن حساب دردسترس است نمایش می‌دهد.

v4.2

ویژگی‌های جدید

میاناهای برنامه‌سازی کاربردی برای درستی‌سنجی
فهرست کردن و راه‌اندازی روش‌های درستی‌سنجی دردسترس برای مکان‌های درستی‌سنجی‌نشده. اطلاعات بیشتر.
GoogleLocations API
برای مطالبه کردن مکان‌های موجود در Google جستجو کنید، یا پیوندی برای درخواست دسترسی به مکان‌های مطالبه‌شده بازیابی کنید. اطلاعات بیشتر.
فیلترهای مکان گسترده
گزینه‌های اضافی برای محدود کردن نتایج برگشتی از تماس Locations.List. اطلاعات بیشتر.
عضویت زنجیره‌ای
عضویت مکان را به‌عنوان بخشی از یک زنجیره نشان دهید (برای نمونه، Walmart، ‏Target، و غیره). اطلاعات بیشتر.
اطلاعات سازمان
اطلاعات مربوط به حساب‌های سازمانی اکنون به‌عنوان بخشی از «اشیا حساب» نمایش داده می‌شود. اطلاعات بیشتر.
عکس نمایه مرورکننده
نشانی‌های وب عکس‌های نمایه افراد بازبین اکنون در شیء مرور اضافه شده است. اطلاعات بیشتر.

v4.1

ویژگی‌های جدید

رسانه ارائه‌شده توسط مشتری
اکنون می‌توانید اطلاعات آماری عکس‌ها و ویدیوهای تولیدشده توسط کاربر را برای مکان‌هایی که مالک و مدیر آن‌ها هستید بازیابی و مشاهده کنید. اطلاعات بیشتر.
میاناهای برنامه‌سازی کاربردی مدیریت سرپرست
اکنون می‌توانید دعوت‌های مربوط به حساب و مکان را برای حسابتان فهرست کنید، بپذیرید، و رد کنید. اطلاعات بیشتر.
‫Profile (شرح ارائه‌شده توسط فروشنده)
کسب‌وکارتان را با صدای خودتان توصیف کنید و داستان منحصربه‌فرد کسب‌وکارتان و پیشنهادهای ویژه را با کاربران هم‌رسانی کنید. اطلاعات بیشتر.
‫openingDate فیلد

تاریخی را که مکانتان برای کسب‌وکار باز شده است ارائه دهید.

اطلاعات بیشتر.

پست‌های نوع پیشنهاد

نوع جدیدی از «پست در Google» که به کاربران کمک می‌کند معامله‌های خوب موجود در مکان‌هایتان را پیدا کنند. اطلاعات بیشتر.

v4

ویژگی‌های جدید

پست‌ها در Google
اکنون می‌توانید «پست‌ها در Google» را مستقیماً ازطریق API ایجاد کنید.
بارگذاری عکس
اکنون می‌توانید عکس‌ها را علاوه‌بر بارگذاری نشانی وب موجود، مستقیماً بااستفاده از API بارگذاری کنید.
فیلتر کردن/موافقت کردن با اعلان‌ها
اکنون می‌توانید فیلتر کنید کدام اعلان‌ها به موضوعات pubsub ارسال شوند. اعلان‌های آتی از این سازوکار برای موافقت استفاده خواهند کرد به‌جای اینکه برای همه کاربران ارسال شوند.
UPDATED_REVIEW اعلان
اکنون می‌توانید برای به‌روزرسانی‌های مرورهای مشتریان، مشترک اعلان‌های هم‌زمان شوید.
پشتیبانی از «گروه‌های کاربر»
«میانای برنامه‌سازی کاربردی Google برای کسب‌وکار من» اکنون از حساب‌های نوع «گروه کاربر» پشتیبانی می‌کند.

تغییرات ناسازگار با نسخه قدیمی

  • «عکس‌ها» که قبلاً فیلد location شیء بود، اکنون منبعی تحت مکان (accounts/<var>account_ID</var>/locations/<var>location_ID</var>/photos) است.
  • فیلد نشانی Country اکنون region_code است و sub_locality اکنون sublocality است.
  • فیلد Ownership که قبلاً منسوخ شده بود برداشته شد.
  • قبلاً مالکان مشترک حساب‌ها و مکان‌ها ازطریق API از مالکان اصلی قابل تشخیص نبودند (همه به‌عنوان OWNER نشان داده می‌شدند). اکنون مالکان اصلی نقش OWNER و مالکان دیگر نقش CO_OWNER را دریافت خواهند کرد.
  • ‫AccountType.BUSINESS اکنون AccountType.LOCATION_GROUP نامیده می‌شود.
  • هنگام استفاده از پوشش فیلد برای به‌روزرسانی مکان‌ها، update_mask را به‌جای field_mask موجود ارائه دهید.
  • پیام دسته‌ای که برای primary_category و additional_categories استفاده می‌شود دیگر حاوی شکل انسان‌خوانا نیست. کاربران باید از سرویس دسته‌های «میانای برنامه‌سازی کاربردی Google برای کسب‌وکار من» برای دریافت نام‌های دسته ترجمه‌شده و قابل‌خواندن توسط انسان استفاده کنند.

v3.3

ویژگی‌های جدید

منوهای ساختاریافته

اکنون می‌توانید موارد زیر را اضافه، به‌روزرسانی، یا حذف کنید:

  • چندین منو در یک مکان معین
  • چندین بخش منو را در یک منو بگنجانید
  • فهرست کردن موارد منو با نام، شرح، قیمت، و عکس

v3.2

ویژگی‌های جدید

اطلاعات آماری
اکنون می‌توانید اطلاعات آماری مکان و سنجه‌های رانندگی را ازطریق «میانای برنامه‌سازی کاربردی» بازیابی کنید.
اعلان‌ها
اکنون می‌توانید برای «به‌روزرسانی‌های Google» جدید در اعلان‌های بی‌درنگ مشترک شوید.

تغییرات ناسازگار با نسخه قدیمی

  • فیلدهای languageCodes و platforms که قبلاً استفاده نشده بودند از UrlAttributeValue برداشته شده‌اند.
  • ‫SAME در شمارش مالکیت منسوخ‌شده اکنون فقط درصورتی اعمال می‌شود که مکان تکراری مالک اصلی یکسانی داشته باشد. قبلاً، رفتار براساس یک محاسبه مالکیت پیچیده‌تر بود.

v3.1

ویژگی‌های جدید

اعلان‌ها
اکنون می‌توانید برای دریافت اعلان‌های درلحظه برای نظرات جدید مشترک شوید.
نشانی‌های وب در Maps
نشانی‌های وب Google Maps در پاسخ‌های مکان اضافه شده است تا کاربران بتوانند به Google Maps پیوند دهند.
ایالت‌های مکان
وضعیت‌های مکان اضافی که نشان می‌دهد فهرستگان چه زمانی منتشر، غیرفعال، یا درانتظار درستی‌سنجی است.
باز کردن مجدد پرچم
پرچم
canReopen مکان‌های دائمی بسته‌شده‌ای را نشان می‌دهد که می‌توانند دوباره باز شوند درمقایسه با مکان‌هایی که نمی‌توانند.
مشخصه‌ها
پشتیبانی از مشخصه‌های «نشانی وب» و «شمارشی».
نقطه پایانی دسته
فهرست دسته‌های پشتیبانی‌شده براساس کشور و زبان را دریافت کنید (جایگزین فایل‌های CSV می‌شود).

v3

ویژگی‌های جدید

مرورها
اکنون می‌توانید مرورهای کسب‌وکار را ازطریق API بازیابی کنید و به آن‌ها پاسخ دهید.
مشخصه‌ها
اطلاعات اضافی و دسته‌بندی‌شده درباره مکان‌ها ارائه دهید.
یافتن مکان منطبق
مکان‌های نقشه موجود را پیدا کنید و به‌صورت دستی با مکان کسب‌وکارتان مرتبط کنید.
انتقال مکان
کنش جدید در Location :transfer. اجازه می‌دهد مکان از حسابی (کاری یا شخصی) به حساب دیگری منتقل شود.
عکس برگزیده
مشخص کنید کدام عکس را ترجیح می‌دهید ابتدا در Google Maps و «جستجو» نشان داده شود.
فیلترهای جستجوی جدید
فیلترهای جستجوی جدید شامل any_google_updates، is_suspended، و is_duplicate می‌شود.
ایالت‌های مکان جدید
وضعیت‌های مکان اکنون شامل is_verified و needs_reverification نیز می‌شود.
بهبودهای نشانی وب عکس
اکنون «میانای برنامه‌سازی کاربردی» نشانی‌های وب عکس را بدون پسوند قالب تصویر می‌پذیرد.

تغییرات ناسازگار با نسخه قدیمی

  • اکنون باید request_id را در فراخوان‌های CreateLocation مشخص کنید. این شناسه باید برای هر مکان یکتا باشد؛ این کار کمک می‌کند از ایجاد مکان‌های تکراری در حسابتان جلوگیری شود. تلاش برای ایجاد مکانی که شناسه درخواست با مکان قبلاً ایجادشده مطابقت داشته باشد، مکان موجود را برمی‌گرداند و از ایجاد مکان تکراری در حسابتان جلوگیری می‌کند.
  • نام business_hours در مکان به regular_hours تغییر کرد.