الاطّلاع على حالة تعديل المواقع الجغرافية والسمات

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

تتيح لك نقاط نهاية "حالة التعديل" في v1alpha استرداد عرض موحّد لموقع جغرافي أو سماته في طلب واحد:

  • البيانات المقدَّمة من التاجر: القيم التي أرسلها التاجر مؤخرًا.
  • البيانات الموجّهة للمستهلكين: هي القيم التي تظهر على "بحث Google" و"خرائط Google".
  • البيانات الوصفية الموسّعة للحقول: حالة التعديل لكل حقل أو سمة، بما في ذلك مرحلة دورة حياة آخر تعديل، والمصدر الأصلي (API أو UI)، والطابع الزمني لآخر تعديل، وأي سبب لانتهاك السياسة في حال رفض التعديل.

قبل البدء

قبل استخدام My Business Business Information API، عليك تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0. لمعرفة التفاصيل حول كيفية البدء، يُرجى الاطّلاع على الإعداد الأساسي.

استرداد بيانات الموقع الجغرافي الموسّعة

لفحص بيانات الموقع الجغرافي التي يقدّمها التاجر، وبيانات الموقع الجغرافي الموجَّهة للمستهلكين، وحالة التعديل لكل حقل في موقع جغرافي معيّن، يمكنك استدعاء locations.getExtended.

على عكس locations.get، لا يتطلّب locations.getExtended مَعلمة readMask ويعرض مورد ExtendedLocation بالكامل.

طلب

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}:getExtended

الردّ

يحتوي الردّ على ثلاثة حقول من المستوى الأعلى:

  • locationProvidedByMerchant: بيانات Location كما يديرها التاجر
  • locationSeenByConsumers: بيانات Location التي تظهر للمستهلكين على "بحث Google" و"خرائط Google"
  • ‫extendedFieldData: خريطة لأسماء حقول Location ذات المستوى الأعلى في snake_case (مثل title أو phone_numbers أو website_uri أو storefront_address أو regular_hours) إلى كائنات ExtendedFieldData. تكون المفاتيح دائمًا أسماء حقول عادية على المستوى الأعلى، وليست حقولاً فرعية مدمجة.
{
  "locationProvidedByMerchant": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters - Best Coffee in Sydney",
    "phoneNumbers": {
      "primaryPhone": "02 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "locationSeenByConsumers": {
    "name": "locations/{locationId}",
    "title": "Example Coffee Roasters",
    "phoneNumbers": {
      "primaryPhone": "+61 2 5550 1234"
    },
    "websiteUri": "https://www.example.com/"
  },
  "extendedFieldData": {
    "title": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_REJECTED",
      "rejectionReason": "MISREPRESENTATION",
      "updateTime": "2026-09-25T08:00:00Z",
      "source": "SOURCE_API"
    },
    "phone_numbers": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE",
      "updateTime": "2026-09-20T14:15:00Z",
      "source": "SOURCE_UI"
    },
    "website_uri": {
      "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
      "updateTime": "2026-09-15T10:30:00Z",
      "source": "SOURCE_API"
    }
  }
}

استرداد بيانات السمات الموسّعة

لفحص القيم التي يقدّمها التاجر والقيم الموجَّهة للمستهلكين وحالة التعديل لسمات موقع جغرافي معيّن، يمكنك استدعاء locations.attributes.getExtended.

طلب

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/locations/{locationId}/attributes:getExtended

الردّ

يعرض الردّ مورد ExtendedAttributes يحتوي على قائمة بإدخالات ExtendedAttribute. يقرن كل إدخال attributeProvidedByMerchant وattributeSeenByConsumers بعنصر extendedFieldData لتلك السمة:

{
  "name": "locations/{locationId}/attributes",
  "extendedAttributes": [
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/has_wheelchair_accessible_entrance",
        "valueType": "BOOL",
        "values": [
          true
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_ACCEPTED",
        "updateTime": "2026-09-10T12:00:00Z",
        "source": "SOURCE_API"
      }
    },
    {
      "attributeProvidedByMerchant": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "free_wi_fi"
        ]
      },
      "attributeSeenByConsumers": {
        "name": "attributes/wi_fi",
        "valueType": "ENUM",
        "values": [
          "paid_wi_fi"
        ]
      },
      "extendedFieldData": {
        "lastEditLifecycleStage": "EDIT_LIFECYCLE_STAGE_PENDING",
        "updateTime": "2026-09-28T16:45:00Z",
        "source": "SOURCE_API"
      }
    }
  ]
}

فهم البيانات الوصفية الموسّعة للحقول

يحتوي كل عنصر ExtendedFieldData على الحقول التالية:

