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"). אין לכלול תיאורים שיווקיים, קודי חנויות, תווים מיוחדים, שעות פעילות או סטטוס סגור/פתוח, מספרי טלפון, כתובות אתרים, פרטי שירות/מוצר, מיקום/כתובת או מסלול הגעה, או מידע על מקום סגור (לדוגמה, "Chase ATM ב-Duane Reade").
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

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

object (AdWordsLocationExtensions)

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

object (LatLng)

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

אפשרות. המונח 'בדרך כלל' מתייחס לחלק העיר/העיירה של הכתובת. דוגמאות: עיר בארה"ב, קומוניית IT, עיר דואר בבריטניה. באזורים בעולם שבהם הרשויות המוניציפאליות אינן מוגדרות היטב או שאינן מתאימות למבנה זה, השאירו את הרשות המוניציפאלית ריקה והשתמשו ב-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 מייצג את חצות בסוף שדה היום שצוין.
closeDay

enum (DayOfWeek)

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

object (TimeOfDay)

חובה. הערכים החוקיים הם 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

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

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

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

enum (BusinessType)

חובה. מציין את ה[סוג] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] של העסק בעל אזור השירות.
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

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

טיפוסים בני מנייה (enums)
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

אובייקט שמייצג צמד של קו רוחב/קו אורך. ערך זה מבוטא כצמד זוגות לייצוג מעלות קו רוחב ומעלות קו אורך. אם לא צוין אחרת, האובייקט הזה חייב לעמוד ב תקן 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

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

טיפוסים בני מנייה (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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

string

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

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

string

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

string

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

string

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

boolean

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

boolean

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

פרופיל

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

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

string

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

RelationshipData

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

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

object (RelevantLocation)

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

object (RelevantLocation)

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

string

שם המשאב של הרשת שהמיקום הזה משויך אליה. [איך מוצאים מזהה שרשרת] [Locations.SearchChains]

RelevantLocation

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

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

string

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

enum (RelationType)

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

RelationType

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

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

MoreHours

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

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

string

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

object (TimePeriod)

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

ServiceItem

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

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

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
שדות
price

object (Money)

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

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

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

StructuredServiceItem

מייצג שירות מובנה שמוצע על ידי המוכר. לדוגמה: אסלה_התקנה.

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

string

חובה. השדה serviceTypeId הוא מזהה ייחודי ש-Google סיפקה. המזהה הזה נמצא ב-ServiceType. המידע הזה מסופק על ידי שירות rpc categories.batchGet.
description

string

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

FreeFormServiceItem

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

ייצוג 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", המשמעות היא ש-1 יחידה = דולר ארה"ב אחד.
nanos

integer

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

שיטות

create

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

list

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