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 عمومی که همه مکان‌ها یا نام تجاری را نشان می‌دهد، از نشانی اینترنتی استفاده کنید که نشان‌دهنده این مکان تجاری فردی است.

regularHours

object ( BusinessHours )

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

specialHours

object ( SpecialHours )

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

serviceArea

object ( ServiceAreaBusiness )

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

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

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