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

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

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

لإدارة تحديثات 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.