تغییر گزارش

نسخه 4.9

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

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

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

v4.x از بین رفتن حساب ها
حساب‌ها ، accounts.admins ، accounts.invitations ، و accounts.locations.admins اکنون در Google برای کسب‌وکار من API منسوخ شده‌اند. برای اطلاعات بیشتر به گزارش تغییرات منسوخ مراجعه کنید.
پست های CallToAction
در سه ماهه دوم 2021، پست‌های CallToAction با GET_OFFER ActionType دیگر معتبر نخواهند بود.

نسخه 4.8

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

امکانات اقامتی
بازیابی و به روز رسانی امکانات اقامتی. اطلاعات بیشتر
افزودن نقطه پایانی GetGoogleUpdated برای اقامت.
افزودن مقدار بولی canOperateLodgingData در LocationState
ویژگی های ارائه دهنده سلامت
بازیابی و به روز رسانی HealthProviderAttributes. اطلاعات بیشتر
افزودن مقدار بولی canOperateHealthData در LocationState
شبکه های بیمه
شبکه های بیمه پذیرفته شده توسط مکان ها را فهرست کنید . اطلاعات بیشتر

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

بررسی شناسه ها
شناسه‌های مرور به قالب جدیدی منتقل شده‌اند. این شناسه جدید اکنون در تمام پاسخ‌های API قابل اجرا برگردانده می‌شود. برای مدت کوتاهی، شناسه‌های بازبینی قدیمی همچنان در صورت استفاده برای فراخوانی API برطرف می‌شوند، اما مهم است که همه شناسه‌های مرور ذخیره‌شده در سیستمتان را ظرف 30 روز با تماس با نقطه پایانی listReviews ، طبق خط‌مشی‌های ما، بازخوانی کنید.
کسب و کار منطقه خدمات
در سه ماهه اول 2021، Address دیگر در شی موقعیت مکانی برای مشاغل CUSTOMER_LOCATION_ONLY بازگردانده نمی شود.

نسخه 4.7

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

منوهای غذا
بازیابی و به روز رسانی FoodMenus. اطلاعات بیشتر

نسخه 4.6

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

لیست خدمات
اکنون می توانید خدماتی را که یک کسب و کار ارائه می دهد بازیابی و به روز کنید . اطلاعات بیشتر
افزودن مقدار بولی canModifyServiceList در LocationState
نشان می دهد که آیا یک مکان واجد شرایط تغییر لیست خدمات اطلاعات بیشتر است یا خیر
ServiceTypes از پیش تعریف شده برای دسته ها
انواع سرویس های از پیش تعریف شده اکنون مانند شی دسته بندی ها گنجانده شده اند. اطلاعات بیشتر
View Category
امکان تعیین نمای BASIC یا FULL برای دسته ها. نمای FULL جزئیات اضافی مانند انواع خدمات را برمی گرداند. اطلاعات بیشتر
دسته بندی ها. روش BatchGet
این روش جدید به شما امکان می دهد لیستی از دسته ها را وارد کنید و اطلاعات را فقط در مورد آن دسته ها برمی گرداند. اطلاعات بیشتر

نسخه 4.5 به‌روزرسانی COVID-19 2

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

نوع پست هشدار COVID-19
اکنون می توانید یک پست COVID_19 از طریق API ایجاد کنید. اطلاعات بیشتر .

نسخه 4.5 به‌روزرسانی COVID-19 1

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

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

نسخه 4.5

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

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

نسخه 4.4

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

تأییدیه‌های مشاغل خدمات محلی
کسب‌وکارهای خدمات محلی اکنون می‌توانند توسط API تأیید شوند. اطلاعات بیشتر .
تعداد فالوورها
اکنون می‌توانید متادیتا درباره فالوورها را بازیابی کنید. اطلاعات بیشتر .
گروه های کاربری و گروه های مکان
اکنون می توان گروه های کاربری و گروه های مکان را از طریق API ایجاد کرد. اطلاعات بیشتر
افزودن فیلد hasPendingEdits در LocationState
نشان می دهد که آیا ویژگی های یک مکان در حالت تعلیق ویرایش هستند یا خیر. اطلاعات بیشتر

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

