REST Resource: accounts.locations

משאב: מיקום

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

ייצוג JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
שדות
name

string

מזהה Google של המיקום הזה בטופס: accounts/{accountId}/locations/{locationId}

בהקשר של התאמות, השדה הזה לא יאוכלס.
languageCode

string

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

string

מזהה חיצוני של המיקום הזה, והוא חייב להיות ייחודי בתוך חשבון נתון. זהו אמצעי לשיוך המיקום לרשומות שלך.
locationName

string

שם המיקום צריך לשקף את השם של העסק בעולם האמיתי, כפי שהוא מוצג בעקביות בחזית החנות, באתר ובנייר המכתבים של העסק וכפי שהלקוחות מכירים אותו. מידע נוסף רלוונטי אם הוא רלוונטי, ניתן לכלול בשדות אחרים של המשאב (לדוגמה, Address, Categories). אין להוסיף מידע מיותר לשם (לדוגמה, להעדיף "Google" על פני "Google Inc. - Mountain View Corporate Headquarters"). אין לכלול תיאורים שיווקיים, קודי חנויות, תווים מיוחדים, שעות פעילות או סטטוס סגור/פתוח, מספרי טלפון, כתובות אתרים, פרטי שירות/מוצר, מיקום/כתובת או מסלול הגעה, או מידע על מקום סגור (לדוגמה, "Chase ATM ב-Duane Reade").
primaryPhone

string

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

string

עד שני מספרי טלפון (ניידים או קוויים, לא פקס) שבאמצעותם ניתן להתקשר לעסק, בנוסף למספר הטלפון הראשי.
address

object (PostalAddress)

כתובת מדויקת לתיאור מיקום העסק. תאי דואר או תיבות דואר הממוקמים במיקומים מרוחקים אינם קבילים. בשלב זה ניתן לציין עד חמישה ערכי addressLines בכתובת.
primaryCategory

object (Category)

קטגוריה שמתארת בצורה הטובה ביותר את העסק העיקרי שבו המיקום הזה עוסק.
additionalCategories[]

object (Category)

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

string

כתובת URL של העסק הזה. במידת האפשר, יש להשתמש בכתובת URL שמייצגת את המיקום הספציפי של העסק, ולא כתובת אתר או כתובת URL כללית שמייצגים את כל המיקומים, או את המותג.
regularHours

object (BusinessHours)

שעות הפעילות של העסק.
specialHours

object (SpecialHours)

שעות פתיחה מיוחדות של העסק. הנתונים האלה כוללים בדרך כלל שעות פעילות בחגים ובשעות אחרות מחוץ לשעות הפעילות הרגילות. השעות האלה מבטלות את שעות הפעילות הרגילות.
serviceArea

object (ServiceAreaBusiness)

עסקים בעלי אזור שירות מספקים את השירות באתר של הלקוח. אם העסק מספק שירות באזור מוגדר(SAB), השדה הזה מתאר את האזורים שבהם העסק מספק שירות.
locationKey

object (LocationKey)

אוסף של מפתחות שמקשרים את העסק הזה לנכסי Google אחרים, כגון דף Google+ ו'מקומות Google' במפות Google.
labels[]

string

אוסף של מחרוזות בפורמט חופשי שמאפשרות לכם לתייג את העסק. התוויות האלה לא מוצגות למשתמש, אלא רק לכם. מוגבל ל-255 תווים (לכל תווית).
adWordsLocationExtensions

object (AdWordsLocationExtensions)

מידע נוסף שמוצג ב-AdWords.
latlng

object (LatLng)

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

object (OpenInfo)

דגל שמציין אם המיקום פתוח כרגע לעסקים.
locationState

object (LocationState)

פלט בלבד. קבוצה של בוליאנים שמשקפים את המצב של מיקום מסוים.
attributes[]

object (Attribute)

מאפיינים למיקום הזה.
metadata

object (Metadata)

