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

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

PostalAddress

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

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

توصیه درباره وارد کردن یا ویرایش نشانی:

  • از ابزاره نشانی آماده بین‌المللی‌سازی مثل https://github.com/google/libaddressinput استفاده کنید.
  • عناصر میانای کاربر برای ورودی یا ویرایش فیلدها نباید به کاربران خارج از کشورهایی که آن فیلد استفاده می‌شود ارائه شود.

برای راهنمایی بیشتر درباره نحوه استفاده از این طرح‌واره، به https://support.google.com/business/answer/6397478 مراجعه کنید.

نمایش JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
فیلدها
revision

integer

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

همه بازبینی‌های جدید باید با بازبینی‌های قدیمی سازگار با نسخه قدیمی باشند.
regionCode

string

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

string

اختیاری. کد زبان BCP-47 محتوای این نشانی (درصورت مشخص بودن). این زبان اغلب زبان واسط کاربر فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورداستفاده در کشور/ منطقه نشانی یا معادل‌های نویسه‌گردانی‌شده آن‌ها مطابقت داشته باشد. این امر می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر هیچ اعتبارسنجی یا عملیات غیرقالب‌بندی دیگری تأثیر نخواهد گذاشت.

اگر این مقدار مشخص نیست، باید حذف شود (به‌جای اینکه مقدار پیش‌فرض احتمالاً نادرستی مشخص شود).

مثال: «zh-Hant»،‏ «ja»،‏ «ja-Latn»،‏ «en».
postalCode

string

اختیاری. کد پستی نشانی. همه کشورها از کد پستی استفاده نمی‌کنند یا وجود آن را الزامی نمی‌دانند، اما در کشورهایی که استفاده می‌شود، ممکن است اعتبارسنجی اضافی با بخش‌های دیگر نشانی را فعال کند (برای مثال، اعتبارسنجی ایالت یا کد پستی در ایالات متحده).
sortingCode

string

اختیاری. کد مرتب‌سازی اضافی، مختص کشور. این مورد در اکثر مناطق استفاده نمی‌شود. در جاهایی که استفاده می‌شود، مقدار یا رشته‌ای مثل «CEDEX» است که به‌طور اختیاری با عددی دنبال می‌شود (برای مثال، «CEDEX 7»)، یا فقط عددی به‌تنهایی است که نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر منطقه تحویل» (مالاوی)، یا «نشانگر اداره پست» (ساحل عاج) است.
administrativeArea

string

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

string

اختیاری. عموماً به بخش شهر یا شهرستان نشانی اشاره دارد. مثال: شهر در ایالات متحده، بخش در ایتالیا، شهر پستی در بریتانیا. در مناطقی از جهان که محله‌ها به‌خوبی تعریف نشده‌اند یا به‌خوبی در این ساختار قرار نمی‌گیرند، locality را خالی بگذارید و از addressLines استفاده کنید.
sublocality

string

اختیاری. محله نشانی. برای مثال، این می‌تواند محله، بخش، یا منطقه باشد.
addressLines[]

string

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

چون مقادیر در addressLines اطلاعات نوع ندارند و گاهی ممکن است حاوی چندین مقدار در یک فیلد باشند (برای مثال، «Austin, TX»)، مهم است که ترتیب خطوط واضح باشد. ترتیب خطوط نشانی باید «ترتیب پاکت» برای کشور یا منطقه نشانی باشد. در جاهایی که این مورد می‌تواند متفاوت باشد (برای مثال، ژاپن)، از address_language برای صریح کردن آن استفاده می‌شود (برای مثال، «ja» برای ترتیب بزرگ به کوچک و «ja-Latn» یا «en» برای کوچک به بزرگ). به این ترتیب، می‌توان خاص‌ترین خط نشانی را براساس زبان انتخاب کرد.

حداقل نمایش ساختاری مجاز برای نشانی شامل regionCode است و همه اطلاعات باقی‌مانده در addressLines قرار می‌گیرد. قالب‌بندی چنین نشانی‌ای به‌صورت بسیار تقریبی بدون زمین‌کدیابی امکان‌پذیر است، اما تا زمانی که حداقل بخشی‌از آن حل نشود، هیچ استدلال معنایی درباره هیچ‌یک از مؤلفه‌های نشانی نمی‌توان انجام داد.

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

string

اختیاری. گیرنده در نشانی. این فیلد ممکن است تحت شرایط خاصی حاوی اطلاعات چندخطی باشد. برای مثال، ممکن است حاوی اطلاعات «به‌دست» باشد.
organization

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 تولید می‌شود.

DayOfWeek

نشان‌دهنده روزی از هفته است.

