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 در Duane Reade») را اضافه نکنید.
phoneNumbers

object (PhoneNumbers)

اختیاری. شماره تلفن‌های مختلفی که مشتریان می‌توانند برای تماس با کسب‌وکار استفاده کنند.
categories

object (Categories)

اختیاری. دسته‌های مختلفی که کسب‌وکار را توصیف می‌کنند.
storefrontAddress

object (PostalAddress)

اختیاری. نشانی دقیق و درست برای شرح مکان کسب‌وکارتان. صندوق‌های پستی اداره پست یا صندوق‌های پستی شخصی واقع در مکان‌های دوردست پذیرفته نمی‌شود. درحال‌حاضر، می‌توانید حداکثر پنج مقدار addressLines در نشانی مشخص کنید. این فیلد فقط باید برای کسب‌وکارهایی تنظیم شود که فروشگاه فیزیکی دارند. این فیلد نباید برای مکان‌های نوع CUSTOMER_LOCATION_ONLY تنظیم شود، اما اگر تنظیم شود، هر مقدار ارائه‌شده‌ای نادیده گرفته خواهد شد.
websiteUri

string

اختیاری. نشانی وب این کسب‌وکار. درصورت امکان، از نشانی وبی استفاده کنید که نشان‌دهنده این مکان کسب‌وکار باشد، نه وب‌سایت/ نشانی وب عمومی که نشان‌دهنده همه مکان‌ها یا نمانام باشد.
regularHours

object (BusinessHours)

اختیاری. ساعات کاری کسب‌وکار.
specialHours

object (SpecialHours)

اختیاری. ساعات کاری ویژه برای کسب‌وکار. این معمولاً شامل ساعات کاری تعطیلات و زمان‌های دیگر خارج‌از ساعات کاری معمول می‌شود. این ساعت‌ها جایگزین ساعت کاری معمول می‌شود. این فیلد را نمی‌توان بدون ساعات کاری معمول تنظیم کرد.
serviceArea

object (ServiceAreaBusiness)

اختیاری. کسب‌وکارهای با منطقه خدماتی خدماتشان را در مکان مشتری ارائه می‌دهند. اگر این کسب‌وکار از نوع کسب‌وکار با منطقه خدماتی باشد، این فیلد منطقه(های) تحت پوشش خدمات کسب‌وکار را توصیف می‌کند.
labels[]

string

اختیاری. مجموعه‌ای از رشته‌های قالب آزاد که به شما امکان می‌دهد کسب‌وکارتان را برچسب‌گذاری کنید. این برچسب‌ها برای کاربر نمایش داده نمی‌شوند؛ فقط شما می‌توانید آن‌ها را ببینید. باید بین ۱ تا ۲۵۵ نویسه برای هر برچسب باشد.
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 Maps و «جستجو» نشان داده می‌شود برمی‌گرداند.

patch

 مکان مشخص‌شده را به‌روز می‌کند.

updateAttributes

 به‌روزرسانی مشخصه‌های مکان موردنظر.