سجل التغيير

v4.9

ميزات جديدة

MoreHours
MoreHours: يمكن الآن ضبط هذا السمة كجزء من بطاقة بيانات النشاط التجاري.
MoreHourTypes يمكن استرجاعه لكل فئة باستخدام categories.batchGet.

التغييرات السلوكية

إيقاف الإصدار 4.x من واجهة برمجة التطبيقات لنظام "حسابات Google" نهائيًا
تم إيقاف
accounts وaccounts.admins وaccounts.invitations وaccounts.locations.admins نهائيًا في Google My Business API. يمكنك الاطّلاع على سجلّ التغييرات المتعلّقة بالإيقاف النهائي للحصول على مزيد من المعلومات.
المشاركات التي تتضمّن عبارات حث على اتّخاذ إجراء
في الربع الثاني من عام 2021، CallToAction لن تعود المشاركات التي تتضمّن GET_OFFER ActionType صالحة.

v4.8

ميزات جديدة

وسائل الراحة في مكان الإقامة
استرداد وتعديل وسائل الراحة في مكان الإقامة مزيد من المعلومات
إضافة نقطة نهاية GetGoogleUpdated لخدمات الإقامة
إضافة القيمة المنطقية canOperateLodgingData في LocationState
سمات مقدّمي الرعاية الصحية
استرداد وتعديل HealthProviderAttributes مزيد من المعلومات
إضافة القيمة المنطقية canOperateHealthData في LocationState
شبكات التأمين
قائمة شبكات التأمين المقبولة حسب المواقع الجغرافية مزيد من المعلومات

التغييرات السلوكية

أرقام تعريف المراجعات
تم نقل أرقام تعريف المراجعات إلى تنسيق جديد. سيتم الآن عرض هذا المعرّف الجديد في جميع ردود واجهة برمجة التطبيقات السارية. لفترة قصيرة، سيظلّ بإمكانك استخدام أرقام تعريف المراجعات القديمة لاستدعاء واجهة برمجة التطبيقات، ولكن من المهمّ تعديل جميع أرقام تعريف المراجعات المخزّنة في نظامك خلال 30 يومًا على النحو المطلوب بموجب سياساتنا من خلال استدعاء نقطة النهاية listReviews.
النشاط التجاري لمنطقة نطاق الخدمة
في الربع الأول من عام 2021، لن يتم عرض Address في عنصر الموقع الجغرافي للأنشطة التجارية على CUSTOMER_LOCATION_ONLY.

v4.7

ميزات جديدة

قوائم الطعام
استرداد وتعديل قوائم الطعام مزيد من المعلومات

v4.6

ميزات جديدة

قوائم الخدمات
يمكنك الآن استرداد وتعديل الخدمات التي يقدّمها النشاط التجاري. مزيد من المعلومات
إضافة قيمة منطقية canModifyServiceList في LocationState
يشير إلى ما إذا كان الموقع الجغرافي مؤهلاً لتعديل قوائم الخدماتمزيد من المعلومات
ServiceTypes المحدّد مسبقًا للفئات
يتم الآن تضمين أنواع الخدمات المحدّدة مسبقًا كما هو الحال في عنصر الفئات.مزيد من المعلومات
CategoryView
إمكانية تحديد طريقة عرض BASIC أو FULL للفئات ستعرض طريقة العرض FULL تفاصيل إضافية، مثل أنواع الخدمات. مزيد من المعلومات
طريقة Categories.BatchGet
تسمح لك هذه الطريقة الجديدة بإدخال قائمة بالفئات وعرض معلومات عن هذه الفئات فقط. مزيد من المعلومات

الإصدار 4.5، التعديل 2 المتعلّق بفيروس كورونا المستجد (كوفيد-19)

ميزات جديدة

نوع مشاركة التنبيه بشأن فيروس كورونا المستجد (كوفيد-19)
يمكنك الآن إنشاء COVID_19 من خلال واجهة برمجة التطبيقات. مزيد من المعلومات:

الإصدار 4.5، التعديل 1 المتعلّق بفيروس كورونا المستجد (كوفيد-19)

ميزات جديدة

مغلق مؤقتًا
يمكنك الآن ضبط نشاط تجاري على CLOSED_TEMPORARILY من خلال واجهة برمجة التطبيقات. مزيد من المعلومات:

v4.5

ميزات جديدة

