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 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 )

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

شماره تلفن ها

مجموعه ای از شماره تلفن های کسب و کار. در طول به روز رسانی، هر دو قسمت باید تنظیم شوند. مشتریان ممکن است فقط شماره تلفن های اصلی یا اضافی را با استفاده از ماسک به روز رسانی به روز نکنند. قالب تلفن بین‌المللی ترجیح داده می‌شود، مانند «0132 415 555+1»، بیشتر در ( 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 )

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

نوع سرویس

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

نمایندگی 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

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

آدرس پستی

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

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

توصیه‌هایی در مورد ورودی/ویرایش آدرس: - از ویجت آدرس آماده بین‌المللی‌سازی مانند 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 . این باید روی 0 تنظیم شود که آخرین ویرایش است.

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

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

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

sublocality

string

اختیاری. موقعیت فرعی آدرس به عنوان مثال، این می تواند محله، محله، منطقه باشد.

addressLines[]

string

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

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

حداقل نمایش ساختاری مجاز یک آدرس شامل یک RegionCode با تمام اطلاعات باقیمانده در خطوط آدرس است. قالب بندی چنین آدرسی تقریباً بدون کدگذاری جغرافیایی امکان پذیر است، اما هیچ استدلال معنایی در مورد هیچ یک از اجزای آدرس نمی توان تا حداقل تا حدی حل شود.

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

recipients[]

string

اختیاری. گیرنده در آدرس این فیلد تحت شرایط خاصی ممکن است حاوی اطلاعات چند خطی باشد. به عنوان مثال، ممکن است حاوی اطلاعات "مراقبت از" باشد.

organization

string

اختیاری. نام سازمان در آدرس.

ساعات کاری

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

نمایندگی JSON
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
زمینه های
periods[]

object ( 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 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است.

closeDay

enum ( DayOfWeek )

ضروری. day of the week را نشان می دهد که این دوره به پایان می رسد.

closeTime

object ( TimeOfDay )

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

روز هفته

یک روز از هفته را نشان می دهد.

Enums
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

ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند.

minutes

integer

دقیقه از ساعت روز. باید از 0 تا 59 باشد.

seconds

integer

ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند.

nanos

integer

کسری از ثانیه در نانوثانیه. باید از 0 تا 999,999,999 باشد.

ساعات ویژه

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

نمایندگی JSON
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
زمینه های
specialHourPeriods[]

object ( SpecialHourPeriod )

ضروری. فهرستی از استثنائات مربوط به ساعات کاری عادی کسب و کار.

Special HourPeriod

نشان دهنده یک دوره زمانی است که ساعات عملیاتی یک مکان با ساعات کاری عادی آن متفاوت است. یک بازه ساعتی خاص باید محدوده ای کمتر از 24 ساعت را نشان دهد. openTime و startDate باید قبل از closeTime و endDate باشند. closeTime و endDate می‌تواند تا ساعت 11:59 صبح روز بعد از 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 را تعیین کنید. در صورت تنظیم، این فیلد باید برابر یا حداکثر 1 روز پس از 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

سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.

month

integer

ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.

day

integer

روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

Service AreaBusiness

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

نمایندگی 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 ضروری است و در غیر این صورت نادیده گرفته می شود.

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

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

نوع کسب و کار

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

Enums
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 )

مناطق نشان داده شده توسط شناسه مکان. محدود به حداکثر 20 مکان.

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

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

Enums
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
}
زمینه های
hasGoogleUpdated

boolean

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

hasPendingEdits

boolean

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

canDelete

boolean

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

canOperateLocalPost

boolean

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

canModifyServiceList

boolean

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

canHaveFoodMenus

boolean

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

canOperateHealthData

boolean

فقط خروجی نشان می دهد که آیا مکان می تواند بر روی داده های Health کار کند یا خیر.

canOperateLodgingData

boolean

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

placeId

string

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

این فیلد را می توان در حین ایجاد تماس ها تنظیم کرد، اما نه برای به روز رسانی.

duplicateLocation

string

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

mapsUri

string

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

newReviewUri

string

فقط خروجی پیوندی به صفحه‌ای در جستجوی Google که در آن مشتری می‌تواند نظری برای موقعیت مکانی بگذارد.

