API اطلاعات کسب و کار

گزارش تغییرات

نسخه ۱

دسترسی به API

API اطلاعات کسب و کار باید از کنسول GCP فعال شود. محدوده OAuth بدون تغییر باقی می‌ماند.

آدرس اینترنتی نقطه پایانی

نقاط پایانی برای جستجوی تمام اطلاعات کسب و کار، ویژگی‌ها، دسته‌ها، زنجیره‌ها و مکان‌ها به جای https://mybusinessbusinessinformation.googleapis.com/v1/ https://mybusiness.googleapis.com/v4/ دسترسی هستند.

نام مسیر برای نقاط انتهایی مکان‌ها از accounts/accountId/locations/locationId به locations/locationId تغییر کرده است.

به‌روزرسانی‌های مکان

  • locationName به title تغییر نام داده شده است.
  • websiteUrl به websiteUri تغییر نام داده است.
  • accounts.locations.list و locations.get اکنون به readMask نیاز دارند.
  • primaryPhone و additionalPhones اکنون بخشی از PhoneNumbers هستند.
  • primaryCategory و additionalCategories اکنون بخشی از Categories هستند.
  • address به storefrontAddress تغییر نام داده شده است.
  • accounts.locations.clearAssociation به locations.clearLocationAssociation به‌روزرسانی شده است.
  • اکنون serviceItems مستقیماً از شیء Location خوانده و به‌روزرسانی می‌شوند.

ویژگی‌ها

  • شیء Attributes جدید و نقطه پایانی locations.attributes.getGoogleUpdated مربوطه برای دریافت نسخه به‌روز شده گوگل.
  • attributes.list یک پارامتر show_all دارد که به کلاینت‌ها اجازه می‌دهد تمام ویژگی‌های مختلفی را که می‌توانند برای یک دسته خاص و ترکیب منطقه تنظیم شوند، مشاهده کنند.

کسب و کارهای حوزه خدمات

  • کسب‌وکارهایی که از نوع CUSTOMER_LOCATION_ONLY هستند، دیگر نیازی به پر کردن فرم آدرس ندارند.
  • افزودن regionCode در ServiceAreaBusiness . این کد باید برای کسب‌وکارهای از نوع CUSTOMER_LOCATION_ONLY تنظیم شود.

نقاط پایانی و اشیاء منسوخ شده

  • شیء LocationKey حذف شد. فیلدهای موجود به Metadata منتقل شده‌اند.
  • شیء PriceLists حذف شده است. این شیء با FoodMenus و ServiceList جایگزین شده است.
  • حذف شیء LocationState . اکثر فیلدهای موجود به Metadata منتقل شده‌اند. اگرچه Metadata حاوی یک مقدار بولی برای بررسی اینکه آیا فروشنده کنترل کامل کسب و کار را دارد یا خیر (voice of merchant)، است، فیلدهای مربوط به تعلیق و تأیید با جزئیات بیشتر به Verifications API منتقل شده‌اند. برای مراحل بعدی به منظور دستیابی به voice of merchant از متد locations.getVoiceOfMerchantState استفاده کنید.
  • نقاط پایانی googleLocations.report و accounts.locations.findMatchingLocations منسوخ شده‌اند.
  • نقطه پایانی TransferLocation به locations.transfer در زیر API مدیریت حساب منتقل شده است.