Pub/Sub لأسئلة وأجوبة
يمكنك الآن تلقّي إشعارات من Google Cloud Pub/Sub بشأن الأسئلة والإجابات الجديدة أو المعدَّلة في موقع جغرافي معيّن. مزيد من المعلومات:
Pub/Sub لحالة البيانات
يمكنك الآن تلقّي إشعارات من Google Cloud Pub/Sub عند حدوث تغيير في حالة بيانات المنتج. مزيد من المعلومات:

v4.4

ميزات جديدة

عمليات إثبات ملكية الأنشطة التجارية التي توفّر خدمات محلّية
يمكن الآن إثبات ملكية الأنشطة التجارية المحلية من خلال واجهة برمجة التطبيقات. مزيد من المعلومات:
عدد المتابعين
يمكنك الآن استرداد البيانات الوصفية حول المتابعين. مزيد من المعلومات:
مجموعات المستخدمين ومجموعات المواقع الجغرافية
يمكن الآن إنشاء مجموعات المستخدمين ومجموعات المواقع الجغرافية من خلال واجهة برمجة التطبيقات. مزيد من المعلومات
إضافة حقل hasPendingEdits في LocationState
يشير إلى ما إذا كانت سمات الموقع الجغرافي في حالة تعديل في انتظار المراجعة. مزيد من المعلومات

تغييرات السلوك

تذكرة بدون تاريخ محدّد
يمكنك الآن تحديد تاريخ افتتاح مستقبلي لمكان.
PointRadius
أصبحت سمة
PointRadius متاحة للقراءة فقط. سيتطلب تعديل الأنشطة التجارية المحلية أو إنشاؤها استخدام الأماكن.

v4.3

الميزات الجديدة

واجهات برمجة التطبيقات للأسئلة والأجوبة
يمكنك استرداد الأسئلة ونشر الإجابات وتقديم الأسئلة الشائعة حول المواقع الجغرافية لنشاطك التجاري. مزيد من المعلومات:
قراءة المراجعات بشكل مجمّع
يمكنك استرداد المراجعات لمواقع جغرافية متعددة في مكالمة واحدة. مزيد من المعلومات:
المواقع الجغرافية المقترَحة من Google
الاطّلاع على المواقع الجغرافية غير المُطالب بها التي تعتقد Google أنّها مملوكة لك مزيد من المعلومات:
الإبلاغ عن مشاكل GoogleLocation
الإبلاغ عن مشاكل في نتائج RecommendedGoogleLocations أو GoogleLocations مزيد من المعلومات:
قائمة الخدمات الخاصة بأقسام PriceList
حدِّد قسم PriceList على أنّه يتضمّن إما سلعًا غذائية أو خدمات مقدَّمة. مزيد من المعلومات:
وصف الوسائط
قدِّم شرحًا عند تحميل وسائط جديدة. مزيد من المعلومات:
CHAINS_QUERIES الإحصاءات
استرداد عدد المرات التي ظهر فيها موقع جغرافي نتيجة بحث عن السلسلة التي ينتمي إليها مزيد من المعلومات:

تغييرات السلوك

الإشعارات لحسابات المؤسسات ومجموعات المواقع الجغرافية
ستتلقّى الآن الحسابات التي تم ضبطها لتلقّي إشعارات Pub/Sub هذه الإشعارات أيضًا بشأن أي بيانات مضمّنة في حساب مؤسسة أو مجموعات مواقع جغرافية يكون فيها المشرف.
‫ListLocations لحساب المؤسسة ومجموعات المواقع الجغرافية
عند استدعاء
accounts.locations.list باستخدام حساب مجموعة مستخدمين أو حساب مؤسسة، يعرض الآن جميع المواقع الجغرافية التي يمكن لهذا الحساب الوصول إليها.

v4.2

الميزات الجديدة

Verifications API
يمكنك إدراج طرق إثبات الملكية المتاحة للمواقع الجغرافية التي لم يتم إثبات ملكيتها وبدء استخدامها. مزيد من المعلومات:
GoogleLocations API
ابحث عن المواقع الجغرافية الحالية على Google للمطالبة بها أو استرداد رابط لطلب الوصول إلى المواقع الجغرافية التي تمّت المطالبة بها. مزيد من المعلومات:
فلاتر المواقع الجغرافية الموسّعة
خيارات إضافية لتقييد النتائج التي يتم عرضها من طلب Locations.List مزيد من المعلومات:
العضوية في سلسلة القنوات
الإشارة إلى أنّ الموقع الجغرافي هو جزء من سلسلة (مثل Walmart أو Target أو غير ذلك) مزيد من المعلومات:
معلومات المؤسسة
ستظهر الآن معلومات حسابات المؤسسات كجزء من عناصر الحساب. مزيد من المعلومات:
صورة الملف الشخصي للمُراجع
يتم الآن تضمين عناوين URL لصور الملفات الشخصية للمراجعين في عنصر المراجعة. مزيد من المعلومات:

