إدارة تحديثات Google

للحفاظ على دقة بيانات ملفك التجاري قدر الإمكان، تستخدم Google معلومات من مصادر مثل تقارير المستخدمين والمحتوى المرخَّص. إذا تم الإبلاغ عن أنّ المعلومات التي قدّمها مالكو المؤسسات غير صحيحة، تُرسل Google إشعارًا إلى مالكي بطاقات البيانات. ويمكن لمالكي بطاقات البيانات بعد ذلك قبول التعديلات أو رفضها.

بصفتك مالك بطاقة بيانات، تتيح لك My Business Business Information API مراجعة هذه التعديلات للتأكّد من أنّ معلومات مؤسستك دقيقة. يوضّح هذا الدليل كيفية قبول التعديلات أو رفضها.

لإدارة التعديلات من Google، يُرجى اتّباع الخطوات التالية:

1. العثور على المواقع الجغرافية التي تتضمّن تعديلات في انتظار المراجعة
2. مراجعة الحقول المعدَّلة
3. قبول التعديلات أو رفضها
4. مراجعة النتائج

العثور على المواقع الجغرافية التي تتضمّن تعديلات في انتظار المراجعة

قبل قبول التعديلات أو رفضها، عليك معرفة المواقع الجغرافية التي تتوفّر لها تعديلات من Google. أفضل طريقة للحصول على تعديلات من Google للمواقع الجغرافية هي إدارة الإشعارات في الوقت الفعلي باستخدام Cloud Pub/Sub. إذا تلقّيت إشعارًا من GOOGLE_UPDATE بشأن موضوع Pub/Sub، يعني ذلك أنّ هناك تغييرًا جاهزًا للمراجعة. يوفّر الحقل 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" و"بحث Google") عن القيم المحلية المفضّلة لديك. ويحدث ذلك عادةً بسبب تعديلات من Google أو محتوى من إنشاء المستخدمين. يجب قبول هذه الحقول أو رفضها لحلّ التعارض.
• pendingMask: يشير إلى الحقول التي أرسلت تعديلاً لها في السابق، ولكن لا يزال التعديل قيد المعالجة ولم يتم نشره بعد على "خرائط Google" و"بحث 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"
}

قبول التعديلات أو رفضها

لحلّ الحقول المدرَجة في diffMask، عليك قبول التعديلات أو رفضها باستخدام طلب locations.patch:

• قبول تعديل: يمكنك تصحيح الموقع الجغرافي باستخدام القيمة الجديدة التي تم عرضها في استجابة getGoogleUpdated. يؤدي ذلك إلى تعديل السجلّ المحلي ليتطابق مع بيانات العرض.
• رفض تعديل: يمكنك تصحيح الموقع الجغرافي باستخدام القيمة المفضّلة الأصلية. يؤدي ذلك إلى إعادة تأكيد بياناتك المفضّلة من خلال مسار التعديل واستبدال البيانات المعروضة.

في كلتا الحالتين، اضبط updateMask لتغطية الحقول التي تريد حلّها.

قبول طلب

في ما يلي مثال على طلب 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.