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

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

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

لإدارة "تحديثات Google"، أكمِل الخطوات التالية:

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

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

قبل أن تتمكن من قبول أو رفض التحديثات، يجب عليك معرفة المواقع التي تحتوي على تحديثات Google المتوفرة. أفضل طريقة للحصول على تحديثات Google للمواقع هي إدارة الإشعارات في الوقت الفعلي باستخدام Cloud 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 في نص الردّ:

الطلب

فيما يلي 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.