باز کردن تاریخ
اکنون می توانید تاریخ بازگشایی در آینده را برای فهرست تعیین کنید.
PointRadius
PointRadius اکنون فقط خواندنی است. ویرایش یا ایجاد مشاغل خدمات محلی نیاز به استفاده از Places دارد.

نسخه 4.3

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

APIهای پرسش و پاسخ
سوالات را بازیابی کنید، پاسخ ها را پست کنید و سوالات متداول را در مورد مکان های کسب و کار خود ارائه دهید. اطلاعات بیشتر .
انبوه خواندن نظرات
بازیابی نظرات برای چندین مکان در یک تماس. اطلاعات بیشتر .
GoogleLocations توصیه شده
مکان‌های بدون ادعا را ببینید که Google فکر می‌کند ممکن است متعلق به شما باشد. اطلاعات بیشتر .
مشکلات GoogleLocation را گزارش کنید
مشکلات مربوط به نتایج RecommendedGoogleLocations یا GoogleLocations را گزارش کنید. اطلاعات بیشتر .
فهرست خدمات برای بخش های PriceList
یک بخش PriceList را به عنوان حاوی اقلام غذایی یا خدمات ارائه شده مشخص کنید. اطلاعات بیشتر .
توضیحات رسانه
هنگام آپلود رسانه جدید یک عنوان ارائه دهید. اطلاعات بیشتر .
CHAINS_QUERIES بینش
تعداد دفعاتی که یک مکان در نتیجه جستجوی زنجیره ای که به آن تعلق دارد نشان داده شده است، بازیابی کنید. اطلاعات بیشتر .

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

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

نسخه 4.2

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

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

نسخه 4.1

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

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

v4

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

پست ها در گوگل
اکنون می توانید مستقیماً از طریق API Posts در Google ایجاد کنید.
آپلود عکس
عکس‌ها اکنون می‌توانند مستقیماً از طریق API علاوه بر آپلود URL موجود، آپلود شوند.
اعلان‌ها فیلتر کردن/شرکت کردن
اکنون می‌توانید اعلان‌هایی که به موضوعات pubsub ارسال می‌شوند را فیلتر کنید. اعلان‌های آینده از این مکانیسم برای شرکت کردن استفاده می‌کنند تا اینکه برای همه کاربران ارسال شوند.
UPDATED_REVIEW اعلان‌ها
اکنون می‌توانید برای به‌روزرسانی نظرات مشتریان در اعلان‌های بی‌درنگ مشترک شوید.
پشتیبانی از گروه های کاربری
Google My Business API اکنون از حساب‌های نوع گروه کاربر پشتیبانی می‌کند.

تغییرات ناسازگار با عقب

  • عکس‌ها، که قبلاً فیلدی از اشیاء location بودند، اکنون منبعی تحت موقعیت مکانی هستند ( accounts/ account_ID /locations/ location_ID /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 My Business API برای دریافت نام‌های دسته‌بندی ترجمه‌شده و قابل خواندن توسط انسان استفاده کنند.

نسخه 3.3

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

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

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

  • منوهای متعدد در یک مکان مشخص

  • شامل چندین بخش منو در یک منو

  • موارد منو را با نام، توضیحات، قیمت و عکس فهرست کنید

نسخه 3.2

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

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

تغییرات ناسازگار با عقب

  • فیلدهای languageCodes و platforms استفاده نشده قبلی UrlAttributeValue حذف شده اند.

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

نسخه 3.1

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

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

v3

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

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

تغییرات ناسازگار با عقب

  • عکس‌ها اکنون فقط برای مکان‌های دارای صفحه Google+‎ قابل به‌روزرسانی هستند (این عکس‌ها قبلاً پذیرفته شده بودند و بی‌صدا حذف شدند).

  • فیلدهای location_name و category_name اکنون فقط خروجی هستند. هنگام تنظیم دسته ها فقط از شناسه های دسته استفاده کنید.

  • ماسک های میدانی دیگر نباید شامل location. پیشوند فیلدهای گنجانده شده

  • اکنون عملیات ایجاد/به‌روزرسانی، مکان را به عنوان بار بدنه می‌گیرد. سایر پارامترها به رشته پرس و جو منتقل می شوند.

v2

تغییرات ناسازگار با عقب

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

    • business_hours در Location به regular_hours تغییر نام داده است.