- משאב: מיקום
- ייצוג JSON
- PhoneNumbers
- קטגוריות
- קטגוריה
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod (תקופת זמן)
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- תאריך
- ServiceAreaBusiness
- BusinessType
- מקומות
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- מטא-נתונים
- פרופיל
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- תווית
- Money
- שיטות
משאב: מיקום
מיקום. תיאור מפורט של השדות האלה זמין במאמר במרכז העזרה. כדי לקבל רשימה של קטגוריות עסקיות חוקיות, אפשר לעיין בנקודת הקצה של הקטגוריה.
ייצוג JSON |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
שדות | |
---|---|
name |
מזהה Google של המיקום הזה בטופס: |
languageCode |
לא משתנה. שפת המיקום. מוגדרת במהלך היצירה ולא ניתן לעדכן אותה. |
storeCode |
אפשרות. מזהה חיצוני של המיקום הזה, והוא חייב להיות ייחודי בחשבון נתון. זהו אמצעי לשיוך המיקום לרשומות שלך. |
title |
חובה. שם המיקום צריך לשקף את השם של העסק בעולם האמיתי, כפי שהוא מוצג בעקביות בחזית החנות, באתר ובנייר המכתבים של העסק וכפי שהלקוחות מכירים אותו. מידע נוסף רלוונטי אם הוא רלוונטי, ניתן לכלול בשדות אחרים של המשאב (לדוגמה, |
phoneNumbers |
אפשרות. מספרי הטלפון השונים שבעזרתם לקוחות יכולים ליצור קשר עם העסק. |
categories |
אפשרות. הקטגוריות השונות שמתארות את העסק. |
storefrontAddress |
אפשרות. כתובת מדויקת לתיאור מיקום העסק. תאי דואר או תיבות דואר הממוקמים במיקומים מרוחקים אינם קבילים. בשלב זה ניתן לציין עד חמישה ערכי |
websiteUri |
אפשרות. כתובת URL של העסק הזה. במידת האפשר, יש להשתמש בכתובת URL שמייצגת את המיקום הספציפי של העסק, ולא כתובת אתר או כתובת URL כללית שמייצגים את כל המיקומים, או את המותג. |
regularHours |
אפשרות. שעות הפעילות של העסק. |
specialHours |
אפשרות. שעות פתיחה מיוחדות של העסק. הנתונים האלה כוללים בדרך כלל שעות פעילות בחגים ובשעות אחרות מחוץ לשעות הפעילות הרגילות. השעות האלה מבטלות את שעות הפעילות הרגילות. לא ניתן להגדיר את השדה הזה בלי שעות פעילות רגילות. |
serviceArea |
אפשרות. עסקים בעלי אזור שירות מספקים את השירות באתר של הלקוח. אם העסק מספק שירות באזור מוגדר(SAB), השדה הזה מתאר את האזורים שבהם העסק מספק שירות. |
labels[] |
אפשרות. אוסף של מחרוזות בפורמט חופשי שמאפשרות לכם לתייג את העסק. התוויות האלה לא מוצגות למשתמש, אלא רק לכם. חייב להכיל 1-255 תווים בכל תווית. |
adWordsLocationExtensions |
אפשרות. מידע נוסף שמוצג ב-AdWords. |
latlng |
אפשרות. קווי אורך ורוחב שסיפק המשתמש. כשיוצרים מיקום, המערכת מתעלמת מהשדה הזה אם הכתובת שסיפקתם מסומנת גיאוגרפית בהצלחה. השדה הזה מוחזר רק לבקשות לקבל אם הערך של |
openInfo |
אפשרות. דגל שמציין אם המיקום פתוח כרגע לעסקים. |
metadata |
פלט בלבד. מידע נוסף שלא ניתן לעריכה על ידי המשתמש. |
profile |
אפשרות. התכונה מאפשרת לתאר את העסק בקול שלכם ולשתף עם המשתמשים את הסיפור הייחודי של העסק והדברים שאתם מציעים. השדה הזה נדרש לכל הקטגוריות מלבד קטגוריות של לינה (למשל: מלונות, מוטלים, אכסניות). |
relationshipData |
אפשרות. כל המיקומים והרשתות שקשורים למיקום הזה. |
moreHours[] |
אפשרות. שעות פעילות נוספות עבור מחלקות שונות של העסק או לקוחות ספציפיים. |
serviceItems[] |
אפשרות. רשימת השירותים שהמוכרים תומכים בהם. שירות יכול להיות תספורת, התקנת דוד חימום וכו'. פריטי שירות כפולים יוסרו באופן אוטומטי. |
PhoneNumbers
אוסף של מספרי טלפון של העסק. במהלך העדכונים צריך להגדיר את שני השדות. לקוחות אינם רשאים לעדכן רק את מספרי הטלפון הראשיים או את מספרי הטלפון הנוספים באמצעות מסיכת העדכון. עדיף להשתמש בפורמט הטלפון הבינלאומי, כמו +1 415 555 0132. מידע נוסף זמין בכתובת (https://developers.google.com/style/phone-numbers#international-phone-numbers).
ייצוג JSON |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
שדות | |
---|---|
primaryPhone |
חובה. מספר טלפון שמתחבר למיקום העסק הספציפי שלכם בצורה ישירה ככל האפשר. כשהדבר אפשרי, השתמשו במספר טלפון בעסק, במקום במספר של מוקד טלפוני של מוקד טלפוני. |
additionalPhones[] |
אפשרות. עד שני מספרי טלפון (ניידים או קוויים, לא פקס) שבאמצעותם ניתן להתקשר לעסק, בנוסף למספר הטלפון הראשי. |
קטגוריות
אוסף קטגוריות שמתארות את העסק. במהלך העדכונים צריך להגדיר את שני השדות. ללקוחות אסור לעדכן בנפרד את הקטגוריה הראשית או הנוספת באמצעות מסיכת העדכון.
ייצוג JSON |
---|
{ "primaryCategory": { object ( |
שדות | |
---|---|
primaryCategory |
חובה. קטגוריה שמתארת בצורה הטובה ביותר את העסק העיקרי שבו המיקום הזה עוסק. |
additionalCategories[] |
אפשרות. קטגוריות נוספות שמתארות את העסק שלכם. קטגוריות עוזרות ללקוחות למצוא תוצאות מדויקות וספציפיות לשירותים שהם מעוניינים בהם. כדי שפרטי העסק יהיו מדויקים ועדכניים, הקפידו להשתמש בכמה שפחות קטגוריות לתיאור העסק העיקרי שלכם. בחרו קטגוריות ספציפיות ככל האפשר, אך מייצגות את העסק העיקרי שלכם. |
קטגוריה
קטגוריה שמתארת את מהות העסק הזה (לא את המהות שלו). לקבלת רשימה של מזהי קטגוריות חוקיים ואת המיפויים לשמות הקריאים לאנשים, אפשר לעיין ב-categories.list
.
ייצוג JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
שדות | |
---|---|
name |
חובה. מזהה קבוע (ש-Google מספקת) לקטגוריה הזו. חובה לציין את הערך כשמשנים את הקטגוריה (כשיוצרים או מעדכנים מיקום). |
displayName |
פלט בלבד. שם הקטגוריה, שקריא לבני אדם. הערך מוגדר בזמן קריאת המיקום. כשמשנים את המיקום, צריך להגדיר את |
serviceTypes[] |
פלט בלבד. רשימה של כל סוגי השירותים שזמינים בקטגוריה הזו של העסק. |
moreHoursTypes[] |
פלט בלבד. סוגים נוספים של שעות פעילות שזמינים לקטגוריה הזו של העסק. |
ServiceType
הודעה שמתארת את סוג השירות שהעסק מציע.
ייצוג JSON |
---|
{ "serviceTypeId": string, "displayName": string } |
שדות | |
---|---|
serviceTypeId |
פלט בלבד. מזהה קבוע (שמסופק על ידי Google) לסוג השירות הזה. |
displayName |
פלט בלבד. השם המוצג של סוג השירות הקריא (לבני אדם). |
MoreHoursType
סוגים נוספים של שעות פעילות שעסקים יכולים להציע, בנוסף לשעות הפעילות הרגילות.
ייצוג JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
שדות | |
---|---|
hoursTypeId |
פלט בלבד. זהו מזהה קבוע ש-Google סיפקה לשעות מהסוג הזה. |
displayName |
פלט בלבד. השם המוצג באנגלית בפורמט קריא (לבני אדם) לסוג השעות. |
localizedDisplayName |
פלט בלבד. שם תצוגה קריא לאנשים המתאים עבור סוג השעות. |
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 |
גרסת הסכימה של כל הגרסאות החדשות חייבות להיות תואמות לאחור לגרסאות הישנות. |
regionCode |
חובה. קוד האזור במאגר CLDR של המדינה/האזור של הכתובת. אין אפשרות להסיק מידע זה בעבר, ובאחריות המשתמש לוודא שהערך נכון. פרטים נוספים זמינים בכתובת https://cldr.unicode.org/ וב-https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. דוגמה: 'CH' עבור שווייץ. |
languageCode |
אפשרות. קוד השפה BCP-47 של תוכן הכתובת הזו (אם ידוע). לרוב זו שפת ממשק המשתמש בטופס הקלט, או שהשפה צפויה להיות תואמת לאחת מהשפות שנמצאות בשימוש במדינה/באזור של הכתובת, או מקבילות בתמליל שלהן. זה יכול להשפיע על הפורמט במדינות מסוימות, אבל הוא לא קריטי לתקינות הנתונים ולעולם לא ישפיע על אימות או על פעולות אחרות שלא קשורות לפורמט. אם הערך לא ידוע, יש להשמיט אותו (במקום לציין ברירת מחדל שעלולה להיות שגויה). דוגמאות: 'zh-Hant', 'ja', 'ja-Latn', 'en'. |
postalCode |
אפשרות. המיקוד בכתובת. לא בכל המדינות נעשה שימוש במספרי מיקוד, או שנדרשות קיומם, אבל במקומות שבהם משתמשים בהם ייתכן שיופעל אימות נוסף בחלקים אחרים של הכתובת (למשל מדינה/אימות מיקוד בתוך ארה"ב). |
sortingCode |
אפשרות. קוד מיון נוסף, ספציפי למדינה. האפשרות הזו לא נמצאת בשימוש ברוב האזורים. כאשר משתמשים בו, הערך הוא מחרוזת כמו "CEDEX", ואופציונלית גם אחרי מספר (למשל "CEDEX 7"), או רק מספר בלבד שמייצג את "קוד המגזר" (ג'מייקה), "אינדיקטור אזור המשלוחים " (מלאווי) או"אינדיקטור לסניף דואר" (למשל חוף השנהב). |
administrativeArea |
אפשרות. חלוקת המשנה הניהולית הגבוהה ביותר, המשמשת לכתובות דואר של מדינה או אזור. לדוגמה, המדינה יכולה להיות מדינה, פרובינציה, אובלסט או נפה. באופן ספציפי, בספרד זהו המחוז ולא הקהילה האוטונומית (למשל, "ברצלונה" ולא "קטלוניה"). במדינות רבות לא משתמשים באזור מנהלי בכתובות דואר. למשל, בשווייץ צריך להשאיר את השדה הזה לא מאוכלס. |
locality |
אפשרות. המונח 'בדרך כלל' מתייחס לחלק העיר/העיירה של הכתובת. דוגמאות: עיר בארה"ב, קומוניית IT, עיר דואר בבריטניה. באזורים בעולם שבהם הרשויות המוניציפאליות אינן מוגדרות היטב או שאינן מתאימות למבנה זה, השאירו את הרשות המוניציפאלית ריקה והשתמשו ב-addressLines. |
sublocality |
אפשרות. מיקום המשנה של הכתובת. לדוגמה: שכונות, רובעים או מחוזות. |
addressLines[] |
שורות כתובת לא מובנות שמתארות את הרמות הנמוכות יותר בכתובת. מכיוון שערכים ב-addressLines לא כוללים פרטי סוג, הם עשויים להכיל לפעמים ערכים מרובים בשדה יחיד (למשל, "Austin, TX"), חשוב שסדר השורות יהיה ברור. סדר השורות צריך להיות 'הזמנת מעטפה' למדינה/אזור של הכתובת. במקומות שבהם זה יכול להשתנות (למשל ביפן), address_language משמש כדי לציין את הטקסט המפורש (למשל 'ja' לסידור מגדול לקטן ו-'ja-Latn' או 'en' מגודל קטן ל-גדול). כך אפשר לבחור את השורה הספציפית ביותר של הכתובת בהתאם לשפה. הייצוג המבני המינימלי המותר של כתובת כולל קוד regionCode שבו כל המידע שנותר מופיע ב-addressLines. ניתן היה לעצב כתובת כזו באופן קרוב מאוד ללא קידוד גיאוגרפי, אבל לא ניתן היה לספק נימוק סמנטי לגבי רכיבי הכתובת עד שהבעיה תיפתר לפחות באופן חלקי. הדרך המומלצת לטיפול בכתובות לא מובנות לחלוטין היא יצירת כתובת הכוללת קוד regionCode ו-addressLines בלבד ולאחר מכן קידוד גיאוגרפי (בניגוד לנחש אילו חלקים של הכתובת צריכים להיות רשויות מקומיות או אזורים מנהליים). |
recipients[] |
אפשרות. הנמען בכתובת. בנסיבות מסוימות שדה זה עשוי להכיל מידע מרובה שורות. לדוגמה, הוא עשוי להכיל מידע מסוג 'טיפול'. |
organization |
אפשרות. שם הארגון בכתובת. |
BusinessHours
מייצג את תקופות הזמן שבהן המיקום הזה פתוח ופעיל. מכילה אוסף של מופעים של [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
ייצוג JSON |
---|
{
"periods": [
{
object ( |
שדות | |
---|---|
periods[] |
חובה. סיכום של השעות שבהן המיקום הזה פתוח. כל תקופה מייצגת טווח של שעות שבהן המיקום פתוח במהלך השבוע. |
TimePeriod
מייצג את פרק הזמן שבו העסק פתוח, החל ביום או בשעה שפתוחים שצוינו ונסגר ביום/שעת הסגירה שצוינו. שעת הסגירה חייבת לחול אחרי שעת הפתיחה, למשל מאוחר יותר באותו יום או ביום שלאחר מכן.
ייצוג JSON |
---|
{ "openDay": enum ( |
שדות | |
---|---|
openDay |
חובה. הערך הזה מציין את ה- |
openTime |
חובה. הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין. |
closeDay |
חובה. מציין את |
closeTime |
חובה. הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין. |
DayOfWeek
מייצג את היום בשבוע.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
שעות ביום בפורמט 24 שעות. צריך להיות בין 0 ל-23. ממשק API עשוי לאפשר את הערך '24:00:00' בתרחישים כמו שעת הסגירה של העסק. |
minutes |
דקות בשעה ביום. הערך חייב להיות בין 0 ל-59. |
seconds |
שניות של דקות מזמן. בדרך כלל צריך להיות מספר בין 0 ל-59. ממשק API עשוי להתיר את הערך 60 אם הוא מאפשר שניות מדלגות. |
nanos |
שברים של שניות בננו-שניות. חייב להיות בין 0 ל-999,999,999. |
SpecialHours
קבוצת תקופות זמן שבהן שעות הפעילות של מיקום שונות משעות הפעילות הרגילות שלו.
ייצוג JSON |
---|
{
"specialHourPeriods": [
{
object ( |
שדות | |
---|---|
specialHourPeriods[] |
חובה. רשימת חריגים משעות הפעילות הרגילות של העסק. |
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 ( |
שדות | |
---|---|
startDate |
חובה. התאריך הקלנדרי שבו מתחילה תקופת הזמן המיוחדת הזו. |
openTime |
אפשרות. הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין. יש לציין אם |
endDate |
אפשרות. התאריך הקלנדרי שבו תקופת הזמן המיוחדת הזו מסתיימת. אם השדה |
closeTime |
אפשרות. הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין. יש לציין אם |
closed |
אפשרות. אם הערך הוא True, המערכת תתעלם מ- |
תאריך
מייצג תאריך קלנדרי מלא או חלקי, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שאינם משמעותיים. התאריך הזה יחסי ללוח השנה הגרגוריאני. הנתון הזה יכול לייצג אחת מהאפשרויות הבאות:
- תאריך מלא, עם ערכים שונים של שנה, חודש ויום.
- חודש ויום, עם שנה של אפס (למשל יום נישואין).
- שנה בפני עצמה, עם חודש של אפס ואפס יום.
- שנה וחודש, עם אפס יום (לדוגמה, תאריך תפוגה של כרטיס אשראי).
סוגים קשורים:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
ייצוג JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
שדות | |
---|---|
year |
שנת התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה. |
month |
החודש בשנה. צריך להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום. |
day |
היום בחודש. הערך צריך להיות בין 1 ל-31 והוא תקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם היום לא משמעותי. |
ServiceAreaBusiness
עסקים באזור שירות מספקים את השירות במיקום של הלקוח (לדוגמה, מנעולנים או שרברבים).
ייצוג JSON |
---|
{ "businessType": enum ( |
שדות | |
---|---|
businessType |
חובה. מציין את ה[סוג] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] של העסק בעל אזור השירות. |
places |
האזור שהעסק הזה מספק שירות מוגדר דרך קבוצת מקומות. |
regionCode |
לא משתנה. קוד האזור במאגר CLDR של המדינה או האזור שבהם נמצא העסק הזה של אזור השירות. פרטים נוספים זמינים ב-http://cldr.unicode.org/ וב-http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. דוגמה: 'CH' עבור שווייץ. שדה זה נדרש עבור עסקים של CUSTOMER_LOCATION_ONLY, אחרת המערכת תתעלם ממנו. האזור שמצוין כאן יכול להיות שונה מהאזורים שבהם העסק מספק שירות (לדוגמה, עסקים עם אזורי שירות שמספקים שירותים באזורים אחרים שבהם העסק נמצא). אם צריך לאמת את המיקום הזה לאחר יצירתו, הכתובת שצוינה למטרות אימות חייבת להיות ממוקמת באזור זה, והבעלים של העסק או נציג מורשה מטעמו חייבים לקבל דואר רגיל בכתובת האימות שצוינה. |
BusinessType
מציין אם העסק מציע שירותים באתר הלקוח בלבד (לדוגמה, גרר) או גם בכתובת וגם באתר החנות (לדוגמה, פיצרייה עם חדר אוכל שגם היא מציעה שירות משלוחים ללקוחות).
טיפוסים בני מנייה (enums) | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
פלט בלבד. לא צוין. |
CUSTOMER_LOCATION_ONLY |
העסק מספק שירות רק באזור עצמו (ולא בכתובת העסק). אם עסק מתעדכן מ-CUSTOMER_AND_BUSINESS_LOCATION ל-CUSTOMER_LOCATION_ONLY, עדכון המיקום חייב לכלול מסכת שדות storefrontAddress ולהגדיר את השדה כריק. |
CUSTOMER_AND_BUSINESS_LOCATION |
מספק שירות בכתובת העסק ובאזור שמסביב. |
מקומות
איחוד של אזורים שמיוצגים על ידי קבוצת מקומות.
ייצוג JSON |
---|
{
"placeInfos": [
{
object ( |
שדות | |
---|---|
placeInfos[] |
האזורים שמיוצגים על ידי מזהי מקומות. יש הגבלה ל-20 מקומות לכל היותר. |
PlaceInfo
מגדיר אזור שמיוצג על ידי מזהה מקום.
ייצוג JSON |
---|
{ "placeName": string, "placeId": string } |
שדות | |
---|---|
placeName |
חובה. השם המותאם לשוק המקומי של המקום. לדוגמה, |
placeId |
חובה. המזהה של המקום. חייב להתאים לאזור. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
מידע נוסף שמוצג ב-AdWords.
ייצוג JSON |
---|
{ "adPhone": string } |
שדות | |
---|---|
adPhone |
חובה. מספר טלפון חלופי שיוצג בתוספי המיקום של AdWords במקום מספר הטלפון הראשי של המיקום. |
LatLng
אובייקט שמייצג צמד של קו רוחב/קו אורך. ערך זה מבוטא כצמד זוגות לייצוג מעלות קו רוחב ומעלות קו אורך. אם לא צוין אחרת, האובייקט הזה חייב לעמוד ב תקן WGS84. הערכים חייבים להיות בטווחים מנורמלים.
ייצוג JSON |
---|
{ "latitude": number, "longitude": number } |
שדות | |
---|---|
latitude |
קו הרוחב במעלות. הערך חייב להיות בטווח של [ -90.0, +90.0]. |
longitude |
קו האורך במעלות. הוא צריך להיות בטווח של [ -180.0, +180.0]. |
OpenInfo
מידע שקשור למצב הפתיחה של העסק.
ייצוג JSON |
---|
{ "status": enum ( |
שדות | |
---|---|
status |
חובה. מציין אם המיקום פתוח כרגע או לא. כל המיקומים פתוחים כברירת מחדל, אלא אם מעדכנים את המיקום לסגירה. |
canReopen |
פלט בלבד. הערך הזה מציין אם העסק עומד בדרישות לפתיחה מחדש. |
openingDate |
אפשרות. התאריך שבו המיקום נפתח לראשונה. אם היום המדויק לא ידוע, אפשר לציין חודש ושנה בלבד. התאריך חייב להיות בעבר או להיות בטווח של עד שנה קדימה. |
OpenForBusiness
מציין את הסטטוס של מיקום.
טיפוסים בני מנייה (enums) | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
לא צוין. |
OPEN |
מציין שהמיקום פתוח. |
CLOSED_PERMANENTLY |
מציין שהמיקום נסגר לצמיתות. |
CLOSED_TEMPORARILY |
מציין שהמיקום נסגר זמנית. |
Metadata
מידע נוסף על המיקום שלא ניתן לעריכה על ידי המשתמש.
ייצוג 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 } |
שדות | |
---|---|
hasGoogleUpdated |
פלט בלבד. מציין אם במזהה המקום שמשויך למיקום הזה יש עדכונים שצריך לעדכן או לדחות על ידי הלקוח. אם הערך הבוליאני הזה מוגדר, צריך לקרוא ל-method |
hasPendingEdits |
פלט בלבד. מציין אם נכסים של מיקום זה נמצאים במצב המתנה לעריכה. |
canDelete |
פלט בלבד. האפשרות מציינת אם ניתן למחוק את המיקום באמצעות ה-API. |
canOperateLocalPost |
פלט בלבד. מציין אם ניתן לנהל פוסטים מקומיים בדף העסקי. |
canModifyServiceList |
פלט בלבד. הערך מציין אם הרישום יכול לשנות את רשימת השירותים. |
canHaveFoodMenus |
פלט בלבד. ההערה מציינת אם הדף העסקי עומד בדרישות להצגת תפריט אוכל. |
canOperateHealthData |
פלט בלבד. שדה זה מציין אם המיקום יכול לפעול על סמך נתוני בריאות. |
canOperateLodgingData |
פלט בלבד. שדה זה מציין אם המיקום יכול לפעול בנתוני לינה. |
placeId |
פלט בלבד. אם המיקום הזה מופיע במפות Google, השדה הזה יאוכלס במזהה של המיקום. ניתן להשתמש במזהה הזה במגוון ממשקי API של מקומות. אפשר להגדיר את השדה הזה רק בשיחות 'יצירה', אבל לא ב'עדכון'. |
duplicateLocation |
פלט בלבד. משאב המיקום שהמיקום הזה הוא כפילות שלו. |
mapsUri |
פלט בלבד. קישור למיקום במפות Google. |
newReviewUri |
פלט בלבד. קישור לדף בחיפוש Google שבו לקוח יכול לכתוב ביקורת על המיקום. |
canHaveBusinessCalls |
פלט בלבד. שדה זה מציין אם ניתן לבצע שיחות עסקיות. |
hasVoiceOfMerchant |
פלט בלבד. מציין אם הרישום כולל את Voice of Merchant. אם הערך הבוליאני הזה מוגדר כ-False, צריך לקרוא לממשק ה-API של locations.getVoiceOfMerchantState API כדי להבין למה אין לו את Voice of Merchant. |
פרופיל
כל המידע שקשור לפרופיל של המיקום.
ייצוג JSON |
---|
{ "description": string } |
שדות | |
---|---|
description |
חובה. תיאור המיקום, כפי שהוא מופיע בקול שלך. אף אחד אחר לא יכול לערוך אותו. |
RelationshipData
מידע על כל המיקומים של הורה וילדים שקשורים למיקום הזה.
ייצוג JSON |
---|
{ "parentLocation": { object ( |
שדות | |
---|---|
parentLocation |
מיקום ההורה שמיקום זה קשור אליו. |
childrenLocations[] |
רשימת מיקומי צאצא שמיקום זה קשור אליהם. |
parentChain |
שם המשאב של הרשת שהמיקום הזה משויך אליה. [איך מוצאים מזהה שרשרת] [Locations.SearchChains] |
RelevantLocation
מידע על מיקום אחר שקשור למיקום הנוכחי. הקשר יכול להיות כל אחד מ-DEPARTMENT_OF או INDEPENDENT_ESTABLISHMENT_OF, והמיקום המצוין כאן יכול להיות בכל אחד מהצדדים (הורה/צאצא) של המיקום.
ייצוג JSON |
---|
{
"placeId": string,
"relationType": enum ( |
שדות | |
---|---|
placeId |
חובה. צריך לציין את המיקום שנמצא בצד השני של היחס לפי מזהה המקום שלו. |
relationType |
חובה. סוג הקשר. |
RelationType
סוגי הקשרים שיש לציין.
טיפוסים בני מנייה (enums) | |
---|---|
RELATION_TYPE_UNSPECIFIED |
הסוג לא צוין. |
DEPARTMENT_OF |
המדד הזה מייצג קשר בין שני מיקומים שיש להם אזור פיזי אחד, אותו מותג/ניהול עליון/ארגון, אבל מאפייני מפתח שונים, כמו שעות הפעילות של החנות או מספרי טלפון. לדוגמה, בית המרקחת Costco הוא מחלקה בסיטונאות של Costco. |
INDEPENDENT_ESTABLISHMENT_IN |
דוגמה זו מייצגת מקרים שבהם שני מיקומים נמצאים יחד באותו מיקום פיזי, אך על ידי חברות שונות (למשל, Starbucks ב-Safeway, חנויות בקניון). |
MoreHours
תקופות הזמן שבהן מיקום פתוח עבור סוגים מסוימים של עסקים.
ייצוג JSON |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
שדות | |
---|---|
hoursTypeId |
חובה. סוג השעות. על הלקוחות להתקשר אל {#link businessCategory:BatchGet} כדי לקבל סוגים נתמכים של שעות פעילות בקטגוריות של המיקומים שלהם. |
periods[] |
חובה. אוסף של השעות שבהן המיקום הזה פתוח. כל תקופה מייצגת טווח של שעות שבהן המיקום פתוח במהלך השבוע. |
ServiceItem
הודעה שמתארת פריט שירות אחד. הוא משמש לתיאור סוג השירות שהמוכר מספק. לדוגמה, תספורת יכולה להיות שירות.
ייצוג JSON |
---|
{ "price": { object ( |
שדות | |
---|---|
price |
אפשרות. מייצג את המחיר הכספי של פריט השירות. מומלץ להגדיר קוד מטבע ויחידות כשכוללים מחיר. כך המערכת תיחשב כמחיר קבוע לפריט השירות. |
שדה איחוד service_item_info . תמיד צריך להגדיר אחד מהשדות הבאים. הערך של service_item_info יכול להיות רק אחת מהאפשרויות הבאות: |
|
structuredServiceItem |
אפשרות. השדה הזה ישמש כמקרה של נתוני שירותים מובְנים. |
freeFormServiceItem |
אפשרות. השדה הזה יוגדר כמקרה של נתוני שירותים בפריסה גמישה. |
StructuredServiceItem
מייצג שירות מובנה שמוצע על ידי המוכר. לדוגמה: אסלה_התקנה.
ייצוג JSON |
---|
{ "serviceTypeId": string, "description": string } |
שדות | |
---|---|
serviceTypeId |
חובה. השדה |
description |
אפשרות. תיאור הפריט של השירות המובנה. מגבלת התווים היא 300. |
FreeFormServiceItem
מייצג שירות בניסוח חופשי שמוצע על ידי המוכר. השירותים האלה לא נחשפים כחלק מנתוני השירותים במבנה שלנו. המוכר מזין ידנית את השמות של שירותים כאלה דרך פלטפורמה של מוכר גיאוגרפי.
ייצוג JSON |
---|
{
"category": string,
"label": {
object ( |
שדות | |
---|---|
category |
חובה. השדה הזה מייצג את שם הקטגוריה (כלומר, המזהה היציב של הקטגוריה). הערכים |
label |
חובה. תוויות של תיוג שפה של הפריט. מומלץ ששמות הפריטים יהיו באורך 140 תווים לכל היותר, ותיאורים באורך של 250 תווים לכל היותר. יש להגדיר את השדה הזה רק אם הקלט הוא פריט שירות מותאם אישית. צריך לעדכן סוגי שירותים סטנדרטיים באמצעות serviceTypeId. |
תווית
תווית שתשמש להצגת המחירון, החלק או הפריט.
ייצוג JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
שדות | |
---|---|
displayName |
חובה. השם המוצג של המחירון, החלק או הפריט. |
description |
אפשרות. תיאור של המחירון, החלק או הפריט. |
languageCode |
אפשרות. קוד השפה BCP-47 שעליו חלות המחרוזות האלה. ניתן להגדיר קבוצה אחת בלבד של תוויות לכל שפה. |
כסף
מייצג סכום כסף לפי סוג המטבע.
ייצוג JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currencyCode |
קוד המטבע בן שלוש אותיות כפי שמוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה, אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ו+999,999,999, כולל. אם הערך של |
שיטות |
|
---|---|
|
יצירת מיקום חדש שיהיה בבעלות המשתמש המחובר. |
|
רשימת המיקומים של החשבון שצוין. |