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

اختیاری. فهرست سرویس‌هایی که فروشندگان پشتیبانی می‌کنند. خدمات می‌تواند شامل کوتاه کردن مو، نصب آب‌گرم‌کن، و غیره باشد. موارد خدمات تکراری به‌طور خودکار برداشته می‌شود.

PhoneNumbers

مجموعه‌ای از شماره تلفن‌های کسب‌وکار. درطول به‌روزرسانی، هر دو فیلد باید تنظیم شوند. مشتریان نمی‌توانند فقط شماره تلفن اصلی یا اضافی را بااستفاده از ماسک به‌روزرسانی به‌روز کنند. قالب بین‌المللی شماره تلفن ترجیح داده می‌شود، مثل «‎+1 415 555 0132»، برای اطلاعات بیشتر به (https://developers.google.com/style/phone-numbers#international-phone-numbers) مراجعه کنید.

نمایش JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
فیلدها
primaryPhone

string

الزامی. شماره تلفنی که تا حد امکان مستقیماً به مکان کسب‌وکار شما متصل شود. درصورت امکان به‌جای خط پشتیبانی مرکز تماس، از شماره تلفن محلی استفاده کنید.
additionalPhones[]

string

اختیاری. حداکثر دو شماره تلفن (همراه یا ثابت، نه نمابر) که می‌توان با کسب‌وکارتان تماس گرفت، علاوه‌بر شماره تلفن اصلی شما.

دسته‌ها

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

نمایش JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
فیلدها
primaryCategory

object (Category)

الزامی. دسته‌ای که به بهترین شکل کسب‌وکار اصلی این مکان را توصیف می‌کند.
additionalCategories[]

object (Category)

اختیاری. دسته‌های تکمیلی برای توصیف کسب‌وکارتان. دسته‌ها به مشتریانتان کمک می‌کنند نتایج دقیق و مشخصی برای خدمات موردعلاقه‌شان پیدا کنند. برای اینکه اطلاعات کسب‌وکارتان دقیق و فعال بماند، حتماً از کمترین تعداد دسته‌های ممکن برای شرح کلی کسب‌وکار اصلی‌تان استفاده کنید. دسته‌هایی را انتخاب کنید که تا حد امکان خاص باشند، اما نشان‌دهنده کسب‌وکار اصلی‌تان باشند.

دسته

دسته‌ای که توصیف می‌کند این کسب‌وکار چیست (نه اینکه چه کاری انجام می‌دهد). برای مشاهده فهرست شناسه‌های معتبر دسته‌ها و نگاشت آن‌ها به نام‌های قابل‌خواندن برای انسان، به categories.list مراجعه کنید.

نمایش JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
فیلدها
name

string

الزامی. شناسه ثابت (ارائه‌شده توسط Google) برای این دسته. هنگام اصلاح دسته (هنگام ایجاد یا به‌روزرسانی مکان) باید مقدار مشخص شود.
displayName

string

فقط خروجی. نام دسته قابل‌خواندن برای انسان. این مورد هنگام خواندن مکان تنظیم می‌شود. هنگام اصلاح مکان، category_id باید تنظیم شود.
serviceTypes[]

object (ServiceType)

فقط خروجی. فهرستی از همه انواع خدماتی که برای این دسته کسب‌وکار دردسترس است.
moreHoursTypes[]

object (MoreHoursType)

فقط خروجی. انواع ساعت کاری بیشتری که برای این دسته کسب‌وکار دردسترس است.

ServiceType

پیامی که نوع خدماتی را که کسب‌وکار ارائه می‌دهد توصیف می‌کند.

نمایش JSON 
{
  "serviceTypeId": string,
  "displayName": string
}
فیلدها
serviceTypeId

string

فقط خروجی. شناسه پایدار (ارائه‌شده توسط Google) برای این نوع سرویس.
displayName

string

فقط خروجی. نام نمایشی قابل‌خواندن برای انسان برای نوع سرویس.

MoreHoursType

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

نمایش JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
فیلدها
hoursTypeId

string

فقط خروجی. شناسه ثابتی که Google برای این نوع ساعت ارائه کرده است.
displayName

string

فقط خروجی. نام نمایشی انگلیسی قابل‌خواندن برای انسان برای نوع ساعت.
localizedDisplayName

string

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

BusinessHours

نشان‌دهنده دوره‌های زمانی است که این مکان برای کسب‌وکار باز است. مجموعه‌ای از نمونه‌های [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] را نگه می‌دارد.

نمایش JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
فیلدها
periods[]

object (TimePeriod)

الزامی. مجموعه‌ای از زمان‌هایی که این مکان برای کسب‌وکار باز است. هر دوره نشان‌دهنده بازه‌ای از ساعت‌ها است که مکان درطول هفته باز است.

TimePeriod

نشان‌دهنده بازه زمانی‌ای است که کسب‌وکار باز است، از روز/ ساعت باز شدن مشخص‌شده شروع می‌شود و در روز/ ساعت بسته شدن مشخص‌شده به‌پایان می‌رسد. زمان بسته شدن باید بعداز زمان باز شدن باشد، مثلاً دیرتر در همان روز یا در روز بعد.

نمایش JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
فیلدها
openDay

enum (DayOfWeek)

الزامی. day of the week را که این دوره در آن شروع می‌شود نشان می‌دهد.
openTime

object (TimeOfDay)

الزامی. مقادیر معتبر 00:00-24:00 است که 24:00 نشان‌دهنده نیمه‌شب در پایان فیلد روز مشخص‌شده است. توجه: در نگاشت Proto3 JSON، مقادیر صفر پیش‌فرض (00:00) حذف می‌شوند و {} برای openTime تولید می‌شود.
closeDay

enum (DayOfWeek)

الزامی. day of the week را که این دوره در آن به‌پایان می‌رسد نشان می‌دهد.
closeTime

object (TimeOfDay)

الزامی. مقادیر معتبر 00:00-24:00 است که 24:00 نشان‌دهنده نیمه‌شب در پایان فیلد روز مشخص‌شده است. توجه: در نگاشت Proto3 JSON، مقادیر صفر پیش‌فرض (00:00) حذف می‌شوند و {} برای closeTime تولید می‌شود.

SpecialHours

نشان‌دهنده مجموعه‌ای از دوره‌های زمانی است که ساعت کاری مکان با ساعت کاری معمول کسب‌وکار متفاوت است.

نمایش JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
فیلدها
specialHourPeriods[]

object (SpecialHourPeriod)

الزامی. فهرستی از استثناهای ساعت کاری معمول کسب‌وکار.

SpecialHourPeriod

نشان‌دهنده یک دوره زمانی است که ساعت کاری مکان با ساعت کاری عادی کسب‌وکار متفاوت است. دوره ساعت کاری ویژه باید نشان‌دهنده محدوده‌ای کمتر از ۲۴ ساعت باشد. ‫openTime و startDate باید قبل‌از closeTime و endDate باشند. closeTime و endDate می‌توانند تا ساعت ۱۱:۵۹ صبح روز بعداز startDate مشخص‌شده تمدید شوند. برای مثال، ورودی‌های زیر معتبر هستند:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

ورودی‌های زیر معتبر نیست:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
نمایش JSON 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
فیلدها
startDate

object (Date)

الزامی. تاریخ تقویمی که این دوره ساعت ویژه در آن شروع می‌شود.
openTime

object (TimeOfDay)

اختیاری. مقادیر معتبر 00:00-24:00 است که 24:00 نشان‌دهنده نیمه‌شب در پایان فیلد روز مشخص‌شده است. اگر closed نادرست باشد، باید مشخص شود.
endDate

object (Date)

اختیاری. تاریخ تقویمی که این دوره ساعت ویژه در آن به‌پایان می‌رسد. اگر فیلد endDate تنظیم نشده باشد، به‌طور پیش‌فرض روی تاریخ مشخص‌شده در startDate تنظیم می‌شود. اگر تنظیم شود، این فیلد باید برابر با startDate یا حداکثر ۱ روز بعداز آن باشد.
closeTime

object (TimeOfDay)

اختیاری. مقادیر معتبر 00:00-24:00 است که 24:00 نشان‌دهنده نیمه‌شب در پایان فیلد روز مشخص‌شده است. اگر closed نادرست باشد، باید مشخص شود.
closed

boolean

اختیاری. اگر درست باشد، endDate، openTime، و closeTime نادیده گرفته می‌شوند و تاریخ مشخص‌شده در startDate به‌عنوان بسته بودن مکان در کل روز درنظر گرفته می‌شود.

ServiceAreaBusiness

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

نمایش JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
فیلدها
businessType

enum (BusinessType)

الزامی. [نوع] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] کسب‌وکار منطقه خدماتی را نشان می‌دهد.
places

