Method: locations.getGoogleUpdated

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

בקשת HTTP

GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/{name=locations/*}:getGoogleUpdated

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
name

string

חובה. שם המיקום שרוצים לאחזר.

פרמטרים של שאילתה

פרמטרים
readMask

string (FieldMask format)

חובה. מסכת קריאה כדי לציין אילו שדות יוחזרו בתגובה.

זוהי רשימה מופרדת בפסיקים של שמות שדות שמוגדרים במלואם. דוגמה: "user.displayName,photo"

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

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

אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "location": {
    object (Location)
  },
  "diffMask": string,
  "pendingMask": string
}
שדות
location

object (Location)

הגרסה המעודכנת של Google למיקום הזה.
diffMask

string (FieldMask format)

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

זוהי רשימה מופרדת בפסיקים של שמות שדות שמוגדרים במלואם. דוגמה: "user.displayName,photo"
pendingMask

string (FieldMask format)

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

זוהי רשימה מופרדת בפסיקים של שמות שדות שמוגדרים במלואם. דוגמה: "user.displayName,photo"

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/business.manage

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.