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

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

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

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

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

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

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

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

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

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

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

قبول طلب

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