object (Places)

اختیاری. منطقه‌ای که این کسب‌وکار به آن خدمات ارائه می‌دهد و ازطریق مجموعه‌ای از مکان‌ها تعریف شده است.
regionCode

string

تغییرناپذیر. کد منطقه CLDR کشور/منطقه‌ای که این کسب‌وکار با منطقه خدماتی در آن مستقر است. برای جزئیات، به http://cldr.unicode.org/ و http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: «CH» برای سوئیس.

این فیلد برای کسب‌وکارهای CUSTOMER_LOCATION_ONLY الزامی است و درغیراین‌صورت نادیده گرفته می‌شود.

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

اگر این مکان پس‌از ایجاد به درستی‌سنجی نیاز داشته باشد، نشانی ارائه‌شده برای اهداف درستی‌سنجی باید در این منطقه واقع شده باشد و مالک کسب‌وکار یا نماینده مجاز او باید بتواند در نشانی ارائه‌شده برای درستی‌سنجی، نامه پستی دریافت کند.

BusinessType

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

شمارشی‌ها
BUSINESS_TYPE_UNSPECIFIED فقط خروجی. مشخص نشده است.
CUSTOMER_LOCATION_ONLY فقط در منطقه اطراف خدمات ارائه می‌دهد (نه در نشانی کسب‌وکار). اگر کسب‌وکاری از CUSTOMER_AND_BUSINESS_LOCATION به CUSTOMER_LOCATION_ONLY به‌روزرسانی می‌شود، به‌روزرسانی مکان باید شامل ماسک فیلد storefrontAddress باشد و فیلد را روی خالی تنظیم کند.
CUSTOMER_AND_BUSINESS_LOCATION در نشانی کسب‌وکار و مناطق اطراف خدمات ارائه می‌کند.

