ניהול העדכונים של Google

כדי שהפרטים בפרופיל העסק יהיו מדויקים ככל האפשר, Google משתמשת במידע ממקורות שונים, כמו דיווחי משתמשים ותוכן ברישיון. אם נקבל דיווחים שהמידע שסופק על-ידי הבעלים של העסק שגוי, Google תעדכן את הבעלים של כרטיס העסק. בעלי הדף העסקי יכולים לאשר או לדחות את העדכונים.

כבעלי כרטיסי מידע, ה-API של פרטי העסק ב-'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: 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: 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: locations.patch 

{
    "name": "locations/{locationId}",
    "locationName": "Test Business",
    "phoneNumbers": {
      "primaryPhone": "222 222 2222"
     },
    ...
}

עיון בתוצאות

אם הפעולה בוצעה ללא שגיאות, השדה diffMask בתגובה locations.getGoogleUpdated יציג את הערכים "diffMask": "". בנוסף, בדגל "hasGoogleUpdated" בתוך Metadata מוצג הערך false, או שלא מוצג ערך.

אם הערכים בשדות לא ברורים, אפשר לפנות לצוות התמיכה שלנו עם הבקשה והתשובה של getGoogleUpdated. הבקשה צריכה לכלול את התגובה לפני הקריאה locations.patch, קריאת התיקון והקריאה getGoogleUpdated.