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 in Duane Reade").
phoneNumbers

object (PhoneNumbers)

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

object (Categories)

זה שינוי אופציונלי. הקטגוריות השונות שמתארות את העסק.
storefrontAddress

object (PostalAddress)

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

string

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

object (BusinessHours)

זה שינוי אופציונלי. שעות הפעילות של העסק.
specialHours

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

string

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

object (AdWordsLocationExtensions)

זה שינוי אופציונלי. מידע נוסף שמוצג ב-AdWords.
latlng

object (LatLng)

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

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