مکان‌ها

اتحاد مناطقی را که با مجموعه‌ای از مکان‌ها نشان داده شده است تعریف می‌کند.

نمایش JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
فیلدها
placeInfos[]

object (PlaceInfo)

اختیاری. مناطقی که با شناسه مکان نشان داده می‌شوند. محدود به حداکثر ۲۰ مکان.

PlaceInfo

منطقه‌ای را تعریف می‌کند که با شناسه مکان نشان داده می‌شود.

نمایش JSON 
{
  "placeName": string,
  "placeId": string
}
فیلدها
placeName

string

الزامی. نام بومی‌سازی‌شده مکان. به‌عنوان مثال، Scottsdale, AZ.
placeId

string

الزامی. شناسه مکان. باید با منطقه‌ای مطابقت داشته باشد. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

اطلاعات تکمیلی که در AdWords نشان داده می‌شود.

نمایش JSON 
{
  "adPhone": string
}
فیلدها
adPhone

string

الزامی. شماره تلفن جایگزینی که به‌جای شماره تلفن اصلی مکان در افزونه‌های مکان AdWords نمایش داده می‌شود.

OpenInfo

اطلاعات مربوط به وضعیت باز بودن کسب‌وکار.

نمایش JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
فیلدها
status

enum (OpenForBusiness)

الزامی. نشان می‌دهد که آیا «مکان» درحال‌حاضر برای کسب‌وکار باز است یا نه. همه مکان‌ها به‌طور پیش‌فرض باز هستند، مگراینکه به‌روزرسانی شوند و بسته شوند.
canReopen

boolean

فقط خروجی. نشان می‌دهد که آیا این کسب‌وکار واجدشرایط بازگشایی است یا نه.
openingDate

object (Date)

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

OpenForBusiness

وضعیت مکان را نشان می‌دهد.

شمارشی‌ها
OPEN_FOR_BUSINESS_UNSPECIFIED مشخص نشده است.
OPEN نشان می‌دهد که مکان باز است.
CLOSED_PERMANENTLY نشان می‌دهد که مکان برای همیشه بسته شده است.
CLOSED_TEMPORARILY نشان می‌دهد که مکان موقتاً بسته شده است.

فراداده

اطلاعات اضافی درباره مکان که کاربر نمی‌تواند ویرایش کند.

نمایش JSON 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
فیلدها
hasGoogleUpdated

boolean

فقط خروجی. نشان می‌دهد که آیا شناسه مکان مرتبط با این مکان به‌روزرسانی‌هایی دارد که باید توسط مشتری به‌روزرسانی یا رد شود. اگر این مقدار بولی تنظیم شده باشد، باید روش getGoogleUpdated را فراخوانی کنید تا اطلاعاتی را که باید درستی‌سنجی شود جستجو کنید.
hasPendingEdits

boolean

فقط خروجی. نشان می‌دهد که آیا هیچ‌کدام از ویژگی‌های این «مکان» در وضعیت ویرایش معلقهستند یا نه.
canDelete

boolean

