آخر تحديثات واجهة برمجة التطبيقات للملفات التجارية

يمكنك التحقّق من حالة التعديل للمواقع الجغرافية والسمات باستخدام نقاط النهاية الجديدة v1alpha. يمكنك الاطّلاع على دليل حالة التعديل أو صفحة "آخر الأخبار".

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

Business Information API

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

v1alpha

تتوفّر التعديلات التالية في v1alpha.

تعديل الحالة للمواقع الجغرافية والسمات

تمت إضافة locations.getExtended (GET /v1alpha/{name=locations/*}:getExtended) لاسترداد ExtendedLocation، والتي تتضمن Location (locationProvidedByMerchant) التي يوفّرها التاجر، وLocation (locationSeenByConsumers) المُوجَّه للمستهلكين، وخريطة لأسماء الحقول ذات المستوى الأعلى إلى ExtendedFieldData.
تمت إضافة locations.attributes.getExtended (GET /v1alpha/{name=locations/*/attributes}:getExtended) لاسترداد ExtendedAttributes، الذي يقرن attributeProvidedByMerchant وattributeSeenByConsumers مع ExtendedFieldData لكل سمة.
تمت إضافة ExtendedFieldData لتوفير بيانات وصفية للتعديلات لكل حقل ولكل سمة، بما في ذلك EditLifecycleStage (مثل EDIT_LIFECYCLE_STAGE_PENDING أو EDIT_LIFECYCLE_STAGE_REJECTED) وأسباب رفض PolicyViolation وآخر تعديل updateTime ومصدر التعديل Source (SOURCE_API وSOURCE_UI).
يمكنك الاطّلاع على التحقّق من حالة التعديل للمواقع الجغرافية والسمات للحصول على أمثلة على الاستخدام.

v1

دخول API

يجب تفعيل Business Information API من وحدة تحكّم Google Cloud Platform. يبقى نطاق 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 الآن استخدام readMask.
أصبح "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) وتم استبداله بـ FoodMenus وServiceLists.
إزالة عنصر واحد (LocationState) تم نقل معظم الحقول الحالية إلى البيانات الوصفية. على الرغم من أنّ Metadata تحتوي على قيمة منطقية لمعرفة ما إذا كان التاجر يتحكّم بشكل كامل في المؤسسة (صوت التاجر)، تم نقل الحقول الأكثر تفصيلاً المتعلّقة بالتعليق والتحقّق إلى Verifications API. استخدِم الطريقة locations.getVoiceOfMerchantState للخطوات التالية من أجل الحصول على حالة "رأي التاجر".
تم إيقاف نقطتَي النهاية googleLocations.report وaccounts.locations.findMatchingLocations نهائيًا.
تم نقل نقطة النهاية TransferLocation إلى locations.transfer ضمن Account Management API.