REST Resource: 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)

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

שיטות

delete

 מוחק מיקום.

get

 מחזירה את המיקום שצוין.

getAttributes

 חיפוש של כל המאפיינים שהוגדרו למיקום נתון.

getGoogleUpdated

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

patch

 מעדכן את המיקום שצוין.

updateAttributes

 עדכון המאפיינים של מיקום נתון.