فقط خروجی. نشان می‌دهد که آیا مکان را می‌توان بااستفاده از API حذف کرد یا نه.
canOperateLocalPost
(deprecated)

boolean

فقط خروجی. منسوخ‌شده: این فیلد دیگر درج نمی‌شود و در نسخه‌های آتی برداشته خواهد شد.
canModifyServiceList

boolean

فقط خروجی. نشان می‌دهد که آیا فهرستگان می‌تواند فهرست خدمات را اصلاح کند یا نه.
canHaveFoodMenus

boolean

فقط خروجی. نشان می‌دهد که آیا فهرستگان واجدشرایط منو غذا است یا نه.
canOperateHealthData

boolean

فقط خروجی. نشان می‌دهد که آیا مکان می‌تواند روی داده‌های «سلامتی» عمل کند یا نه.
canOperateLodgingData

boolean

فقط خروجی. نشان می‌دهد که آیا مکان می‌تواند روی داده‌های «اقامتگاه» کار کند یا نه.
placeId

string

فقط خروجی. اگر این مکان در Google Maps نشان داده شود، این فیلد با شناسه مکان برای این مکان پر می‌شود. این شناسه را می‌توان در میاناهای برنامه‌سازی کاربردی مختلف Places استفاده کرد.

این فیلد را می‌توان درطول تماس‌های «ایجاد» تنظیم کرد، اما برای «به‌روزرسانی» نمی‌توان.
duplicateLocation

string

فقط خروجی. منبع مکانی که این مکان تکراری آن است.
mapsUri

string

فقط خروجی. پیوندی به مکان در Maps.
newReviewUri

string

فقط خروجی. پیوند به صفحه‌ای در «جستجوی Google» که مشتری می‌تواند در آنجا برای مکان مرور بنویسد.
canHaveBusinessCalls

boolean

فقط خروجی. نشان می‌دهد که آیا فهرستگان برای تماس‌های کسب‌وکار واجدشرایط است یا نه.
hasVoiceOfMerchant

boolean

فقط خروجی. نشان می‌دهد که آیا فهرستگان «صدای فروشنده» دارد یا نه. اگر این مقدار بولی نادرست باشد، باید با API‏ locations.getVoiceOfMerchantState تماس بگیرید تا جزئیات مربوط به اینکه چرا «صدای فروشنده» ندارند را دریافت کنید.
isParticularlyPersonalPlace

boolean

فقط خروجی. نشان می‌دهد که آیا مکان به‌عنوان مکان شخصی خاص طبقه‌بندی شده است یا نه. این یعنی محدودیت‌هایی برای ویژگی‌های «سابقه مکان» وجود دارد. اگر فکر می‌کنید اشتباهی رخ داده است، مقاله مرکز راهنمایی را ببینید.

نمایه

همه اطلاعات مربوط به نمایه مکان.

نمایش JSON 
{
  "description": string
}
فیلدها
description

string

الزامی. شرح مکان با صدای خودتان که هیچ‌کس دیگری نمی‌تواند آن را ویرایش کند.

RelationshipData

اطلاعات همه مکان‌های اصلی و فرعی مرتبط با این مکان.

نمایش JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
فیلدها
parentLocation

object (RelevantLocation)

اختیاری. مکان اصلی که این مکان با آن ارتباط دارد.
childrenLocations[]

object (RelevantLocation)

اختیاری. فهرست مکان‌های فرزند که این مکان با آن‌ها رابطه دارد.
parentChain

string

اختیاری. نام منبع «زنجیره» که این مکان عضو آن است. [نحوه پیدا کردن شناسه زنجیره] [Locations.SearchChains]

RelevantLocation

اطلاعات درباره مکان دیگری که به مکان فعلی مربوط است. رابطه می‌تواند یکی از DEPARTMENT_OF یا INDEPENDENT_ESTABLISHMENT_OF باشد و مکان مشخص‌شده در اینجا می‌تواند در هریک از طرفین (مادر/فرزند) مکان باشد.

نمایش JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
فیلدها
placeId

string

الزامی. مکان طرف دیگر رابطه را با شناسه مکان آن مشخص کنید.
relationType

enum (RelationType)

الزامی. نوع رابطه.

RelationType

نوع روابطی که باید مشخص شود.

