בדיקת סטטוס העריכה של מיקומים ומאפיינים

כשמעדכנים את פרטי העסק דרך My Business Business Information API או דרך ממשק המשתמש של פרופיל העסק, העריכות עוברות תהליך של ניהול תוכן ואימות לפני שהן מופיעות בחיפוש Google ובמפות Google. בנוסף, Google עשויה לעדכן את פרטי העסק על סמך דיווחים של משתמשים או מקורות נתונים ברישיון.

נקודות הקצה של v1alpha Edit Status מאפשרות לאחזר תצוגה מאוחדת של מיקום או של המאפיינים שלו בבקשה אחת:

  • נתונים שסופקו על ידי המוכר: הערכים האחרונים שהמוכר שלח.
  • נתונים שמוצגים לצרכנים: הערכים מופיעים בחיפוש 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 ומאשרים או משנים אותו. ראה ניהול עדכוני גוגל.
EDIT_LIFECYCLE_STAGE_DRAFT העריכה נשמרה כטיוטה (לדוגמה, במיקום לא מאומת) והיא לא מוצגת בחיפוש Google ובמפות Google. כדי שהדף העסקי יתפרסם, צריך להשלים את אימות המיקום.
EDIT_LIFECYCLE_STAGE_UNSPECIFIED שלב מחזור החיים של העריכה לא ידוע או לא צוין. ללא.

עריכת המקורות

הערך enum של Source מזהה את הערוץ שדרכו המוכר שלח את העריכה:

  • ‫SOURCE_API: העריכה נשלחה דרך My Business Business Information API.
  • ‫SOURCE_UI: העריכה נשלחה דרך ממשק המשתמש של פרופיל העסק באינטרנט או דרך האפליקציה לנייד.
  • ‫SOURCE_UNSPECIFIED: מקור העריכה לא צוין.

הפרות המדיניות

כשהערך של lastEditLifecycleStage הוא EDIT_LIFECYCLE_STAGE_REJECTED, השדה rejectionReason מספק ערך enum מסוג 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.

הרשימה המלאה של ערכי ה-enum והתיאורים שלהם מופיעה במאמרי העזרה של PolicyViolation.