- משאב: מיקום
- ייצוג JSON
- BusinessHours
- TimePeriod (תקופת זמן)
- DayOfWeek
- SpecialHours
- SpecialHourPeriod
- ServiceAreaBusiness
- BusinessType
- PointRadius
- LatLng
- מקומות
- PlaceInfo
- LocationKey
- AdWordsLocationExtensions
- OpenInfo
- OpenForBusiness
- LocationState
- מאפיין
- RepeatedEnumAttributeValue
- UrlAttributeValue
- מטא-נתונים
- עותק משוכפל
- גישה
- PriceList
- תווית
- קטע
- SectionType
- פריט
- Money
- פרופיל
- RelationshipData
- MoreHours
- שיטות
משאב: מיקום
מיקום. תיאור מפורט של השדות האלה זמין במאמר במרכז העזרה. כדי לקבל רשימה של קטגוריות עסקיות חוקיות, אפשר לעיין בנקודת הקצה של הקטגוריה.
ייצוג JSON | |
---|---|
{ "name": string, "languageCode": string, "storeCode": string, "locationName": string, "primaryPhone": string, "additionalPhones": [ string ], "address": { object ( |
שדות | |
---|---|
name |
מזהה Google של המיקום הזה בטופס: בהקשר של התאמות, השדה הזה לא יאוכלס. |
languageCode |
שפת המיקום. מוגדרת במהלך היצירה ולא ניתן לעדכן אותה. |
storeCode |
מזהה חיצוני של המיקום הזה, והוא חייב להיות ייחודי בתוך חשבון נתון. זהו אמצעי לשיוך המיקום לרשומות שלך. |
locationName |
שם המיקום צריך לשקף את השם של העסק בעולם האמיתי, כפי שהוא מוצג בעקביות בחזית החנות, באתר ובנייר המכתבים של העסק וכפי שהלקוחות מכירים אותו. מידע נוסף רלוונטי אם הוא רלוונטי, ניתן לכלול בשדות אחרים של המשאב (לדוגמה, |
primaryPhone |
מספר טלפון שמתחבר למיקום העסק הספציפי שלכם בצורה ישירה ככל האפשר. כשהדבר אפשרי, השתמשו במספר טלפון בעסק, במקום במספר של מוקד טלפוני של מוקד טלפוני. |
additionalPhones[] |
עד שני מספרי טלפון (ניידים או קוויים, לא פקס) שבאמצעותם ניתן להתקשר לעסק, בנוסף למספר הטלפון הראשי. |
address |
כתובת מדויקת לתיאור מיקום העסק. תאי דואר או תיבות דואר הממוקמים במיקומים מרוחקים אינם קבילים. בשלב זה ניתן לציין עד חמישה ערכי |
primaryCategory |
קטגוריה שמתארת בצורה הטובה ביותר את העסק העיקרי שבו המיקום הזה עוסק. |
additionalCategories[] |
קטגוריות נוספות שמתארות את העסק שלכם. קטגוריות עוזרות ללקוחות למצוא תוצאות מדויקות וספציפיות לשירותים שהם מעוניינים בהם. כדי שפרטי העסק יהיו מדויקים ועדכניים, הקפידו להשתמש בכמה שפחות קטגוריות לתיאור העסק העיקרי שלכם. בחרו קטגוריות ספציפיות ככל האפשר, אך מייצגות את העסק העיקרי שלכם. |
websiteUrl |
כתובת URL של העסק הזה. במידת האפשר, יש להשתמש בכתובת URL שמייצגת את המיקום הספציפי של העסק, ולא כתובת אתר או כתובת URL כללית שמייצגים את כל המיקומים, או את המותג. |
regularHours |
שעות הפעילות של העסק. |
specialHours |
שעות פתיחה מיוחדות של העסק. הנתונים האלה כוללים בדרך כלל שעות פעילות בחגים ובשעות אחרות מחוץ לשעות הפעילות הרגילות. השעות האלה מבטלות את שעות הפעילות הרגילות. |
serviceArea |
עסקים בעלי אזור שירות מספקים את השירות באתר של הלקוח. אם העסק מספק שירות באזור מוגדר(SAB), השדה הזה מתאר את האזורים שבהם העסק מספק שירות. |
locationKey |
אוסף של מפתחות שמקשרים את העסק הזה לנכסי Google אחרים, כגון דף Google+ ו'מקומות Google' במפות Google. |
labels[] |
אוסף של מחרוזות בפורמט חופשי שמאפשרות לכם לתייג את העסק. התוויות האלה לא מוצגות למשתמש, אלא רק לכם. מוגבל ל-255 תווים (לכל תווית). |
adWordsLocationExtensions |
מידע נוסף שמוצג ב-AdWords. |
latlng |
קווי אורך ורוחב שסיפק המשתמש. כשיוצרים מיקום, המערכת מתעלמת מהשדה הזה אם הכתובת שסיפקתם מסומנת גיאוגרפית בהצלחה. השדה הזה מוחזר רק לבקשות לקבל אם הערך של |
openInfo |
דגל שמציין אם המיקום פתוח כרגע לעסקים. |
locationState |
פלט בלבד. קבוצה של בוליאנים שמשקפים את המצב של מיקום מסוים. |
attributes[] |
מאפיינים למיקום הזה. |
metadata |
פלט בלבד. מידע נוסף שלא ניתן לעריכה על ידי המשתמש. |
priceLists[] |
הוצא משימוש: פרטי המחירון למיקום הזה. |
profile |
התכונה מאפשרת לתאר את העסק בקול שלכם ולשתף עם המשתמשים את הסיפור הייחודי של העסק והדברים שאתם מציעים. |
relationshipData |
כל המיקומים והרשתות שקשורים למיקום הזה. |
moreHours[] |
שעות פעילות נוספות עבור מחלקות שונות של העסק או לקוחות ספציפיים. |
BusinessHours
מייצג את תקופות הזמן שבהן המיקום הזה פתוח ופעיל. מכיל אוסף של TimePeriod
מופעים.
ייצוג JSON | |
---|---|
{
"periods": [
{
object ( |
שדות | |
---|---|
periods[] |
סיכום של השעות שבהן המיקום הזה פתוח. כל תקופה מייצגת טווח של שעות שבהן המיקום פתוח במהלך השבוע. |
TimePeriod
מייצג את פרק הזמן שבו העסק פתוח, החל ביום או בשעה שפתוחים שצוינו ונסגר ביום/שעת הסגירה שצוינו. שעת הסגירה חייבת לחול אחרי שעת הפתיחה, למשל מאוחר יותר באותו יום או ביום שלאחר מכן.
ייצוג JSON | |
---|---|
{ "openDay": enum ( |
שדות | |
---|---|
openDay |
הערך הזה מציין את ה- |
openTime |
זמן בפורמט מורחב לפי תקן ISO 8601 (hh:mm). הערכים החוקיים הם 00:00-24:00, כאשר 24:00 מייצג את חצות בסוף שדה היום שצוין. |
closeDay |
מציין את |
closeTime |
זמן בפורמט מורחב לפי תקן 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 ( |
שדות | |
---|---|
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 |
השעה על הקיר ב- |
endDate |
התאריך הקלנדרי שבו תקופת הזמן המיוחדת הזו מסתיימת. אם השדה |
closeTime |
השעה על הקיר ב- |
isClosed |
אם הערך הוא True, המערכת תתעלם מ- |
ServiceAreaBusiness
עסקים באזור שירות מספקים את השירות במיקום של הלקוח (לדוגמה, מנעולנים או שרברבים).
ייצוג JSON | |
---|---|
{ "businessType": enum ( |
שדות | ||
---|---|---|
businessType |
מציין את |
|
שדה איחוד coverageArea . מציין את אזור הכיסוי שבו העסק מציע שירות. הערך של coverageArea יכול להיות רק אחת מהאפשרויות הבאות: |
||
radius |
פלט בלבד. האזור שבו העסק הזה משרת מרוכז סביב נקודה. |
|
places |
האזור שהעסק הזה מספק שירות מוגדר דרך קבוצת מקומות. |
BusinessType
מציין אם העסק מציע שירותים באתר הלקוח בלבד (לדוגמה, גרר) או גם בכתובת וגם באתר החנות (לדוגמה, פיצרייה עם חדר אוכל שגם היא מציעה שירות משלוחים ללקוחות).
טיפוסים בני מנייה (enums) | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
פלט בלבד. לא צוין. |
CUSTOMER_LOCATION_ONLY |
העסק מספק שירות רק באזור עצמו (ולא בכתובת העסק). |
CUSTOMER_AND_BUSINESS_LOCATION |
מספק שירות בכתובת העסק ובאזור שמסביב. |
PointRadius
רדיוס סביב נקודה מסוימת (קו רוחב/אורך).
ייצוג JSON | |
---|---|
{
"latlng": {
object ( |
שדות | |
---|---|
latlng |
קו הרוחב/קו האורך שמציין את מרכז האזור המוגדר על ידי הרדיוס. |
radiusKm |
המרחק בקילומטרים של האזור שמסביב לנקודה. |
LatLng
אובייקט שמייצג צמד של קו רוחב/קו אורך. ערך זה מבוטא כצמד זוגות לייצוג מעלות קו רוחב ומעלות קו אורך. אם לא צוין אחרת, האובייקט הזה חייב לעמוד בתקן WGS84. הערכים חייבים להיות בטווחים מנורמלים.
ייצוג JSON | |
---|---|
{ "latitude": number, "longitude": number } |
שדות | |
---|---|
latitude |
קו הרוחב במעלות. הערך חייב להיות בטווח של [ -90.0, +90.0]. |
longitude |
קו האורך במעלות. הוא צריך להיות בטווח של [ -180.0, +180.0]. |
מקומות
איחוד של אזורים שמיוצגים על ידי קבוצת מקומות.
ייצוג JSON | |
---|---|
{
"placeInfos": [
{
object ( |
שדות | |
---|---|
placeInfos[] |
האזורים שמיוצגים על ידי מזהי מקומות. יש הגבלה ל-20 מקומות לכל היותר. |
PlaceInfo
מגדיר אזור שמיוצג על ידי מזהה מקום.
ייצוג JSON | |
---|---|
{ "name": string, "placeId": string } |
שדות | |
---|---|
name |
השם המותאם לשוק המקומי של המקום. לדוגמה, |
placeId |
המזהה של המקום. חייב להתאים לאזור. |
LocationKey
החלפה/החלפה של הפניות למפתח עבור מיקום מסוים.
ייצוג JSON | |
---|---|
{ "plusPageId": string, "placeId": string, "explicitNoPlaceId": boolean, "requestId": string } |
שדות | |
---|---|
plusPageId |
פלט בלבד. אם למיקום הזה משויך דף Google+, הוא יאוכלס במזהה דף Google+ של המיקום הזה. |
placeId |
אם המיקום הזה אומת והוא מחובר למפות Google או מופיע במפות Google, השדה הזה יאוכלס במזהה המקום של המיקום. ניתן להשתמש במזהה הזה במגוון ממשקי API של מקומות. אם המיקום הזה לא מאומת, ייתכן שהשדה הזה יאוכלס אם המיקום משויך למקום שמופיע במפות Google. אפשר להגדיר את השדה הזה רק בשיחות 'יצירה', אבל לא ב'עדכון'. הערך הבוליאני הנוסף של |
explicitNoPlaceId |
פלט בלבד. הערך של true מציין שמזהה מקום לא מוגדר מכוון, ושונה מזה שלא בוצע עדיין שיוך. |
requestId |
פלט בלבד. המכשיר |
AdWordsLocationExtensions
מידע נוסף שמוצג ב-AdWords.
ייצוג JSON | |
---|---|
{ "adPhone": string } |
שדות | |
---|---|
adPhone |
מספר טלפון חלופי שיוצג בתוספי המיקום של AdWords במקום מספר הטלפון הראשי של המיקום. |
OpenInfo
מידע שקשור למצב הפתיחה של העסק.
ייצוג JSON | |
---|---|
{ "status": enum ( |
שדות | |
---|---|
status |
מציין אם המיקום פתוח כרגע או לא. כל המיקומים פתוחים כברירת מחדל, אלא אם מעדכנים את המיקום לסגירה. |
canReopen |
פלט בלבד. הערך הזה מציין אם העסק עומד בדרישות לפתיחה מחדש. |
openingDate |
התאריך שבו המיקום נפתח לראשונה. אם היום המדויק לא ידוע, אפשר לציין חודש ושנה בלבד. התאריך חייב להיות בעבר או להיות בטווח של עד שנה קדימה. |
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 |
פלט בלבד. מציין אם יש עדכונים במזהה המקום המשויך למיקום הזה. |
isDuplicate |
פלט בלבד. ערך זה מציין אם המיקום הוא כפילות של מיקום אחר. |
isSuspended |
פלט בלבד. שדה זה מציין אם המיקום מושעה. מיקומים מושעים לא גלויים למשתמשי קצה במוצרי Google. אם לדעתך מדובר בטעות, אפשר לעיין במאמר הזה במרכז העזרה. |
canUpdate |
פלט בלבד. שדה זה מציין אם ניתן לעדכן את המיקום. |
canDelete |
פלט בלבד. מציין אם ניתן למחוק את המיקום באמצעות ה-API של 'Google לעסק שלי'. |
isVerified |
פלט בלבד. שדה זה מציין אם המיקום מאומת. |
needsReverification |
פלט בלבד. שדה זה מציין אם המיקום דורש אימות מחדש. |
isPendingReview |
פלט בלבד. שדה זה מציין אם בדיקת המיקום בהמתנה. |
isDisabled |
פלט בלבד. מציין אם המיקום מושבת. |
isPublished |
פלט בלבד. שדה זה מציין אם המיקום פורסם. |
isDisconnected |
פלט בלבד. מציין אם המיקום מנותק ממקום כלשהו במפות Google. |
isLocalPostApiDisabled |
פלט בלבד. ההערה מציינת אם accounts.locations.localPosts מושבת במיקום הזה. |
canModifyServiceList |
פלט בלבד. הערך מציין אם הרישום יכול לשנות רשימת ServiceList. |
canHaveFoodMenus |
פלט בלבד. ההערה מציינת אם הדף העסקי עומד בדרישות להצגת תפריט אוכל. |
hasPendingEdits |
פלט בלבד. מציין אם נכסים של מיקום זה נמצאים במצב המתנה לעריכה. |
hasPendingVerification |
פלט בלבד. שדה זה מציין אם יש למיקום בקשות אימות בהמתנה. |
canOperateHealthData |
פלט בלבד. שדה זה מציין אם המיקום יכול לפעול על סמך נתוני בריאות. |
canOperateLodgingData |
פלט בלבד. שדה זה מציין אם המיקום יכול לפעול בנתוני לינה. |
מאפיין
מאפיין מיקום. המאפיינים מספקים מידע נוסף על המיקום. המאפיינים שאפשר להגדיר למיקום משתנים בהתאם למאפיינים של המיקום (למשל קטגוריה). המאפיינים הזמינים נקבעים על ידי Google ויכול להיות שאפשר להוסיף ולהסיר אותם בלי שינויים ב-API.
ייצוג JSON | |
---|---|
{ "attributeId": string, "valueType": enum ( |
שדות | |
---|---|
attributeId |
מזהה המאפיין. Google מספקת את מזהי המאפיינים. |
valueType |
פלט בלבד. סוג הערך שהמאפיין הזה מכיל. לפי הצורך, צריך לקבוע איך לפרש את הערך. |
values[] |
הערכים למאפיין הזה. סוג הערכים שמצוינים חייב להתאים לזה שמצופה עבור המאפיין הזה. מידע נוסף זמין בקטע AttributeValueType. זהו שדה חוזר שאפשר לציין בו כמה ערכי מאפיינים. סוגי מאפיינים תומכים רק בערך אחד. |
repeatedEnumValue |
כאשר הסוג של ערך המאפיין הוא REPEATED_ENUM, הוא מכיל את ערך המאפיין ושדות הערכים האחרים חייבים להיות ריקים. |
urlValues[] |
כאשר הסוג של ערך המאפיין הוא 'כתובת אתר', השדה הזה מכיל את הערכים של המאפיין הזה ושדות הערכים האחרים חייבים להיות ריקים. |
RepeatedEnumAttributeValue
ערכים למאפיין עם valueType
של REPEATED_ENUM. הרכיב הזה כולל שתי רשימות של מזהי ערכים: המזהים עם הערך (true) והמזהים שלא הוגדרו (false). אם חסרים ערכים, הם נחשבים לא ידועים. יש לציין לפחות ערך אחד.
ייצוג JSON | |
---|---|
{ "setValues": [ string ], "unsetValues": [ string ] } |
שדות | |
---|---|
setValues[] |
ערכי טיפוס שהוגדרו. |
unsetValues[] |
ערכי Enum שלא הוגדרו. |
UrlAttributeValue
ערכים של מאפיין עם כתובת URL שמסתיימת ב-valueType
.
ייצוג JSON | |
---|---|
{ "url": string } |
שדות | |
---|---|
url |
כתובת ה-URL. |
Metadata
מידע נוסף על המיקום שלא ניתן לעריכה על ידי המשתמש.
ייצוג JSON | |
---|---|
{
"duplicate": {
object ( |
שדות | |
---|---|
duplicate |
מידע על המיקום שמיקום זה משוכפל. מוצג רק אם הערך |
mapsUrl |
קישור למיקום במפות Google. |
newReviewUrl |
קישור לדף בחיפוש Google שבו לקוח יכול לכתוב ביקורת על המיקום. |
שכפול
מידע על המיקום שמיקום זה משוכפל.
ייצוג JSON | |
---|---|
{
"locationName": string,
"placeId": string,
"access": enum ( |
שדות | |
---|---|
locationName |
שם המשאב של המיקום שהערך שלו הוא כפילות. השדה הזה יאוכלס רק אם למשתמש המאומת יש הרשאות גישה למיקום הזה והמיקום הזה לא נמחק. |
placeId |
מזהה המקום של המיקום שהפריט הזה משוכפל. |
access |
מציין אם למשתמש יש גישה למיקום שאותו הוא משכפל. |
גישה
רמת הגישה של המשתמש למיקום שהוא משוכפל. אפשרות זו מחליפה 'בעלות' ויש להשתמש בה במקומה.
טיפוסים בני מנייה (enums) | |
---|---|
ACCESS_UNSPECIFIED |
לא צוין. |
ACCESS_UNKNOWN |
לא ניתן לקבוע אם למשתמש יש גישה למיקום שהוא משוכפל. |
ALLOWED |
למשתמש יש גישה למיקום שהוא משוכפל. |
INSUFFICIENT |
למשתמש אין גישה למיקום שהוא משוכפל. |
PriceList
הוצא משימוש: רשימה של מידע על מחירי פריטים. רשימות המחירים בנויות כרשימת מחירים אחת או יותר, וכל אחת מהן מכילה קטע אחד או יותר עם פריט אחד או יותר. לדוגמה, רשימות של מחירי מזון יכולות לייצג תפריטי ארוחות בוקר/צהריים/ארוחת ערב, ולהשתמש בקטעים של המבורגרים/סטייקים/מאכלי ים.
ייצוג JSON | |
---|---|
{ "priceListId": string, "labels": [ { object ( |
שדות | |
---|---|
priceListId |
חובה. המזהה של רשימת המחירים. לא ניתן לשכפל במיקום הזה מזהי מחירים, מקטעים ופריטים. |
labels[] |
חובה. תוויות עם תיוג שפה של מחירון. |
sourceUrl |
כתובת ה-URL האופציונלית של המקור שממנו אוחזר מחיר המחירון. לדוגמה, זאת יכולה להיות כתובת ה-URL של הדף שצורף באופן אוטומטי כדי לאכלס את פרטי התפריט. |
sections[] |
חובה. סעיפים עבור מחירון זה. כל רשימת מחירים צריכה להכיל לפחות קטע אחד. |
תווית
תווית שתשמש להצגת המחירון, החלק או הפריט.
ייצוג JSON | |
---|---|
{ "displayName": string, "description": string, "languageCode": string } |
שדות | |
---|---|
displayName |
חובה. השם המוצג של המחירון, החלק או הפריט. |
description |
אפשרות. תיאור של המחירון, החלק או הפריט. |
languageCode |
אפשרות. קוד השפה BCP-47 שעליו חלות המחרוזות האלה. ניתן להגדיר קבוצה אחת בלבד של תוויות לכל שפה. |
קטע
קטע ברשימת המחירים שמכיל פריט אחד או יותר.
ייצוג JSON | |
---|---|
{ "sectionId": string, "labels": [ { object ( |
שדות | |
---|---|
sectionId |
חובה. המזהה של הקטע. לא ניתן לשכפל במיקום הזה מזהי מחירים, מקטעים ופריטים. |
labels[] |
חובה. תוויות עם תיוג שפה בקטע הזה. מומלץ שהשמות והתיאורים של הקטעים יהיו באורך של עד 140 תווים. יש צורך בקבוצה אחת לפחות של תוויות. |
sectionType |
אפשרות. סוג הקטע של המחירון הנוכחי. ערך ברירת המחדל הוא FOOD. |
items[] |
פריטים שכלולים בקטע הזה ברשימת המחירים. |
SectionType
סוג הקטע.
טיפוסים בני מנייה (enums) | |
---|---|
SECTION_TYPE_UNSPECIFIED |
לא צוין. |
FOOD |
הקטע מכיל פריטים שמייצגים אוכל. |
SERVICES |
הקטע מכיל פריטים שמייצגים שירותים. |
פריט
פריט אחד ברשימה. לכל וריאציה של פריט ברשימת המחירים צריך להיות פריט משלה עם נתוני מחיר משלה.
ייצוג JSON | |
---|---|
{ "itemId": string, "labels": [ { object ( |
שדות | |
---|---|
itemId |
חובה. המזהה של הפריט. לא ניתן לשכפל במיקום הזה מזהי מחירים, מקטעים ופריטים. |
labels[] |
חובה. תוויות של תיוג שפה של הפריט. מומלץ ששמות הפריטים יהיו באורך 140 תווים לכל היותר, ותיאורים באורך של 250 תווים לכל היותר. יש צורך בקבוצה אחת לפחות של תוויות. |
price |
אפשרות. מחיר הפריט. |
כסף
מייצג סכום כסף לפי סוג המטבע.
ייצוג JSON | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
שדות | |
---|---|
currencyCode |
קוד המטבע בן שלוש אותיות כפי שמוגדר בתקן ISO 4217. |
units |
מספר היחידות השלמות של הסכום. לדוגמה, אם הערך של |
nanos |
מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ו+999,999,999, כולל. אם הערך של |
פרופיל
כל המידע שקשור לפרופיל של המיקום.
ייצוג JSON | |
---|---|
{ "description": string } |
שדות | |
---|---|
description |
תיאור המיקום, כפי שהוא מופיע בקול שלך. אף אחד אחר לא יכול לערוך אותו. |
RelationshipData
מידע על כל המיקומים של הורה וילדים שקשורים למיקום הזה.
ייצוג JSON | |
---|---|
{ "parentChain": string } |
שדות | |
---|---|
parentChain |
שם המשאב של הרשת שהמיקום הזה משויך אליה. |
MoreHours
תקופות הזמן שבהן מיקום פתוח עבור סוגים מסוימים של עסקים.
ייצוג JSON | |
---|---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
שדות | |
---|---|
hoursTypeId |
חובה. סוג השעות. על הלקוחות להתקשר אל {#link businessCategory:BatchGet} כדי לקבל סוגים נתמכים של שעות פעילות בקטגוריות של המיקומים שלהם. |
periods[] |
חובה. אוסף של השעות שבהן המיקום הזה פתוח. כל תקופה מייצגת טווח של שעות שבהן המיקום פתוח במהלך השבוע. |
שיטות |
|
---|---|
|
משייך מיקום למזהה של מקום. |
|
הפונקציה מקבלת את כל המיקומים שצוינו בחשבון הנתון. |
|
מחזירה רשימה מעומדת של ביקורות לכל המיקומים שצוינו. |
|
ביטול השיוך בין מיקום למזהה המקום שלו. |
|
הפונקציה יוצרת location חדש בבעלות החשבון שצוין ומחזירה אותו. |
|
מוחק מיקום. |
|
מדווח על כל אפשרויות האימות המתאימות למיקום בשפה מסוימת. |
|
הפונקציה מחפשת את כל המיקומים האפשריים שתואמים למיקום שצוין. |
|
הפונקציה מקבלת את המיקום שצוין. |
|
פונקציה זו מחזירה את תפריטי האוכל של מיקום מסוים. |
|
קבלת הגרסה המעודכנת של Google של המיקום שצוין. |
|
הפונקציה מחזירה את המאפיינים של ספק שירותי הבריאות של מיקום ספציפי. |
|
קבלת רשימת השירותים שצוינה למיקום מסוים. |
|
רשימת המיקומים של החשבון שצוין. |
|
מעדכן את המיקום שצוין. |
|
הפונקציה מחזירה דוח שמכיל תובנות על מדד אחד או יותר לפי מיקום. |
(deprecated) |
מעביר מיקום מחשבון שבבעלות המשתמש לחשבון אחר שאותו המשתמש מנהל. |
|
עדכון תפריטי האוכל של מיקום מסוים. |
|
עדכון המאפיינים של ספק שירותי הבריאות במיקום מסוים. |
|
עדכון רשימת השירותים שצוינה עבור מיקום מסוים. |
|
התחלת תהליך האימות של מיקום. |