Business Information API

سجلّ التغييرات

v1

الوصول إلى API

يجب تفعيل واجهة برمجة تطبيقات معلومات النشاط التجاري من وحدة تحكّم GCP. يظل نطاق OAuth كما هو.

عنوان URL لنقطة النهاية

يمكن الوصول إلى نقاط النهاية لجميع معلومات النشاط التجاري والسمات والفئات والسلاسل والمواقع الجغرافية للبحث في 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" الآن استخدام قناع القراءة.
  • أصبح primaryPhone وadditionalPhones الآن جزءًا من PhoneNumbers.
  • أصبحت primaryCategory وadditionalCategories الآن جزءًا من الفئات.
  • تمت إعادة تسمية address إلى storefrontAddress.
  • تم تحديث accounts.locations.clearAssociation إلى locations.clearLocationAssociation.
  • تتم الآن قراءة وتعديل serviceItems مباشرةً من كائن الموقع الجغرافي.

السمات

  • عنصر Attributes جديد ونقطة نهاية locations.attributes.getGoogleUpdated مطابقة للحصول على الإصدار المُحدَّث من Google.
  • تحتوي attributes.list على معلَمة show_all تسمح للعملاء بالاطّلاع على جميع السمات المختلفة التي يمكن ضبطها لفئة معيّنة ومنطقة معيّنة.

المؤسسات التجارية لمنطقة نطاق الخدمة

  • لم تعد الأنشطة التجارية من النوع CUSTOMER_LOCATION_ONLY مطلوبة لملء عنوان.
  • إضافة regionCode في ServiceAreaBusiness. ويجب ضبطه للأنشطة التجارية من النوع CUSTOMER_LOCATION_ONLY.

كائنات ونقاط نهاية تم إيقافها نهائيًا

  • تمت إزالة العنصر LocationKey. تم نقل الحقول الحالية إلى البيانات الوصفية.
  • تمت إزالة العنصر PriceLists. تم استبدالها بـ Food Menus وServiceLists.
  • تمت إزالة العنصر LocationState. تم نقل معظم الحقول الحالية إلى البيانات الوصفية. على الرغم من أنّ البيانات الوصفية تحتوي على قيمة منطقية لمعرفة ما إذا كان التاجر يملك إمكانية التحكّم الكامل في النشاط التجاري (صوت التاجر)، تم نقل الحقول الأكثر تفصيلاً المتعلقة بالتعليق وإثبات الملكية إلى التحقّق من واجهة برمجة التطبيقات. يُرجى استخدام الطريقة locations.getVoiceOfMerchantState أثناء الخطوات التالية من أجل التعرّف على صوت التاجر.
  • تم إيقاف نقطتَي النهاية googleLocations.report وaccounts.locations.findMatchingLocations نهائيًا.
  • تم نقل نقطة النهاية TransferLocation إلى locations.transfer ضمن Account Management API.