شمارشی‌ها
DAY_OF_WEEK_UNSPECIFIED روز هفته مشخص نشده است.
MONDAY ﺪﻮﺷﻨﺑﮫ
TUESDAY سه‌شنبه
WEDNESDAY چهارشنبه
THURSDAY پنج‌شنبه
FRIDAY جمعه
SATURDAY شنبه
SUNDAY یک‌شنبه

TimeOfDay

نشان‌دهنده زمان روز است. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده‌اند. یک API ممکن است ثانیه‌های کبیسه را مجاز کند. انواع مرتبط google.type.Date و google.protobuf.Timestamp هستند.

نمایش JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
فیلدها
hours

integer

ساعت‌های روز در قالب ۲۴ ساعته. باید بزرگ‌تر یا مساوی ۰ و معمولاً کوچک‌تر یا مساوی ۲۳ باشد. یک API ممکن است مقدار «24:00:00» را برای سناریوهایی مانند زمان بسته شدن کسب‌وکار مجاز بداند.
minutes

integer

دقیقه‌های یک ساعت. باید بزرگ‌تر یا مساوی ۰ و کوچک‌تر یا مساوی ۵۹ باشد.
seconds

integer

ثانیه‌های یک دقیقه. باید بزرگ‌تر یا مساوی ۰ و معمولاً کوچک‌تر یا مساوی ۵۹ باشد. اگر API ثانیه کبیسه را مجاز کند، ممکن است مقدار ۶۰ را مجاز کند.
nanos

integer

کسری از ثانیه، برحسب نانوثانیه. باید بزرگ‌تر یا مساوی ۰ و کوچک‌تر یا مساوی ۹۹۹٬۹۹۹٬۹۹۹ باشد.

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

تاریخ

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

  • تاریخ کامل، با مقادیر غیرصفر سال، ماه، و روز.
  • ماه و روز، با سال صفر (برای مثال، سالگرد).
  • سال به‌تنهایی، با ماه صفر و روز صفر.
  • سال و ماه، با روز صفر (برای مثال، تاریخ انقضای کارت اعتباری).

انواع مرتبط:

نمایش JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
فیلدها
year

integer

سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا ۰ برای مشخص کردن تاریخ بدون سال.
month

integer

ماهی از سال. باید از ۱ تا ۱۲ باشد، یا ۰ برای مشخص کردن سال بدون ماه و روز.
day

integer

روز ماه. باید از ۱ تا ۳۱ و برای سال و ماه معتبر باشد، یا ۰ باشد تا سال به‌تنهایی یا سال و ماه را بدون اهمیت داشتن روز مشخص کند.

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 نمایش داده می‌شود.

LatLng

شیئی که نشان‌دهنده جفت عرض جغرافیایی/طول جغرافیایی است. این مقدار به‌صورت جفت عدد اعشاری با دقت مضاعف بیان می‌شود که نشان‌دهنده درجه عرض جغرافیایی و درجه طول جغرافیایی است. مگر اینکه خلاف آن مشخص شده باشد، این شیء باید با استاندارد WGS84 مطابقت داشته باشد. مقادیر باید در محدوده نرمال‌شده باشد.

نمایش JSON 
{
  "latitude": number,
  "longitude": number
}
فیلدها
latitude

number

عرض جغرافیایی به درجه. باید در محدوده [-90.0, +90.0] باشد.
longitude

number

طول جغرافیایی برحسب درجه. باید در محدوده [-180.0, +180.0] باشد.

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 categories.batchGet ارائه کرده است.
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 که این رشته‌ها برای آن اعمال می‌شود. فقط یک مجموعه برچسب را می‌توان برای هر زبان تنظیم کرد.

پول

نشان‌دهنده مبلغی پول با نوع واحد پول آن است.

نمایش JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
فیلدها
currencyCode

string

کد ارز سه‌حرفی تعریف‌شده در ISO 4217.
units

string (int64 format)

واحدهای کامل مبلغ. برای مثال، اگر currencyCode برابر با "USD" باشد، ۱ واحد برابر با یک دلار امریکا است.
nanos

integer

تعداد واحدهای نانو (۱۰^-۹) مبلغ. مقدار باید بین ۹۹۹٬۹۹۹٬۹۹۹- و ۹۹۹٬۹۹۹٬۹۹۹+ باشد و می‌تواند این دو عدد را نیز دربر بگیرد. اگر units مثبت باشد، nanos باید مثبت یا صفر باشد. اگر units صفر باشد، nanos می‌تواند مثبت، صفر، یا منفی باشد. اگر units منفی باشد، nanos باید منفی یا صفر باشد. برای مثال، ۱٫۷۵- دلار به‌صورت units=-۱ و nanos=-۷۵۰٬۰۰۰٬۰۰۰ نشان داده می‌شود.

روش‌ها

create

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

list

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