פלט בלבד. מידע נוסף שלא ניתן לעריכה על ידי המשתמש.
priceLists[]
(deprecated)

object (PriceList)

הוצא משימוש: פרטי המחירון למיקום הזה.
profile

object (Profile)

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

object (RelationshipData)

כל המיקומים והרשתות שקשורים למיקום הזה.
moreHours[]

object (MoreHours)

שעות פעילות נוספות עבור מחלקות שונות של העסק או לקוחות ספציפיים.

BusinessHours

מייצג את תקופות הזמן שבהן המיקום הזה פתוח ופעיל. מכיל אוסף של TimePeriod מופעים.

ייצוג JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
שדות
periods[]

object (TimePeriod)

סיכום של השעות שבהן המיקום הזה פתוח. כל תקופה מייצגת טווח של שעות שבהן המיקום פתוח במהלך השבוע.

TimePeriod

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

ייצוג JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": string,
  "closeDay": enum (DayOfWeek),
  "closeTime": string
}
שדות
openDay

enum (DayOfWeek)

הערך הזה מציין את ה-day of the week שבו התקופה הזאת מתחילה.
openTime

string

זמן בפורמט מורחב לפי תקן ISO 8601 (hh:mm). הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין.
closeDay

enum (DayOfWeek)

מציין את day of the week שבו תקופת הזמן הזו מסתיימת.
closeTime

string

זמן בפורמט מורחב לפי תקן ISO 8601 (hh:mm). הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין.

DayOfWeek

מייצג את היום בשבוע.

טיפוסים בני מנייה (enums)
DAY_OF_WEEK_UNSPECIFIED היום בשבוע לא צוין.
MONDAY יום שני
TUESDAY שלישי
WEDNESDAY רביעי
THURSDAY יום חמישי
FRIDAY שישי
SATURDAY שבת
SUNDAY ראשון

SpecialHours

קבוצת תקופות זמן שבהן שעות הפעילות של מיקום שונות משעות הפעילות הרגילות שלו.

ייצוג JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
שדות
specialHourPeriods[]

object (SpecialHourPeriod)

רשימת חריגים משעות הפעילות הרגילות של העסק.

SpecialHourPeriod

תקופת זמן יחידה, שבה שעות הפעילות של מיקום שונות משעות הפעילות הרגילות שלו. פרק זמן של שעות פתיחה מיוחדות צריך לייצג טווח של פחות מ-24 שעות. הערכים openTime ו-startDate חייבים לחול לפני closeTime ו-endDate. closeTime ו-endDate יכולים להימשך עד 11:59 ביום שאחרי startDate שצוין. לדוגמה, הערכים הבאים תקינים:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

