للحفاظ على دقة بيانات ملفك التجاري قدر الإمكان، تستخدم Google معلومات من مصادر مثل بلاغات المستخدمين والمحتوى المرخَّص. إذا تم الإبلاغ عن أنّ المعلومات التي قدّمها مالكو الأنشطة التجارية غير صحيحة، ستبلغ Google مالكي بطاقات البيانات بذلك. ويمكن لمالكي بطاقات البيانات بعد ذلك قبول التعديلات أو رفضها.
وبصفتك مالكًا لبطاقة بيانات، تتيح لك واجهة برمجة تطبيقات معلومات نشاطي التجاري على Google مراجعة هذه التعديلات للتأكد من دقة معلومات نشاطك التجاري. يشرح هذا الدليل كيفية قبول التعديلات أو رفضها.
لإدارة تحديثات Google، أكمل الخطوات التالية:
- العثور على المواقع الجغرافية التي لها تحديثات في انتظار المراجعة
- مراجعة الحقول المعدَّلة
- قبول التحديثات أو رفضها
- مراجعة النتائج
البحث عن المواقع الجغرافية التي تتضمَّن تحديثات في انتظار المراجعة
قبل أن تتمكّن من قبول التعديلات أو رفضها، عليك معرفة المواقع الجغرافية التي تتوفّر بها "تحديثات Google". أفضل طريقة للحصول على "آخر الأخبار من Google" للمواقع الجغرافية هي
إدارة الإشعارات في الوقت الفعلي من خلال
Cloud Pub/Sub. إذا وصلك إشعار GOOGLE_UPDATE
حول موضوع النشر/الاشتراك، سيكون بإمكانك مراجعة التغيير. ويقدّم الحقل locationName
في الإشعار اسم مورد الموقع الجغرافي ضمن "تحديثات Google".
ويمكنك بدلاً من ذلك الاطّلاع على رمز الطلب
locations.get
وفحص
Metadata
للتأكّد من توفُّر العلامة hasGoogleUpdated
. إذا كان "isGoogleUpdated": true
،
سيتم إجراء تعديلات على معرّف المكان المرتبط بهذا الموقع الجغرافي.
الطلب
في ما يلي مثال على طلب locations.get
:
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}
الطلب
إليك مثال على استجابة locations.get
:
{ "name": "locations/{locationId}", "title": "Test Business", "phoneNumbers": { "primaryPhone": "02 9374 4000" }, ... "metadata": { "hasGoogleUpdated": true, ... } ... }
مراجعة حقول التعديلات
لمراجعة الحقول المحدّدة التي تحتوي على "تعديلات Google"، يمكنك طلب locations.getGoogleUpdated
.
تكون سمة diffMask
التي توضّح الحقول التي عدَّلتها Google بالتفصيل في
نص الاستجابة.
الطلب
في ما يلي مثال على طلب locations.getGoogleUpdated
:
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}:googleUpdated
الإجابة
إليك مثال على استجابة locations.getGoogleUpdated
. ويعرض هذا التحديث تحديثًا متاحًا في الحقل phoneNumbers.primaryPhone. القيمة في هذه الاستجابة هي قيمة التحديث المقترَحة:
{ "location": { "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, ... }, "diffMask": "phoneNumbers.primaryPhone" }
قبول التحديثات أو رفضها
لقبول تعديل أو رفضه، نفِّذ locations.patch
باستخدام حقول updateMask التي تم ضبطها بالطريقة نفسها التي تم ضبطها في diffMask
التي حصلت عليها سابقًا. أيضًا، قم بمطابقة القيم المفضلة لكل حقل.
قبول طلب
في ما يلي مثال على طلب locations.patch
:
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone { "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, }
الإجابة
إليك مثال على استجابة locations.patch
:
{ "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "+1 111 111 1111" }, ... }
رفض طلب
في ما يلي مثال على طلب locations.patch
:
PATCH https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=phoneNumbers.primaryPhone { "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "222 222 2222" }, ... }
الإجابة
إليك مثال على استجابة locations.patch
:
{ "name": "locations/{locationId}", "locationName": "Test Business", "phoneNumbers": { "primaryPhone": "222 222 2222" }, ... }
مراجعة النتائج
إذا تم تصحيح موقعك الجغرافي بنجاح، يعرض الحقل diffMask
في الاستجابة locations.getGoogleUpdated
القيم على أنّها "diffMask": ""
. بالإضافة إلى ذلك، تعرض العلامة "hasGoogleUpdated"
في Metadata
القيمة على أنّها false
، أو لا تتوفّر أي قيمة.
إذا لم تكن قيم الحقول واضحة،
يُرجى التواصل مع
فريق الدعم لتقديم طلب بشأن getGoogleUpdated
والردّ عليه. ويجب أن يتضمّن الطلب الاستجابة قبل طلب
locations.patch
واستدعاء رمز التصحيح واستدعاء getGoogleUpdated
.