الحقل النوع الوصف
lastEditLifecycleStage EditLifecycleStage حالة الإشراف أو العرض لآخر تعديل تم إجراؤه على هذا الحقل أو السمة.
rejectionReason PolicyViolation انتهاك السياسة الذي أدّى إلى رفض التعديل يتم ملء هذا الحقل عندما تكون قيمة lastEditLifecycleStage هي EDIT_LIFECYCLE_STAGE_REJECTED.
updateTime string ‏(Timestamp) الطابع الزمني لآخر تعديل تم إرساله لهذا الحقل أو السمة (بتنسيق RFC 3339).
source Source مساحة العرض الأصلية التي أرسل التاجر التعديل من خلالها (SOURCE_API أو SOURCE_UI)

تعديل مراحل الاشتراك

يشير التعداد EditLifecycleStage إلى مرحلة التعديل في دورة حياته:

القيمة الوصف الإجراء المقترَح
EDIT_LIFECYCLE_STAGE_ACCEPTED تمت الموافقة على تعديل التاجر، وهو مؤهَّل للعرض. لا يلزم أي إجراء.
EDIT_LIFECYCLE_STAGE_PENDING التعديل الذي أجراه التاجر قيد المراجعة ولم يتم تطبيقه على بطاقة البيانات الموجَّهة للمستهلكين. انتظِر حتى تكتمل عملية الإشراف. لا تُعِد إرسال تعديلات متطابقة بشكل متكرر عندما يكون أحد التعديلات في انتظار المراجعة.
EDIT_LIFECYCLE_STAGE_REJECTED لم يتم قبول تعديل التاجر. يُرجى الاطّلاع على rejectionReason لمعرفة قيمة PolicyViolation المحدّدة. يُرجى تصحيح انتهاك السياسة الأساسي وإرسال تحديث جديد باستخدام locations.patch أو locations.updateAttributes.
EDIT_LIFECYCLE_STAGE_UPDATED_BY_GOOGLE عدّلت Google القيمة المُوجَّهة للمستهلكين (على سبيل المثال، من تقارير المستخدمين أو المصادر الخارجية) وهي تختلف عن القيمة التي قدّمها التاجر. راجِع قيمة locationSeenByConsumers أو attributeSeenByConsumers واقبلها أو تجاوَزها. يُرجى الاطّلاع على المقالة إدارة التعديلات من Google.
EDIT_LIFECYCLE_STAGE_DRAFT تم حفظ التعديل كمسودة (على سبيل المثال، في موقع جغرافي لم يتم التحقّق منه) وهو غير منشور على "بحث Google" و"خرائط Google". أكمِل عملية إثبات صحة معلومات الموقع الجغرافي ليتم نشر بيانات المتجر.
EDIT_LIFECYCLE_STAGE_UNSPECIFIED مرحلة دورة حياة التعديل غير معروفة أو غير محدّدة. بلا عُري

تعديل المصادر

يحدّد التعداد Source القناة التي أرسل التاجر التعديل من خلالها:

  • SOURCE_API: تم إرسال التعديل من خلال My Business Business Information API.
  • SOURCE_UI: تم إرسال التعديل من خلال واجهة مستخدم الويب أو تطبيق الأجهزة الجوّالة في "الملف التجاري".
  • ‫SOURCE_UNSPECIFIED: لم يتم تحديد مصدر التعديل.

انتهاكات السياسات

عندما تكون قيمة lastEditLifecycleStage هي EDIT_LIFECYCLE_STAGE_REJECTED، يوفّر حقل rejectionReason قيمة تعداد PolicyViolation توضّح سبب رفض التعديل. تشمل أسباب الرفض المجالات التالية (أمثلة):

  • حالة الملف الشخصي والحساب: ACCOUNT_RESTRICTED_AND_SUSPENDED وACCOUNT_RESTRICTED_AND_EDIT_REJECTED وASSOCIATED_ACCOUNT_SUSPENDED وBUSINESS_INELIGIBLE وLOCATION_SUSPENDED وLOCATION_VERIFICATION_REQUIRED وOWNERSHIP_REVOKED وPO_BOX
  • قيود التعديل: EDITING_RESTRICTION وILLEGAL_BUSINESS_HOURS_EDIT وIDENTITY_CHANGE وGEOGRAPHIC_LOCATION_CHANGE
  • سياسات المحتوى: MISREPRESENTATION وOFF_TOPIC وPERSONAL_INFO وGIBBERISH_AND_REPETITIVE وOBSCENITY_AND_PROFANITY وGENERIC_QUALITY

للاطّلاع على القائمة الكاملة لقيم التعداد وأوصافها، يُرجى مراجعة المستندات المرجعية لـ PolicyViolation.