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

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

בעלי דפים עסקיים יכולים להשתמש ב-API של פרטי העסק ב-'Google לעסק שלי' כדי לבדוק את העדכונים האלה ולוודא שפרטי העסק שלהם מדויקים. במדריך הזה נסביר איך לאשר או לדחות עדכונים.

כדי לנהל את עדכוני Google:

  1. איך מוצאים מיקומים עם עדכונים בהמתנה
  2. בדיקת השדות המעודכנים
  3. אישור או דחייה של עדכונים
  4. בדיקת התוצאות

איך למצוא מיקומים עם עדכונים בהמתנה

לפני שתוכלו לאשר או לדחות עדכונים, עליכם לבדוק אילו מיקומים זמינים לעדכונים של Google. הדרך הטובה ביותר לקבל עדכונים מ-Google לגבי מיקומים היא לנהל התראות בזמן אמת באמצעות Cloud Pub/Sub. אם קיבלתם התראה GOOGLE_UPDATE בנושא Pub/Sub, סימן שיש שינוי שזמין לבדיקה. השדה 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.