v4.1

الميزات الجديدة

الوسائط المقدَّمة من العميل
يمكنك الآن استرداد إحصاءات الصور والفيديوهات التي أنشأها المستخدمون للمواقع الجغرافية التي تملكها وتديرها. مزيد من المعلومات:
واجهات برمجة تطبيقات إدارة المشرف
يمكنك الآن إدراج الدعوات المرتبطة بحسابك وموقعك الجغرافي وقبولها ورفضها. مزيد من المعلومات:
Profile (الوصف المقدَّم من التاجر)
صِف نشاطك التجاري بأسلوبك الخاص وشارِك مع المستخدمين قصة نشاطك التجاري وعروضك الفريدة. مزيد من المعلومات:
openingDate الحقل
قدِّم تاريخ افتتاح موقعك الجغرافي. مزيد من المعلومات:
المشاركات التي تتضمّن نوع العرض
نوع جديد من "المشاركات على Google"، تساعد المستخدمين في العثور على الصفقات المتاحة في مواقعك الجغرافية. مزيد من المعلومات:

v4

الميزات الجديدة

مشاركات على Google
يمكنك الآن إنشاء "مشاركات على Google" مباشرةً من خلال واجهة برمجة التطبيقات.
تحميل صور
أصبح بإمكانك الآن تحميل الصور مباشرةً من خلال واجهة برمجة التطبيقات بالإضافة إلى ميزةتحميل باستخدام عنوان URL
الحالية.
فلترة الإشعارات/تفعيلها
يمكنك الآن فلترة الإشعارات التي يتم إرسالها إلى مواضيع PubSub. ستستخدِم الإشعارات المستقبلية هذه الآلية للموافقة عليها بدلاً من إرسالها إلى جميع المستخدمين.
UPDATED_REVIEW إشعار
يمكنك الآن الاشتراك في خدمة تلقّي إشعارات في الوقت الفعلي بشأن آخر المعلومات المتعلّقة بمراجعات العملاء.
إتاحة مجموعات المستخدمين
تتيح Google My Business API الآن الحسابات من النوع "مجموعة مستخدمين".

التغييرات غير المتوافقة مع الإصدارات القديمة

  • إنّ "الصور"، التي كانت في السابق حقلًا من location عنصر، هي الآن مورد ضمن الموقع الجغرافي (accounts/account_ID/locations/location_ID/photos).

  • أصبح حقل العنوان Country هو region_code وsub_locality هو sublocality.

  • تمت إزالة حقل Ownership الذي تم إيقافه نهائيًا في السابق.

  • في السابق، كان من الصعب التمييز بين المالكِين المشاركِين في الحسابات والمواقع الجغرافية والمالكِين الأساسيِين من خلال واجهة برمجة التطبيقات (حيث كان يظهر الجميع على أنّهم OWNER). أمّا الآن، فسيتم منح المالكِين الأساسيين الدور OWNER، وسيتم منح المالكِين الآخرين الدور CO_OWNER.

  • أصبح اسم الجهاز AccountType.BUSINESS الآن AccountType.LOCATION_GROUP.

  • عند استخدام قناع حقل لتعديل المواقع الجغرافية، قدِّم update_mask بدلاً من field_mask الحالي.

  • رسالة الفئة المستخدَمة لكلّ من primary_category وadditional_categories لم تعُد تتضمّن النموذج القابل للقراءة. على المستخدمين استخدام فئة خدمة Google My Business API للحصول على أسماء فئات مترجَمة وسهلة القراءة.

v3.3

الميزات الجديدة

القوائم المنظَّمة

يمكنك الآن إضافة ما يلي أو تعديله أو حذفه:

  • قوائم طعام متعددة في موقع جغرافي معيّن

  • تضمين أقسام قوائم متعددة ضمن قائمة

  • إدراج أصناف قائمة الطعام مع الاسم والوصف والسعر والصور

