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

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

Methods

delete

 מחיקת מיקום.

get

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

getAttributes

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

getGoogleUpdated

 הפונקציה מחזירה את המיקום שצוין כפי שהוא מופיע במפות Google ובחיפוש Google.

patch

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

updateAttributes

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