פריטי הקלט הבאים אינם חוקיים:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
ייצוג JSON 
{
  "startDate": {
    object (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
שדות
startDate

object (Date)

התאריך הקלנדרי שבו מתחילה תקופת הזמן המיוחדת הזו.
openTime

string

השעה על הקיר ב-startDate כשנפתח מיקום, מבוטאת בפורמט ISO 8601 מורחב של 24 שעות. (hh:mm) הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין. יש לציין אם isClosed מוגדר כ-False.
endDate

object (Date)

התאריך הקלנדרי שבו תקופת הזמן המיוחדת הזו מסתיימת. אם השדה endDate לא מוגדר, ברירת המחדל היא התאריך שצוין ב-startDate. אם השדה הזה מוגדר, השדה הזה צריך להיות שווה ליום אחד לכל היותר אחרי התאריך startDate.
closeTime

string

השעה על הקיר ב-endDate כשמיקום נסגר, מבוטאת ב-24 שעות בפורמט ISO 8601 מורחב. (hh:mm) הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין. יש לציין אם isClosed מוגדר כ-False.
isClosed

boolean

אם הערך הוא True, המערכת תתעלם מ-endDate, מ-openTime ומ-closeTime, והתאריך שצוין ב-startDate ייחשב כמיקום שנסגר למשך כל היום.

ServiceAreaBusiness

עסקים באזור שירות מספקים את השירות במיקום של הלקוח (לדוגמה, מנעולנים או שרברבים).

ייצוג JSON 
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
שדות
businessType

enum (BusinessType)

מציין את type של העסק באזור השירות.
שדה איחוד coverageArea. מציין את אזור הכיסוי שבו העסק מציע שירות. הערך של coverageArea יכול להיות רק אחת מהאפשרויות הבאות:
radius

object (PointRadius)

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

object (Places)

האזור שהעסק הזה מספק שירות מוגדר דרך קבוצת מקומות.

BusinessType

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

טיפוסים בני מנייה (enums)
BUSINESS_TYPE_UNSPECIFIED פלט בלבד. לא צוין.
CUSTOMER_LOCATION_ONLY העסק מספק שירות רק באזור עצמו (ולא בכתובת העסק).
CUSTOMER_AND_BUSINESS_LOCATION מספק שירות בכתובת העסק ובאזור שמסביב.

PointRadius

רדיוס סביב נקודה מסוימת (קו רוחב/אורך).

ייצוג JSON 
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
שדות
latlng

object (LatLng)

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

number

המרחק בקילומטרים של האזור שמסביב לנקודה.

LatLng

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

ייצוג JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב במעלות. הערך חייב להיות בטווח של [ -90.0, +90.0].
longitude

number

קו האורך במעלות. הוא צריך להיות בטווח של [ -180.0, +180.0].

מקומות

איחוד של אזורים שמיוצגים על ידי קבוצת מקומות.

ייצוג JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
שדות
placeInfos[]

object (PlaceInfo)

האזורים שמיוצגים על ידי מזהי מקומות. יש הגבלה ל-20 מקומות לכל היותר.

PlaceInfo

מגדיר אזור שמיוצג על ידי מזהה מקום.

ייצוג JSON 
{
  "name": string,
  "placeId": string
}
שדות
name

string

השם המותאם לשוק המקומי של המקום. לדוגמה, Scottsdale, AZ.
placeId

string

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

LocationKey

החלפה/החלפה של הפניות למפתח עבור מיקום מסוים.

ייצוג JSON 
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
שדות
plusPageId

string

פלט בלבד. אם למיקום הזה משויך דף Google+, הוא יאוכלס במזהה דף Google+ של המיקום הזה.
placeId

string

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

אם המיקום הזה לא מאומת, ייתכן שהשדה הזה יאוכלס אם המיקום משויך למקום שמופיע במפות Google.

אפשר להגדיר את השדה הזה רק בשיחות 'יצירה', אבל לא ב'עדכון'.

הערך הבוליאני הנוסף של explicitNoPlaceId מציין אם מזהה מקום לא מוגדר מכוון או לא.
explicitNoPlaceId

boolean

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

string

פלט בלבד. המכשיר requestId שימש ליצירת המיקום הזה. השדה הזה יכול להיות ריק אם המיקום הזה נוצר מחוץ ל-Google My Business API או למיקומים של פרופיל העסק.

AdWordsLocationExtensions

מידע נוסף שמוצג ב-AdWords.

ייצוג JSON 
{
  "adPhone": string
}
שדות
adPhone

string

מספר טלפון חלופי שיוצג בתוספי המיקום של AdWords במקום מספר הטלפון הראשי של המיקום.

OpenInfo

מידע שקשור למצב הפתיחה של העסק.

ייצוג JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
שדות
status

enum (OpenForBusiness)

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

boolean

פלט בלבד. הערך הזה מציין אם העסק עומד בדרישות לפתיחה מחדש.
openingDate

object (Date)

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

OpenForBusiness

מציין את הסטטוס של מיקום.

טיפוסים בני מנייה (enums)
OPEN_FOR_BUSINESS_UNSPECIFIED לא צוין.
OPEN מציין שהמיקום פתוח.
CLOSED_PERMANENTLY מציין שהמיקום נסגר לצמיתות.
CLOSED_TEMPORARILY מציין שהמיקום נסגר זמנית. ניתן להחיל את הערך הזה רק על מיקומים שפורסמו (למשל locationState.is_published = true). כשמעדכנים את הערך בשדה הסטטוס, הלקוחות נדרשים להגדיר את updateMask באופן מפורש ל-openInfo.status. לא ניתן להגדיר מסכות עדכון נוספות במהלך שיחת העדכון הזו. זוהי הגבלה זמנית שתושק בקרוב.

LocationState

מכיל קבוצה של ערכים בוליאניים שמשקפים את המצב של מיקום.

ייצוג JSON 
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
שדות
isGoogleUpdated

boolean

פלט בלבד. מציין אם יש עדכונים במזהה המקום המשויך למיקום הזה.
isDuplicate

boolean

פלט בלבד. ערך זה מציין אם המיקום הוא כפילות של מיקום אחר.
isSuspended

boolean

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

boolean

פלט בלבד. שדה זה מציין אם ניתן לעדכן את המיקום.
canDelete

boolean

פלט בלבד. מציין אם ניתן למחוק את המיקום באמצעות ה-API של 'Google לעסק שלי'.
isVerified

boolean

פלט בלבד. שדה זה מציין אם המיקום מאומת.
needsReverification

boolean

פלט בלבד. שדה זה מציין אם המיקום דורש אימות מחדש.
isPendingReview

boolean

פלט בלבד. שדה זה מציין אם בדיקת המיקום בהמתנה.
isDisabled

boolean

פלט בלבד. מציין אם המיקום מושבת.
isPublished

boolean

פלט בלבד. שדה זה מציין אם המיקום פורסם.
isDisconnected

boolean

פלט בלבד. מציין אם המיקום מנותק ממקום כלשהו במפות Google.
isLocalPostApiDisabled

boolean

פלט בלבד. ההערה מציינת אם accounts.locations.localPosts מושבת במיקום הזה.
canModifyServiceList

boolean

פלט בלבד. הערך מציין אם הרישום יכול לשנות רשימת ServiceList.
canHaveFoodMenus

boolean

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

boolean

פלט בלבד. מציין אם נכסים של מיקום זה נמצאים במצב המתנה לעריכה.
hasPendingVerification

boolean

פלט בלבד. שדה זה מציין אם יש למיקום בקשות אימות בהמתנה.
canOperateHealthData

boolean

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

boolean

פלט בלבד. שדה זה מציין אם המיקום יכול לפעול בנתוני לינה.

מאפיין

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

ייצוג JSON 
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
שדות
attributeId

string

מזהה המאפיין. Google מספקת את מזהי המאפיינים.
valueType

enum (AttributeValueType)

פלט בלבד. סוג הערך שהמאפיין הזה מכיל. לפי הצורך, צריך לקבוע איך לפרש את הערך.
values[]

value (Value format)

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

object (RepeatedEnumAttributeValue)

כאשר הסוג של ערך המאפיין הוא REPEATED_ENUM, הוא מכיל את ערך המאפיין ושדות הערכים האחרים חייבים להיות ריקים.
urlValues[]

object (UrlAttributeValue)

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

RepeatedEnumAttributeValue

ערכים למאפיין עם valueType של REPEATED_ENUM. הרכיב הזה כולל שתי רשימות של מזהי ערכים: המזהים עם הערך (true) והמזהים שלא הוגדרו (false). אם חסרים ערכים, הם נחשבים לא ידועים. יש לציין לפחות ערך אחד.

ייצוג JSON 
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
שדות
setValues[]

string

ערכי טיפוס שהוגדרו.
unsetValues[]

string

ערכי Enum שלא הוגדרו.

UrlAttributeValue

ערכים של מאפיין עם כתובת URL שמסתיימת ב-valueType.

ייצוג JSON 
{
  "url": string
}
שדות
url

string

כתובת ה-URL.

Metadata

מידע נוסף על המיקום שלא ניתן לעריכה על ידי המשתמש.

ייצוג JSON 
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
שדות
duplicate
(deprecated)

object (Duplicate)

מידע על המיקום שמיקום זה משוכפל. מוצג רק אם הערך locationState.is_duplicate נכון. הוצא משימוש: אנחנו לא תומכים יותר במידע מפורט לגבי כפילויות.
mapsUrl

string

קישור למיקום במפות Google.
newReviewUrl

string

קישור לדף בחיפוש Google שבו לקוח יכול לכתוב ביקורת על המיקום.

שכפול

מידע על המיקום שמיקום זה משוכפל.

ייצוג JSON 
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
שדות
locationName

string

שם המשאב של המיקום שהערך שלו הוא כפילות. השדה הזה יאוכלס רק אם למשתמש המאומת יש הרשאות גישה למיקום הזה והמיקום הזה לא נמחק.
placeId

string

מזהה המקום של המיקום שהפריט הזה משוכפל.
access

enum (Access)

מציין אם למשתמש יש גישה למיקום שאותו הוא משכפל.

גישה

רמת הגישה של המשתמש למיקום שהוא משוכפל. אפשרות זו מחליפה 'בעלות' ויש להשתמש בה במקומה.

טיפוסים בני מנייה (enums)
ACCESS_UNSPECIFIED לא צוין.
ACCESS_UNKNOWN לא ניתן לקבוע אם למשתמש יש גישה למיקום שהוא משוכפל.
ALLOWED למשתמש יש גישה למיקום שהוא משוכפל.
INSUFFICIENT למשתמש אין גישה למיקום שהוא משוכפל.

PriceList

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

ייצוג JSON 
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
שדות
priceListId

string

חובה. המזהה של רשימת המחירים. לא ניתן לשכפל במיקום הזה מזהי מחירים, מקטעים ופריטים.
labels[]

object (Label)

חובה. תוויות עם תיוג שפה של מחירון.
sourceUrl

string

כתובת ה-URL האופציונלית של המקור שממנו אוחזר מחיר המחירון. לדוגמה, זאת יכולה להיות כתובת ה-URL של הדף שצורף באופן אוטומטי כדי לאכלס את פרטי התפריט.
sections[]

object (Section)

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

תווית

תווית שתשמש להצגת המחירון, החלק או הפריט.

ייצוג JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
שדות
displayName

string

חובה. השם המוצג של המחירון, החלק או הפריט.
description

string

אפשרות. תיאור של המחירון, החלק או הפריט.
languageCode

string

אפשרות. קוד השפה BCP-47 שעליו חלות המחרוזות האלה. ניתן להגדיר קבוצה אחת בלבד של תוויות לכל שפה.

קטע

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

ייצוג JSON 
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
שדות
sectionId

string

חובה. המזהה של הקטע. לא ניתן לשכפל במיקום הזה מזהי מחירים, מקטעים ופריטים.
labels[]

object (Label)

חובה. תוויות עם תיוג שפה בקטע הזה. מומלץ שהשמות והתיאורים של הקטעים יהיו באורך של עד 140 תווים. יש צורך בקבוצה אחת לפחות של תוויות.
sectionType

enum (SectionType)

אפשרות. סוג הקטע של המחירון הנוכחי. ערך ברירת המחדל הוא FOOD.
items[]

object (Item)

פריטים שכלולים בקטע הזה ברשימת המחירים.

SectionType

סוג הקטע.

טיפוסים בני מנייה (enums)
SECTION_TYPE_UNSPECIFIED לא צוין.
FOOD הקטע מכיל פריטים שמייצגים אוכל.
SERVICES הקטע מכיל פריטים שמייצגים שירותים.

פריט

פריט אחד ברשימה. לכל וריאציה של פריט ברשימת המחירים צריך להיות פריט משלה עם נתוני מחיר משלה.

ייצוג JSON 
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
שדות
itemId

string

חובה. המזהה של הפריט. לא ניתן לשכפל במיקום הזה מזהי מחירים, מקטעים ופריטים.
labels[]

object (Label)

חובה. תוויות של תיוג שפה של הפריט. מומלץ ששמות הפריטים יהיו באורך 140 תווים לכל היותר, ותיאורים באורך של 250 תווים לכל היותר. יש צורך בקבוצה אחת לפחות של תוויות.
price

object (Money)

אפשרות. מחיר הפריט.

כסף

מייצג סכום כסף לפי סוג המטבע.

ייצוג JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
שדות
currencyCode

string

קוד המטבע בן שלוש אותיות כפי שמוגדר בתקן ISO 4217.
units

string (int64 format)

מספר היחידות השלמות של הסכום. לדוגמה, אם הערך של currencyCode הוא "USD", המשמעות היא ש-1 יחידה = דולר ארה"ב אחד.
nanos

integer

מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ו+999,999,999, כולל. אם הערך של units הוא חיובי, nanos חייב להיות חיובי או אפס. אם הערך של units הוא אפס, הערך של nanos יכול להיות חיובי, אפס או שלילי. אם הערך של units הוא שלילי, הערך של nanos חייב להיות שלילי או אפס. לדוגמה, הסכום $-1.75 מיוצג כך: units=-1 וגם nanos=-750,000,000.

פרופיל

כל המידע שקשור לפרופיל של המיקום.

ייצוג JSON 
{
  "description": string
}
שדות
description

string

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

RelationshipData

מידע על כל המיקומים של הורה וילדים שקשורים למיקום הזה.

ייצוג JSON 
{
  "parentChain": string
}
שדות
parentChain

string

שם המשאב של הרשת שהמיקום הזה משויך אליה. How to find Chain ID

MoreHours

תקופות הזמן שבהן מיקום פתוח עבור סוגים מסוימים של עסקים.

ייצוג JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
שדות
hoursTypeId

string

חובה. סוג השעות. על הלקוחות להתקשר אל {#link businessCategory:BatchGet} כדי לקבל סוגים נתמכים של שעות פעילות בקטגוריות של המיקומים שלהם.
periods[]

object (TimePeriod)

חובה. אוסף של השעות שבהן המיקום הזה פתוח. כל תקופה מייצגת טווח של שעות שבהן המיקום פתוח במהלך השבוע.

שיטות

associate

 משייך מיקום למזהה של מקום.

batchGet

 הפונקציה מקבלת את כל המיקומים שצוינו בחשבון הנתון.

batchGetReviews

 מחזירה רשימה מעומדת של ביקורות לכל המיקומים שצוינו.

clearAssociation

 ביטול השיוך בין מיקום למזהה המקום שלו.

create

 הפונקציה יוצרת location חדש בבעלות החשבון שצוין ומחזירה אותו.

delete

 מוחק מיקום.

fetchVerificationOptions

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

findMatches

 הפונקציה מחפשת את כל המיקומים האפשריים שתואמים למיקום שצוין.

get

 הפונקציה מקבלת את המיקום שצוין.

getFoodMenus

 פונקציה זו מחזירה את תפריטי האוכל של מיקום מסוים.

getGoogleUpdated

 קבלת הגרסה המעודכנת של Google של המיקום שצוין.

getHealthProviderAttributes

 הפונקציה מחזירה את המאפיינים של ספק שירותי הבריאות של מיקום ספציפי.

getServiceList

 קבלת רשימת השירותים שצוינה למיקום מסוים.

list

 רשימת המיקומים של החשבון שצוין.

patch

 מעדכן את המיקום שצוין.

reportInsights

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

transfer
(deprecated)

 מעביר מיקום מחשבון שבבעלות המשתמש לחשבון אחר שאותו המשתמש מנהל.

updateFoodMenus

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

updateHealthProviderAttributes

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

updateServiceList

 עדכון רשימת השירותים שצוינה עבור מיקום מסוים.

verify

 התחלת תהליך האימות של מיקום.