v3.2

الميزات الجديدة

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

التغييرات غير المتوافقة مع الإصدارات القديمة

  • تمّت إزالة حقلَي languageCodes وplatforms في UrlAttributeValue، لأنّهما لم يسبق استخدامهما.

  • لا ينطبق الرمز البرمجي SAME في قائمة القيم المحدَّدة للملكية التي سيتم إيقافها نهائيًا الآن إلا إذا كان الموقع الجغرافي الذي يتم تكراره يملك المالك الأساسي نفسه. في السابق، كان السلوك يستند إلى عملية حسابية أكثر تعقيدًا للملك.

v3.1

الميزات الجديدة

الإشعارات
يمكنك الآن الاشتراك في خدمة تلقّي إشعارات في الوقت الفعلي بشأن المراجعات الجديدة.
عناوين URL لـ "خرائط Google"
يتم تضمين عناوين URL الخاصة بخرائط Google في ردود المواقع الجغرافية، ما يتيح للمستخدمين الربط بخرائط Google بسهولة.
الولايات التي يقع فيها الموقع الجغرافي
حالات المواقع الجغرافية الإضافية التي تشير إلى حالات نشر البيانات أو إيقافها أو حالتها في انتظار إثبات الملكية
علامة إعادة الفتح
تشير علامة
canReopen إلى المواقع الجغرافية المغلقة نهائيًا التي يمكن إعادة فتحها مقارنةً بالمواقع التي لا يمكن إعادة فتحها.
السمات
إتاحة سمتَي URL وEnum
نقطة نهاية الفئة
الحصول على قائمة بالفئات المتاحة حسب البلد واللغة (يحلّ محلّ ملفات CSV )

v3

الميزات الجديدة

المراجعات
يمكنك الآن استرداد مراجعات الأنشطة التجارية والردّ عليها من خلال واجهة برمجة التطبيقات.
السمات
قدِّم معلومات إضافية خاصة بالفئة عن المواقع الجغرافية.
العثور على الموقع الجغرافي المطابق
ابحث عن المواقع الجغرافية الحالية على الخرائط واربطها يدويًا بموقع نشاطك التجاري.
الموقع الجغرافي الذي سيتم نقل البيانات إليه
إجراء جديد على Location :transfer السماح بنقل موقع جغرافي من حساب (تجاري أو شخصي) إلى آخر
الصورة المفضَّلة
حدِّد الصورة التي تفضّل أن تظهر أولاً في "خرائط Google" و"بحث Google".
فلاتر بحث جديدة
تشمل فلاتر البحث الجديدة any_google_updates وis_suspended و is_duplicate.
حالات الموقع الجغرافي الجديد
تشمل
حالات الموقع الجغرافي الآن أيضًا is_verified وneeds_reverification.
تحسينات على عناوين URL للصور
تقبل واجهة برمجة التطبيقات الآن عناوين URL للصور بدون إضافة لاحقة تنسيق الصورة.

التغييرات غير المتوافقة مع الإصدارات القديمة

  • لا يمكن الآن تعديل الصور إلا للمواقع الجغرافية التي لها صفحة على Google+ (كانت هذه المواقع الجغرافية مقبولة وتم إسقاطها بدون إشعار سابق).

  • أصبح حقلَا location_name وcategory_name الآن للإخراج فقط. استخدِم معرّفات الفئات فقط عند ضبط الفئات.

  • يجب ألّا تتضمّن أقنعة الحقول البادئة location. للحقول المضمّنة.

  • تأخذ عمليات الإنشاء/التعديل الآن الموقع الجغرافي كحمولة للنصّ، ويتم نقل المَعلمات الأخرى إلى سلسلة طلب البحث.

v2

التغييرات غير المتوافقة مع الإصدارات القديمة

  • يجب الآن تحديد request_id في CreateLocation المكالمات. يجب أن يكون رقم التعريف هذا فريدًا لكل موقع جغرافي، إذ يساعد في منع إنشاء مواقع جغرافية مكرّرة في حسابك. إنّ محاولات إنشاء موقع جغرافي يطابق فيه رقم تعريف الطلب أحد المواقع الجغرافية التي تم إنشاؤها سابقًا تؤدي ببساطة إلى عرض الموقع الجغرافي الحالي، وتتجنّب إنشاء نسخة مكرّرة في حسابك.