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

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

بصفتك مالكًا لبطاقة بيانات، تتيح لك واجهة برمجة التطبيقات Business Information API في "نشاطي التجاري على Google" مراجعة هذه التعديلات للتأكّد من دقة معلومات نشاطك التجاري. يوضّح هذا الدليل كيفية قبول التحديثات أو رفضها.

لإدارة "آخر الأخبار من Google"، يُرجى إكمال الخطوات التالية:

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

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

قبل أن تتمكّن من قبول التعديلات أو رفضها، عليك معرفة المواقع الجغرافية التي تتوفّر فيها "تعديلات Google" . إنّ أفضل طريقة للحصول على آخر المعلومات من Google عن المواقع الجغرافية هي إدارة الإشعارات في الوقت الفعلي باستخدام Cloud Pub/Sub. إذا تلقّيت GOOGLE_UPDATE إشعارًا بشأن موضوع Pub/Sub، يعني ذلك أنّ التغيير جاهز للمراجعة. يقدّم حقل locationName في الإشعار اسم المورد للموقع الجغرافي الذي يتضمّن "تعديلات Google".

بدلاً من ذلك، يمكنك الاطّلاع على المكالمة locations.get وفحص Metadata بحثًا عن علامة hasGoogleUpdated. إذا كانت الإجابة ""isGoogleUpdated": true"، يعني ذلك أنّه تم إجراء تعديلات على معرّف المكان المرتبط بهذا الموقع الجغرافي.

الطلب

في ما يلي مثال على طلب locations.get:

بروتوكول HTTP
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:

بروتوكول HTTP
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:

بروتوكول HTTP
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:

بروتوكول HTTP
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.