canHaveBusinessCalls

boolean

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

hasVoiceOfMerchant

boolean

فقط خروجی نشان می دهد که آیا فهرست دارای Voice of Merchant است یا خیر. اگر این بولی نادرست است، باید با locations.getVoiceOfMerchantState API تماس بگیرید تا جزئیات مربوط به عدم وجود Voice of Merchant را دریافت کنید.

مشخصات

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

نمایندگی 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 )

ضروری. نوع رابطه.

نوع رابطه

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

Enums
RELATION_TYPE_UNSPECIFIED تایپ نامشخص
DEPARTMENT_OF این نشان‌دهنده رابطه بین ۲ مکان است که در یک منطقه فیزیکی، یک برند/مدیریت بالا/سازمان مشترک، اما با ویژگی‌های کلیدی مختلف مانند ساعات کاری فروشگاه یا شماره تلفن مشترک هستند. به عنوان مثال، Costco Pharmacy یک بخش در Costco Wholesale است.
INDEPENDENT_ESTABLISHMENT_IN این نشان‌دهنده مواردی است که در آن 2 مکان در یک مکان فیزیکی، اما از شرکت‌های مختلف قرار دارند (مانند استارباکس در یک Safeway، فروشگاه‌ها در یک مرکز خرید).

بیشتر ساعت

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

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

string

ضروری. نوع ساعت مشتریان باید با {#link businessCategories:BatchGet} تماس بگیرند تا انواع ساعت های پشتیبانی شده را برای دسته بندی مکان هایشان دریافت کنند.

periods[]

object ( TimePeriod )

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

Service Item

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

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

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
زمینه های
price

object ( Money )

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

service_item_info میدانی اتحادیه. یکی از فیلدهای زیر باید همیشه تنظیم شود. service_item_info تنها می تواند یکی از موارد زیر باشد:
structuredServiceItem

object ( StructuredServiceItem )

اختیاری. این فیلد موردی از داده های سرویس های ساخت یافته است.

freeFormServiceItem

object ( FreeFormServiceItem )

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

StructuredServiceItem

نشان دهنده یک سرویس ساختاریافته ارائه شده توسط تاجر است. به عنوان مثال: توالت_نصب.

نمایندگی JSON
{
  "serviceTypeId": string,
  "description": string
}
زمینه های
serviceTypeId

string

ضروری. فیلد serviceTypeId یک شناسه منحصر به فرد ارائه شده توسط Google است که در ServiceType یافت می شود. این اطلاعات توسط سرویس های categories.batchGet rpc ارائه شده است.

description

string

اختیاری. شرح آیتم سرویس ساخت یافته محدودیت کاراکتر 300 است.

FreeFormServiceItem

نشان دهنده یک سرویس رایگان است که توسط تاجر ارائه می شود. اینها خدماتی هستند که به عنوان بخشی از داده های سرویس ساختار ما در معرض نمایش قرار نمی گیرند. تاجر به صورت دستی نام چنین خدماتی را از طریق یک سطح ژئومرچنت وارد می کند.

نمایندگی JSON
{
  "category": string,
  "label": {
    object (Label)
  }
}
زمینه های
category

string

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

label

object ( Label )

ضروری. برچسب‌های برچسب‌گذاری شده با زبان برای مورد. توصیه می کنیم نام آیتم ها 140 نویسه یا کمتر و توضیحات 250 نویسه یا کمتر باشد. این فیلد فقط در صورتی باید تنظیم شود که ورودی یک مورد سرویس سفارشی باشد. انواع خدمات استاندارد شده باید از طریق 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" باشد، 1 واحد یک دلار آمریکا است.

nanos

integer

تعداد نانو (10^-9) واحد مقدار. مقدار باید بین -999,999,999 و +999,999,999 باشد. اگر units مثبت باشد، nanos باید مثبت یا صفر باشد. اگر units صفر باشد، nanos می تواند مثبت، صفر یا منفی باشد. اگر units منفی باشد، nanos باید منفی یا صفر باشد. به عنوان مثال 1.75-$ به صورت units =-1 و nanos =-750,000,000 نشان داده می شود.

مواد و روش ها

create

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

list

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