شمارشی‌ها
RELATION_TYPE_UNSPECIFIED نوع نامشخص است.
DEPARTMENT_OF این نشان‌دهنده رابطه بین ۲ مکان است که یک منطقه فیزیکی، یک نمانام/مدیریت/سازمان بالادستی مشترک دارند، اما مشخصه‌های کلیدی متفاوتی مانند ساعت کاری فروشگاه یا شماره تلفن دارند. برای مثال، «داروخانه کاستکو» بخشی از «عمده‌فروشی کاستکو» است.
INDEPENDENT_ESTABLISHMENT_IN این نشان‌دهنده مواردی است که ۲ مکان در یک مکان فیزیکی قرار دارند، اما متعلق به شرکت‌های مختلفی هستند (مثلاً Starbucks در Safeway، فروشگاه‌ها در مرکز خرید).

MoreHours

دوره‌های زمانی که طی آن مکان برای انواع خاصی از کسب‌وکار باز است.

نمایش JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
فیلدها
hoursTypeId

string

الزامی. نوع ساعت کاری. مشتریان باید با {#link businessCategories:BatchGet} تماس بگیرند تا انواع ساعت‌های پشتیبانی‌شده را برای دسته‌های مکان‌هایشان دریافت کنند.
periods[]

object (TimePeriod)

الزامی. مجموعه‌ای از زمان‌هایی که این مکان باز است. هر دوره نشان‌دهنده بازه‌ای از ساعت‌ها است که مکان درطول هفته باز است.

ServiceItem

پیامی که یک مورد خدماتی را شرح می‌دهد. از این ویژگی برای توصیف نوع خدماتی که فروشنده ارائه می‌دهد استفاده می‌شود. برای مثال، کوتاه کردن مو می‌تواند یک سرویس باشد.

نمایش JSON 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
فیلدها
price

object (Money)

اختیاری. قیمت پولی مورد خدمات را نشان می‌دهد. توصیه می‌کنیم هنگام درج قیمت، currencyCode و units تنظیم شود. این به‌عنوان قیمت ثابت برای مورد سرویس درنظر گرفته خواهد شد.
یکی از فیلدهای زیر باید همیشه تنظیم شود. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
structuredServiceItem

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

اختیاری. این فیلد برای داده‌های خدمات قالب آزاد تنظیم خواهد شد.
پایان فیلدهای متقابلاً انحصاری.

StructuredServiceItem

نشان‌دهنده سرویس ساختاریافته‌ای است که فروشنده ارائه می‌دهد. برای مثال: toilet_installation.

نمایش JSON 
{
  "serviceTypeId": string,
  "description": string
}
فیلدها
serviceTypeId

string

الزامی. فیلد serviceTypeId شناسه یکتایی است که Google ارائه کرده است و در ServiceType یافت می‌شود. این اطلاعات را سرویس rpc BatchGetCategories ارائه کرده است.
description

string

اختیاری. شرح مورد خدمات ساختاریافته. حد نویسه ۳۰۰ است.

FreeFormServiceItem

نشان‌دهنده خدمات قالب آزادی است که فروشنده ارائه می‌دهد. این‌ها سرویس‌هایی هستند که به‌عنوان بخشی از داده‌های سرویس ساختار ما نمایش داده نمی‌شوند. فروشنده نام این سرویس‌ها را بااستفاده از سطح geomerchant به‌صورت دستی وارد می‌کند.

نمایش JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
فیلدها
category

string

الزامی. این فیلد نشان‌دهنده نام دسته (یعنی شناسه ثابت دسته) است. category و serviceTypeId باید با ترکیب‌های احتمالی ارائه‌شده در پیام Category مطابقت داشته باشند.
label

object (Label)

الزامی. برچسب‌های دارای برچسب زبان برای مورد. توصیه می‌کنیم نام موارد ۱۴۰ نویسه یا کمتر و شرح‌ها ۲۵۰ نویسه یا کمتر باشد. این فیلد فقط باید زمانی تنظیم شود که ورودی یک مورد خدمات سفارشی باشد. انواع خدمات استانداردشده باید بااستفاده از serviceTypeId به‌روزرسانی شوند.

برچسب

برچسبی که هنگام نمایش فهرست قیمت، بخش، یا مورد استفاده می‌شود.

نمایش JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
فیلدها
displayName

string

الزامی. نام نمایشی برای فهرست قیمت، بخش، یا گزینه.
description

string

اختیاری. شرح فهرست قیمت، بخش، یا مورد.
languageCode

string

اختیاری. کد زبان BCP-47 که این رشته‌ها برای آن اعمال می‌شود. فقط یک مجموعه برچسب را می‌توان برای هر زبان تنظیم کرد.

روش‌ها

create

 «مکان» جدیدی ایجاد می‌کند که کاربر واردشده به سیستم مالک آن خواهد بود.

list

 مکان‌های حساب مشخص‌شده را فهرست می‌کند.