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

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

PostalAddress

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

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

עצות להזנה או לעריכה של כתובת:

  • משתמשים בווידג'ט של כתובת שמותאם ללוקליזציה, כמו https://github.com/google/libaddressinput.
  • אסור להציג למשתמשים רכיבים בממשק המשתמש להזנה או לעריכה של שדות מחוץ למדינות שבהן השדה הזה נמצא בשימוש.

הנחיות נוספות לשימוש בסכימה הזו זמינות בכתובת: https://support.google.com/business/answer/6397478.

ייצוג ב-JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
שדות
revision

integer

גרסת הסכימה של PostalAddress. צריך להגדיר את הערך 0, שהוא הגרסה האחרונה.

כל הגרסאות החדשות חייבות להיות תואמות לדורות קודמים של גרסאות ישנות.
regionCode

string

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

string

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

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

דוגמאות: "zh-Hant",‏ "ja",‏ "ja-Latn",‏ "en".
postalCode

string

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

string

אופציונלי. קוד לזיהוי הבנק נוסף, ספציפי למדינה. האפשרות הזו לא זמינה ברוב האזורים. במדינות שבהן משתמשים בערך הזה, הוא יכול להיות מחרוזת כמו "CEDEX", לפעמים עם מספר (לדוגמה, "CEDEX 7"), או רק מספר שמייצג את "קוד המגזר" (ג'מייקה), "מזהה אזור המשלוח " (מלאווי) או"מזהה סניף הדואר" (חוף השנהב).
administrativeArea

string

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

string

אופציונלי. בדרך כלל מתייחס לחלק של העיר או היישוב בכתובת. דוגמאות: עיר בארה"ב, קומונה באיטליה, עיר למשלוח דואר בבריטניה. באזורים בעולם שבהם היישובים לא מוגדרים היטב או לא מתאימים למבנה הזה, צריך להשאיר את locality ריק ולהשתמש ב-addressLines.
sublocality

string

אופציונלי. השכונה של הכתובת. לדוגמה, שכונה, רובע או מחוז.
addressLines[]

string

שורות כתובת לא מובנות שמתארות את הרמות הנמוכות יותר של הכתובת.

מכיוון שהערכים ב-addressLines לא מכילים מידע על סוג הנתונים, ולפעמים יכולים להכיל כמה ערכים בשדה אחד (לדוגמה, "Austin, TX"), חשוב שסדר השורות יהיה ברור. סדר שורות הכתובת צריך להיות "סדר מעטפה" בהתאם למדינה או לאזור של הכתובת. במקומות שבהם זה יכול להשתנות (לדוגמה, ביפן), משתמשים ב-address_language כדי לציין את זה במפורש (לדוגמה, "ja" לסדר מהגדול לקטן ו-"ja-Latn" או "en" לסדר מהקטן לגדול). כך אפשר לבחור את שורת הכתובת הספציפית ביותר בהתאם לשפה.

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

הדרך המומלצת לטפל בכתובות לא מובנות לחלוטין היא ליצור כתובת שמכילה רק regionCode ו-addressLines, ואז להמיר אותה לקואורדינטות (במקום לנחש אילו חלקים בכתובת צריכים להיות יישובים או אזורים מנהליים).
recipients[]

string

אופציונלי. הנמען בכתובת. בנסיבות מסוימות, השדה הזה יכול להכיל מידע בכמה שורות. לדוגמה, היא יכולה להכיל מידע על "באמצעות".
organization

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.

DayOfWeek

מייצג יום בשבוע.

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

TimeOfDay

מייצג שעה ביום. התאריך ואזור הזמן לא משמעותיים או שהם מצוינים במקום אחר. ב-API מסוים יכולה להיות אפשרות להשתמש בדקות מעוברות. הסוגים הקשורים הם google.type.Date ו-google.protobuf.Timestamp.

ייצוג ב-JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
שדות
hours

integer

שעות ביום בפורמט של 24 שעות. הערך חייב להיות גדול מ-0 או שווה לו, ובדרך כלל קטן מ-23 או שווה לו. ב-API אפשר לאפשר את הערך "24:00:00" בתרחישים כמו שעת סגירה של עסק.
minutes

integer

דקות בשעה. הערך חייב להיות גדול מ-0 או שווה לו, וקטן מ-59 או שווה לו.
seconds

integer

שניות בדקה. הערך חייב להיות גדול מ-0 או שווה לו, ובדרך כלל קטן מ-59 או שווה לו. אם ה-API מאפשר דקות מעוברות, יכול להיות שהוא יאפשר את הערך 60.
nanos

integer

שברירי שניות, בננו-שניות. הערך חייב להיות גדול מ-0 או שווה לו, וקטן מ-999,999,999 או שווה לו.

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 נחשב ליום שבו המיקום סגור במשך כל היום.

תאריך

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

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

סוגים קשורים:

ייצוג ב-JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. הערך חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך בלי שנה.
month

integer

חודש בשנה. הערך חייב להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

יום בחודש. הערך חייב להיות בין 1 ל-31, ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם היום לא משמעותי.

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 במקום מספר הטלפון הראשי של המיקום.

LatLng

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

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

number

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

number

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

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 של categories.batchGet.
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 שהמחרוזות האלה חלות עליו. אפשר להגדיר רק קבוצה אחת של תוויות לכל שפה.

כסף

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

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

string

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

string (int64 format)

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

integer

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

Methods

create

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

list

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