REST Resource: accounts.locations

משאב: מיקום

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

ייצוג ב-JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
שדות
name

string

מזהה. המזהה של Google למיקום הזה בפורמט: locations/{locationId}.
languageCode

string

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

string

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

string

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

object (PhoneNumbers)

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

object (Categories)

אופציונלי. הקטגוריות השונות שמתארות את העסק.
storefrontAddress

object (PostalAddress)

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

string

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

object (BusinessHours)

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

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

string

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

object (AdWordsLocationExtensions)

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

object (LatLng)

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

object (OpenInfo)

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

object (Metadata)

פלט בלבד. מידע נוסף שהמשתמש לא יכול לערוך.
profile

object (Profile)

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

השדה הזה נדרש בכל הקטגוריות, חוץ מקטגוריות של מקומות לינה (למשל, מלונות, מוטלים, פונדקים).
relationshipData

object (RelationshipData)

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

object (MoreHours)

אופציונלי. שעות פעילות נוספות למחלקות שונות בעסק או ללקוחות ספציפיים.
serviceItems[]

object (ServiceItem)

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

PhoneNumbers

אוסף של מספרי הטלפון של העסק. במהלך עדכונים, צריך להגדיר את שני השדות. לקוחות לא יכולים לעדכן רק את מספרי הטלפון הראשיים או הנוספים באמצעות מסכת העדכון. מומלץ להשתמש בפורמט בינלאומי של מספרי טלפון, כמו "‎+1 415 555 0132". מידע נוסף זמין בכתובת (https://developers.google.com/style/phone-numbers#international-phone-numbers).

ייצוג ב-JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
שדות
primaryPhone

string

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

string

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

קטגוריות

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

ייצוג ב-JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
שדות
primaryCategory

object (Category)

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

object (Category)

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

קטגוריה

קטגוריה שמתארת את העסק (ולא את מה שהוא עושה). רשימה של מזהי קטגוריות חוקיים והמיפויים שלהם לשמות שקריאים לאנשים זמינה בכתובת categories.list.

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
שדות
name

string

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

string

פלט בלבד. השם של הקטגוריה, בפורמט שקריא לבני אדם. הערך הזה מוגדר כשקוראים את המיקום. כשמשנים את המיקום, צריך להגדיר את category_id.
serviceTypes[]

object (ServiceType)

פלט בלבד. רשימה של כל סוגי השירותים שזמינים לקטגוריה הזו של העסק.
moreHoursTypes[]

object (MoreHoursType)

פלט בלבד. סוגים נוספים של שעות שזמינים לקטגוריה הזו של העסק.

ServiceType

הודעה שמתארת את סוג השירות שהעסק מציע.

ייצוג ב-JSON 
{
  "serviceTypeId": string,
  "displayName": string
}
שדות
serviceTypeId

string

פלט בלבד. מזהה יציב (שמסופק על ידי Google) לסוג השירות הזה.
displayName

string

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

MoreHoursType

סוגים של שעות פעילות נוספות שעסק יכול להציע, בנוסף לשעות הפעילות הרגילות שלו.

ייצוג ב-JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
שדות
hoursTypeId

string

פלט בלבד. מזהה קבוע ש-Google מספקת לסוג השעות הזה.
displayName

string

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

string

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

BusinessHours

מייצג את פרקי הזמן שבהם המיקום הזה פתוח לעסקים. מכיל אוסף של מופעי [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

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

object (TimePeriod)

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

TimePeriod

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

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

enum (DayOfWeek)

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

object (TimeOfDay)

חובה. הערכים התקינים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף היום שצוין בשדה. הערה: במיפוי JSON של Proto3, ערכי ברירת המחדל של אפס (00:00) מושמטים, ונוצר הערך {} עבור openTime.
closeDay

enum (DayOfWeek)

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

object (TimeOfDay)

חובה. הערכים התקינים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף היום שצוין בשדה. הערה: במיפוי JSON של Proto3, ערכי ברירת המחדל של אפס (00:00) מושמטים, ונוצר {} עבור closeTime.

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": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
שדות
startDate

object (Date)

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

object (TimeOfDay)

אופציונלי. הערכים התקינים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף השדה של היום שצוין. חובה לציין ערך אם הערך של closed הוא False.
endDate

object (Date)

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

object (TimeOfDay)

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

boolean

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

ServiceAreaBusiness

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

ייצוג ב-JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
שדות
businessType

enum (BusinessType)

חובה. מציין את [סוג] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] העסק שנותן שירות באזור מוגדר (SAB).
places

object (Places)

אופציונלי. האזור שבו העסק הזה מספק שירות, שמוגדר באמצעות קבוצה של מקומות.
regionCode

string

לא ניתן לשינוי. קוד האזור/המדינה של המיקום שבו נמצא העסק שנותן שירות באזור מוגדר, לפי מאגר CLDR. פרטים נוספים זמינים בכתובות http://cldr.unicode.org/ ו-http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. לדוגמה: "CH" לשווייץ.

השדה הזה נדרש לעסקים שמוגדרים כ-CUSTOMER_LOCATION_ONLY, והמערכת מתעלמת ממנו במקרים אחרים.

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

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

BusinessType

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

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

מקומות

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

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

object (PlaceInfo)

אופציונלי. האזורים שמיוצגים על ידי מזהי המקומות. אפשר להוסיף עד 20 מקומות.

PlaceInfo

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

ייצוג ב-JSON 
{
  "placeName": string,
  "placeId": string
}
שדות
placeName

string

חובה. השם המקומי של המקום. לדוגמה, Scottsdale, AZ.
placeId

string

חובה. המזהה של המקום. חייב להתאים לאזור. (https://developers.google.com/places/web-service/supported_types#table3)

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

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

טיפוסים בני מנייה (enum)
OPEN_FOR_BUSINESS_UNSPECIFIED לא צוין.
OPEN מציין שהמיקום פתוח.
CLOSED_PERMANENTLY מציין שהמיקום נסגר לצמיתות.
CLOSED_TEMPORARILY מציין שהמיקום סגור זמנית.

מטא-נתונים

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

ייצוג ב-JSON 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
שדות
hasGoogleUpdated

boolean

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

boolean

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

boolean

פלט בלבד. מציין אם אפשר למחוק את המיקום באמצעות ה-API.
canOperateLocalPost
(deprecated)

boolean

פלט בלבד. הוצא משימוש: השדה הזה לא מאוכלס יותר ויוסר בגרסה עתידית.
canModifyServiceList

boolean

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

boolean

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

boolean

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

boolean

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

string

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

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

string

פלט בלבד. משאב המיקום שהמיקום הזה משכפל.
mapsUri

string

פלט בלבד. קישור למיקום במפות Google.
newReviewUri

string

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

boolean

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

boolean

פלט בלבד. השדה מציין אם בדף העסק יש את התכונה "חוות דעת על העסק". אם הערך הבוליאני הזה הוא False, צריך להפעיל את ה-API‏ locations.getVoiceOfMerchantState כדי לקבל פרטים על הסיבה לכך שאין להם את Voice of Merchant.
isParticularlyPersonalPlace

boolean

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

פרופיל

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

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

string

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

RelationshipData

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

ייצוג ב-JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
שדות
parentLocation

object (RelevantLocation)

אופציונלי. המיקום הראשי שהמיקום הזה קשור אליו.
childrenLocations[]

object (RelevantLocation)

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

string

אופציונלי. שם המשאב של הרשת שהמיקום הזה שייך אליה. [How to find Chain ID] [Locations.SearchChains]

RelevantLocation

מידע על מיקום אחר שקשור למיקום הנוכחי. הקשר יכול להיות DEPARTMENT_OF או INDEPENDENT_ESTABLISHMENT_OF, והמיקום שצוין כאן יכול להיות בכל אחד מהצדדים (הורה/צאצא) של המיקום.

ייצוג ב-JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
שדות
placeId

string

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

enum (RelationType)

חובה. סוג הקשר.

RelationType

סוגי הקשרים שצריך לציין.

טיפוסים בני מנייה (enum)
RELATION_TYPE_UNSPECIFIED לא צוין סוג.
DEPARTMENT_OF הקשר הזה מייצג יחס בין 2 מיקומים שחולקים אזור פיזי אחד, אותו מותג/הנהלה בכירה/ארגון, אבל עם מאפיינים מרכזיים שונים כמו שעות הפעילות של החנות או מספרי טלפון. לדוגמה, בית המרקחת של Costco הוא מחלקה ב-Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN האפשרות הזו מייצגת מקרים שבהם 2 מיקומים נמצאים באותו מיקום פיזי, אבל שייכים לחברות שונות (למשל, סניף של ארומה בתוך סופרמרקט, חנויות בקניון).

MoreHours

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

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

string

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

object (TimePeriod)

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

ServiceItem

הודעה שמתארת פריט שירות אחד. הוא משמש לתיאור סוג השירות שהמוכר מספק. לדוגמה, תספורת יכולה להיות שירות.

ייצוג ב-JSON 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
שדות
price

object (Money)

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

object (StructuredServiceItem)

אופציונלי. השדה הזה יוגדר במקרה של נתוני שירותים מובְנים.
freeFormServiceItem

object (FreeFormServiceItem)

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

StructuredServiceItem

מייצג שירות מובנה שהמוכר מציע. לדוגמה: toilet_installation.

ייצוג ב-JSON 
{
  "serviceTypeId": string,
  "description": string
}
שדות
serviceTypeId

string

חובה. השדה serviceTypeId הוא מזהה ייחודי ש-Google מספקת, ואפשר למצוא אותו ב-ServiceType. המידע הזה מסופק על ידי שירות RPC של BatchGetCategories.
description

string

אופציונלי. תיאור של פריט שירות מובנה. מגבלת התווים היא 300.

FreeFormServiceItem

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

ייצוג ב-JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
שדות
category

string

חובה. השדה הזה מייצג את שם הקטגוריה (כלומר, המזהה הקבוע של הקטגוריה). הערכים של category ו-serviceTypeId צריכים להתאים לשילובים האפשריים שצוינו בהודעה Category.
label

object (Label)

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

תווית

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

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

string

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

string

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

string

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

Methods

create

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

list

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