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

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

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

כדי לנהל את העדכונים של Google, צריך לבצע את השלבים הבאים:

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

חיפוש מיקומים עם עדכונים בהמתנה

לפני שתוכלו לאשר או לדחות עדכונים, עליכם לבדוק באילו מיקומים יש עדכוני Google זמינים. הדרך הטובה ביותר לקבל עדכונים של Google לגבי מיקומים היא לנהל את ההתראות בזמן אמת באמצעות Cloud Pub/Sub. אם קיבלת התראה GOOGLE_UPDATE לגבי נושא Pub/Sub, יש שינוי שכבר מוכן לבדיקתך. השדה locationName בהודעה מציין את שם המשאב של המיקום עם עדכוני Google.

אפשרות אחרת היא לראות את הקריאה locations.get ולבדוק אם הדגל hasGoogleUpdated נמצא ב-Metadata. אם הערך הוא "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.