v4.9
الميزات الجديدة
MoreHours
- يمكن الآن ضبط MoreHours كجزء من بيانات النشاط التجاري.
- يمكن استرداد قيمة
MoreHourTypes
لكل فئة باستخدام categories.batchGet.
التغييرات السلوكية
- إيقاف الإصدار 4.x من الحسابات إنّ
- الحسابات وaccounts.admins وaccounts.invitations وaccounts.locations.admins تم إيقافها نهائيًا الآن في واجهة برمجة تطبيقات "نشاطي التجاري على Google". يمكنك الاطّلاع على سجلّ تغييرات الإيقاف النهائي للحصول على مزيد من المعلومات.
- مشاركات الحث على اتخاذ إجراء
- في الربع الثاني من عام 2021، لن تكون المشاركات التي تتضمّن GET_OFFER
ActionType
صالحة.CallToAction
v4.8
الميزات الجديدة
- وسائل الراحة في السكن
- استرجاع وتحديث وسائل الراحة للإقامة. مزيد من المعلومات
- إضافة نقطة نهاية GetGoogleUpdated للإقامة
- إضافة قيمة منطقية
canOperateLodgingData
في LocationState - سمات مقدّمي الرعاية الصحية
- استرداد وتحديث HealthProviderAttributes مزيد من المعلومات
- إضافة قيمة منطقية
canOperateHealthData
في LocationState - شبكات تأمين
- إدراج شبكات التأمين المقبولة من قِبل المواقع الجغرافية مزيد من المعلومات
التغييرات السلوكية
- مراجعة أرقام التعريف
- تم نقل أرقام تعريف المراجعات إلى تنسيق جديد. سيتم الآن عرض هذا المعرّف الجديد في جميع الردود السارية من واجهة برمجة التطبيقات. لفترة زمنية قصيرة، سيستمر التعامل مع معرّفات المراجعات القديمة عند استخدامها لطلب بيانات من واجهة برمجة التطبيقات، ولكن من الضروري إعادة تحميل كل معرّفات المراجعات المخزّنة على نظامك خلال 30 يومًا بموجب سياساتنا من خلال طلب نقطة النهاية listReviews.
- نشاط تجاري ضمن منطقة الخدمة
- في الربع الأول من عام 2021، لن يتم عرض
Address
في عنصر الموقع الجغرافي للأنشطة التجارية علىCUSTOMER_LOCATION_ONLY
.
v4.7
الميزات الجديدة
- قوائم الطعام
- استرداد وتحديث Food Menus مزيد من المعلومات
v4.6
الميزات الجديدة
- قوائم الخدمات
- يمكنك الآن استرداد وتحديث الخدمات التي يقدمها النشاط التجاري. مزيد من المعلومات
- إضافة قيمة منطقية
canModifyServiceList
في LocationState - تشير إلى ما إذا كان الموقع الجغرافي مؤهَّلاً لتعديل قوائم الخدماتمزيد من المعلومات
ServiceTypes
محدد مسبقًا للفئات- أصبحت أنواع الخدمات المحدَّدة مسبقًا مضمّنة الآن في كائن الفئات.مزيد من المعلومات
- CategoryView
- إمكانية تحديد طريقة عرض
BASIC
أوFULL
للفئات. ستعرض طريقة العرضFULL
تفاصيل إضافية، مثل أنواع الخدمات. مزيد من المعلومات - طريقة Categories.BatchGet
- تتيح لك هذه الطريقة الجديدة إدخال قائمة بالفئات وعرض معلومات حول تلك الفئات فقط. مزيد من المعلومات
الإصدار 4.5 من التحديث الثاني حول فيروس كورونا المستجد (كوفيد-19)
الميزات الجديدة
- نوع مشاركة التنبيه بشأن فيروس كورونا المستجد (كوفيد-19)
- يمكنك الآن إنشاء مشاركة على
COVID_19
عبر واجهة برمجة التطبيقات. مزيد من المعلومات
الإصدار 4.5 من التحديث 1 حول فيروس كورونا المستجد (كوفيد-19)
الميزات الجديدة
- مغلق مؤقتًا
- يمكنك الآن ضبط نشاط تجاري على
CLOSED_TEMPORARILY
عبر واجهة برمجة التطبيقات. مزيد من المعلومات
v4.5
الميزات الجديدة
- النشر/الاشتراك للأسئلة والأجوبة
- يمكنك الآن تلقّي إشعارات Google Cloud Pub/Sub عن الأسئلة والإجابات الجديدة/المحدَّثة حول موقع جغرافي. مزيد من المعلومات
- النشر/الاشتراك لحالة البيانات
- يمكنك الآن تلقّي إشعارات Google Cloud Pub/Sub لتغيير حالة بطاقة البيانات. مزيد من المعلومات
v4.4
الميزات الجديدة
- عمليات إثبات ملكية الأنشطة التجارية الخدمية المحلية
- يمكن الآن إثبات ملكية الأنشطة التجارية الخدمية المحلية من خلال واجهة برمجة التطبيقات. مزيد من المعلومات
- عدد المتابعين
- يمكنك الآن استرداد البيانات الوصفية حول المتابعين. مزيد من المعلومات
- مجموعات المستخدمين ومجموعات المواقع الجغرافية
- يمكن الآن إنشاء مجموعات المستخدمين ومجموعات المواقع الجغرافية من خلال واجهة برمجة التطبيقات. مزيد من المعلومات
- إضافة حقل "
hasPendingEdits
" في LocationState - يشير هذا الإعداد إلى ما إذا كانت خصائص الموقع الجغرافي في حالة انتظار التعديل. مزيد من المعلومات
التغييرات في السلوك
- تذكرة بدون تاريخ محدّد
- يمكنك الآن تحديد تاريخ افتتاح في المستقبل لبطاقة بيانات.
PointRadius
- ميزة PointRadius متاحة للقراءة فقط الآن. ستتطلب تعديلات أو إنشاء الأنشطة التجارية الخدمية المحلية استخدام الأماكن.
v4.3
الميزات الجديدة
- واجهات برمجة التطبيقات للأسئلة والأجوبة
- يمكنك استرداد الأسئلة ونشر الإجابات وتقديم الأسئلة الشائعة حول المواقع الجغرافية لنشاطك التجاري. مزيد من المعلومات
- قراءة المراجعات بشكل مجمّع
- يمكنك استرداد المراجعات لمواقع متعددة في مكالمة واحدة. مزيد من المعلومات
- مواقع GoogleLocations المقترَحة
- الاطّلاع على المواقع الجغرافية التي لم تتم المطالبة بها والتي تعتقد Google أنّها قد تملكها. مزيد من المعلومات
- الإبلاغ عن مشاكل GoogleLocation
- يمكنك الإبلاغ عن مشاكل في نتائج
RecommendedGoogleLocations
أوGoogleLocations
. مزيد من المعلومات - تعداد الخدمة لـ
PriceList
قسم - يُرجى تحديد قسم
PriceList
على أنّه يحتوي على أصناف طعام أو خدمات مقدَّمة. مزيد من المعلومات - وصف الوسائط
- يمكنك تقديم شرح عند تحميل وسائط جديدة. مزيد من المعلومات
CHAINS_QUERIES
إحصاءات- يمكنك استرداد عدد مرات عرض موقع جغرافي كنتيجة بحث عن السلسلة التي ينتمي إليها الموقع. مزيد من المعلومات
التغييرات في السلوك
- الإشعارات لحسابات المؤسسة ومجموعات المواقع الجغرافية
- ستتلقّى الآن الحسابات التي تم إعدادها لإشعارات النشر/الاشتراك هذه الإشعارات أيضًا لأي بطاقات بيانات مضمّنة في حساب مؤسسة أو مجموعات مواقع جغرافية تخضع لإشرافهما.
ListLocations
لحساب المؤسسة ومجموعات المواقع الجغرافية- تعرض الآن ميزة
accounts.locations.list
التي تم الاتصال بها باستخدام مجموعة مستخدمين أو حساب مؤسسة جميع المواقع الجغرافية التي يمكن الوصول إليها من خلال هذا الحساب.
v4.2
الميزات الجديدة
- واجهات برمجة تطبيقات التحقق
- سرد طرق إثبات الملكية المتاحة للمواقع الجغرافية التي لم يتم إثبات ملكيتها وتشغيلها مزيد من المعلومات
- واجهة برمجة تطبيقات GoogleLocations
- ابحث عن المواقع الجغرافية الحالية على Google للمطالبة بها أو استرِد رابطًا لطلب الوصول إلى المواقع الجغرافية التي تمت المطالبة بها. مزيد من المعلومات
- فلاتر الموقع الجغرافي الموسَّعة
- خيارات إضافية للحد من النتائج التي يتم عرضها من استدعاء Locations.List: مزيد من المعلومات
- عضوية السلسلة
- الإشارة إلى العضوية في موقع جغرافي كجزء من سلسلة (مثل Walmart أو Target أو غير ذلك). مزيد من المعلومات
- معلومات المؤسسة
- سيتم الآن عرض معلومات حسابات المؤسسة كجزء من كائنات الحساب. مزيد من المعلومات
- صورة الملف الشخصي للمُراجع
- تم الآن تضمين عناوين URL لصور الملفات الشخصية للمراجعين في عنصر المراجعة. مزيد من المعلومات
v4.1
الميزات الجديدة
- الوسائط المقدّمة من العميل
- يمكنك الآن استرداد وعرض الإحصاءات للصور والفيديوهات من إنشاء المستخدمين للمواقع الجغرافية التي تملكها وتديرها. مزيد من المعلومات
- واجهات برمجة تطبيقات إدارة المشرف
- يمكنك الآن إدراج وقبول ورفض الدعوات المتعلقة بالحساب والموقع الجغرافي لحسابك. مزيد من المعلومات
Profile
(وصف مقدَّم من التاجر)- قدِّم وصفًا لنشاطك التجاري بأسلوبك الخاص وشارِك القصة الفريدة لنشاطك التجاري وعروضك مع المستخدمين. مزيد من المعلومات
- حقل
openingDate
- أدخِل تاريخ افتتاح موقعك الجغرافي للنشاط التجاري. مزيد من المعلومات
- مشاركات أنواع العروض
- نوع جديد من "المشاركات على Google" يساعد المستخدمين في العثور على الصفقات المتاحة في مواقعك الجغرافية. مزيد من المعلومات
v4
الميزات الجديدة
- مشاركات على Google
- يمكنك الآن إنشاء "مشاركات على Google" مباشرةً من خلال واجهة برمجة التطبيقات.
- تحميل صور
- يمكن الآن تحميل الصور مباشرةً عبر واجهة برمجة التطبيقات إلى جانب تحميل عنوان URL الحالي.
- تفعيل الإشعارات وفلترة الإشعارات
- يمكنك الآن فلترة الإشعارات التي يتم إرسالها إلى مواضيع pubsub. ستستخدم الإشعارات المستقبلية هذه الآلية لتفعيل الميزة بدلاً من إرسالها إلى جميع المستخدمين.
UPDATED_REVIEW
إشعار- يمكنك الآن الاشتراك في إشعارات في الوقت الفعلي لمعرفة آخر الأخبار عن مراجعات العملاء.
- دعم لمجموعات المستخدمين
- تتيح واجهة برمجة تطبيقات "نشاطي التجاري على Google" الآن استخدام الحسابات من نوع مجموعات المستخدمين.
التغييرات غير المتوافقة مع الإصدارات السابقة
وأصبحت الصور في السابق حقلاً للكائنات
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" للحصول على أسماء فئات مترجمة وسهلة القراءة للمستخدم.
v3.3
الميزات الجديدة
- القوائم المنظَّمة
يمكنك الآن إضافة ما يلي أو تعديله أو حذفه:
القوائم المتعددة في موقع معين
تضمين أقسام متعددة في القائمة داخل قائمة
إدراج عناصر في القائمة مع الاسم والوصف والسعر والصور
v3.2
الميزات الجديدة
- الإحصاءات
- يمكنك الآن استرداد إحصاءات المواقع الجغرافية ومقاييس القيادة من خلال واجهة برمجة التطبيقات.
- الإشعارات
- يمكنك الآن الاشتراك في الإشعارات في الوقت الفعلي لتحديثات Google الجديدة.
التغييرات غير المتوافقة مع الإصدارات السابقة
تمت إزالة الحقلين
languageCodes
وplatforms
غير المستخدَمين سابقًا للحقلUrlAttributeValue
.SAME
في تعداد الملكية الذي تم إيقافه نهائيًا لا ينطبق الآن إلا إذا كان للموقع الجغرافي الذي تم فيه إنشاء هذه النُسخ المكررة له المالك الأساسي نفسه. في السابق، استند السلوك إلى عمليات حسابية أكثر تعقيدًا للملكية.
v3.1
الميزات الجديدة
- الإشعارات
- يمكنك الآن الاشتراك في إشعارات في الوقت الفعلي بشأن المراجعات الجديدة.
- عناوين URL لـ "خرائط Google"
- يتم تضمين عناوين URL الخاصة بـ "خرائط Google" في الردود على الموقع الجغرافي، ما يتيح للمستخدمين الربط بسهولة مع "خرائط Google".
- حالات المواقع الجغرافية
- حالات إضافية للمواقع الجغرافية تشير إلى وقت نشر بطاقة البيانات أو إيقافها أو في انتظار التحقق.
- علامة إعادة الفتح
- تشير علامة
canReopen
إلى المواقع الجغرافية المغلقة نهائيًا التي يمكن إعادة فتحها مقارنةً بالمواقع التي لا يمكن إعادة فتحها. - السمات
- توافق مع سمتَي عنوان URL والتعداد
- نقطة نهاية الفئة
- احصل على قائمة بالفئات المتاحة حسب البلد واللغة (استبدال ملفات 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. ويجب أن يكون رقم التعريف هذا فريدًا لكل موقع جغرافي، إذ يساعد على منع إنشاء مواقع جغرافية مكرّرة في حسابك. وستؤدي محاولة إنشاء موقع يتطابق فيه رقم تعريف الطلب مع موقع جغرافي تم إنشاؤه مسبقًا إلى عرض الموقع الجغرافي الحالي، وتجنُّب إنشاء نسخة مكرّرة في حسابك.- تمت إعادة تسمية
business_hours
في الموقع الجغرافي إلىregular_hours
.
- تمت إعادة تسمية