Package google.mybusiness.businessinformation.v1

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

ساعات کاری

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

زمینه های

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

periods[]

TimePeriod

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

دسته بندی ها

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

زمینه های

زمینه های
`primary_category`	`Category` ضروری. دسته‌ای که به بهترین شکل کسب‌وکار اصلی این مکان را توصیف می‌کند.
`additional_categories[]`	`Category` اختیاری. دسته های اضافی برای توصیف کسب و کار شما. دسته‌ها به مشتریان شما کمک می‌کنند تا نتایج دقیق و خاصی را برای خدماتی که به آن‌ها علاقه‌مند هستند بیابند. برای اینکه اطلاعات کسب‌وکارتان دقیق و زنده بماند، مطمئن شوید که از کمترین دسته‌بندی ممکن برای توصیف کلی کسب‌وکار اصلی خود استفاده می‌کنید. دسته بندی هایی را انتخاب کنید که تا حد امکان خاص هستند، اما نماینده کسب و کار اصلی شما هستند.

primary_category

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

additional_categories[]

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

دسته بندی

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

زمینه های
`name`	`string` ضروری. شناسه پایدار (ارائه شده توسط Google) برای این دسته. مقدار باید هنگام تغییر دسته (هنگام ایجاد یا به روز رسانی یک مکان) مشخص شود.
`display_name`	`string` فقط خروجی نام قابل خواندن برای انسان این دسته. این هنگام خواندن مکان تنظیم می شود. هنگام تغییر مکان، `category_id` باید تنظیم شود.
`service_types[]`	`ServiceType` فقط خروجی فهرستی از انواع خدماتی که برای این دسته کسب و کار موجود است.
`more_hours_types[]`	`MoreHoursType` فقط خروجی انواع ساعات بیشتری برای این دسته کسب و کار موجود است.

View Category

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

Enums
`CATEGORY_VIEW_UNSPECIFIED`	مشخص نشده است، معادل CATEGORY_METADATA_ONLY.
`BASIC`	پاسخ سرور فقط شامل فیلدهای دسته display_name، category_id و language_code خواهد بود. فیلدهای مربوط به فراداده نوع خدمات را حذف می کند.
`FULL`	تمام فیلدهای پاسخ را برمی گرداند.

زنجیر

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

زمینه های
`name`	`string` ضروری. نام منبع زنجیره، با قالب `chains/{chain_id}` .
`chain_names[]`	`ChainName` نام های زنجیره ای
`websites[]`	`ChainUri` وب سایت های زنجیره ای
`location_count`	`int32` تعداد مکان هایی که بخشی از این زنجیره هستند.

نام زنجیره ای

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

زمینه های

زمینه های
`display_name`	`string` نام نمایشی این زنجیره
`language_code`	`string` کد BCP 47 زبان نام.

display_name

string

نام نمایشی این زنجیره

language_code

string

کد BCP 47 زبان نام.

ChainUri

آدرس اینترنتی مورد استفاده در هنگام نمایش زنجیره.

زمینه های

زمینه های
`uri`	`string` uri برای این زنجیره.

uri

string

uri برای این زنجیره.

CreateLocationRequest

درخواست پیام برای Locations.CreateLocation.

زمینه های
`parent`	`string` ضروری. نام حسابی که در آن این مکان ایجاد می شود.
`location`	`Location` ضروری. فراداده مکان جدید
`validate_only`	`bool` اختیاری. اگر درست باشد، درخواست بدون ایجاد مکان واقعی تأیید می شود.
`request_id`	`string` اختیاری. شناسه درخواست منحصر به فرد برای سرور برای شناسایی درخواست های تکراری. ما استفاده از UUID را توصیه می کنیم. حداکثر طول 50 کاراکتر است.

DeleteLocationRequest

درخواست پیام برای Locations.DeleteLocation.

زمینه های

زمینه های
`name`	`string` ضروری. نام مکان برای حذف.

name

string

ضروری. نام مکان برای حذف.

کد خطا

همه کدهای خطا توسط API برگردانده شده اند.

Enums
`ERROR_CODE_UNSPECIFIED`	کد خطا موجود نیست.
`INVALID_ATTRIBUTE_NAME`	یکی از ویژگی های ارائه شده را نمی توان برای این مکان اعمال کرد. فقط ویژگی‌هایی که در پاسخ `ListAttributeMetadata` برگردانده شده‌اند ممکن است در این مکان اعمال شوند. همه نام‌های مشخصه مشکل‌ساز در کلید `attribute_names` در زیر ابرداده بازگردانده می‌شوند.
`ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION`	این خطا زمانی برمی گردد که یک سرویس گیرنده سعی می کند یک مکان را مرتبط کند یا یک ارتباط مکان را در مکانی که در وضعیت تأیید شده است پاک کند.
`ASSOCIATE_LOCATION_INVALID_PLACE_ID`	`place_id` ارائه شده در درخواست `associateLocation` با مکان مطابقت ندارد یا نامعتبر است. مطمئن شوید که `place_id` تنظیم‌شده با یکی از شناسه‌های بازگردانده شده در پاسخ `SearchGoogleLocations` مطابقت دارد.
`LAT_LNG_UPDATES_NOT_PERMITTED`	این پروژه مجاز به به روز رسانی فیلد lat/lng در مکان نیست. می‌توانید lat/lng را با استفاده از عملکرد pin drop در رابط کاربری به‌روزرسانی کنید یا یک آدرس به ما ارائه دهید.
`PO_BOX_IN_ADDRESS_NOT_ALLOWED`	صندوق پستی را نمی توان در آدرس استفاده کرد. کلیدهای فراداده شامل "field_mask" است.
`BLOCKED_REGION`	به دلیل تحریم‌های بین‌المللی که موظف به رعایت آن هستیم، نمی‌توانیم مشاغل این منطقه را بپذیریم. کلیدهای فراداده شامل "field_maks" است.
`MISSING_BOTH_PHONE_AND_WEBSITE`	برای کسب و کارهای CUSTOMER_LOCATION_ONLY یا تلفن یا وب سایت لازم است. کلیدهای فراداده شامل "field_mask" است.
`MISSING_STOREFRONT_ADDRESS_OR_SAB`	همه مکان‌ها باید حداقل یک آدرس ویترین یا یک منطقه خدماتی داشته باشند. کلیدهای فراداده شامل "field_mask" است.
`LAT_LNG_TOO_FAR_FROM_ADDRESS`	جفت طول و عرض جغرافیایی و آدرس خیلی از هم فاصله دارند. کلیدهای فراداده شامل "field_mask" است.
`LAT_LNG_REQUIRED`	منسوخ. جایگزین شده توسط PIN_DROP_REQUIRED. آدرس مشخص شده قابل یافتن نیست. لطفا طول و عرض جغرافیایی ارائه دهید. کلیدهای فراداده شامل "field_mask" است.
`INVALID_CHARACTERS`	کاراکترهای نامعتبر یافت می شوند. کلیدهای فراداده شامل "field_mask" و "invalid_characters" هستند.
`FORBIDDEN_WORDS`	کلمات ممنوعه پیدا می شود. کلیدهای فراداده شامل "field_mask" و "forbidden_words" هستند.
`INVALID_INTERCHANGE_CHARACTERS`	کاراکترهای نامعتبر یافت می شوند. کلیدهای فراداده شامل "field_mask" است.
`FIELDS_REQUIRED_FOR_CATEGORY`	فیلدهای اضافی برای این دسته از مکان مورد نیاز است. کلیدهای فراداده شامل «field_mask»، «value» و «fields_required» هستند.
`STOREFRONT_REQUIRED_FOR_CATEGORY`	دسته کسب و کار شما به مکانی ویترینی نیاز دارد که مشتریان بتوانند از آن بازدید کنند. کلیدهای فراداده شامل "field_mask" است.
`ADDRESS_MISSING_REGION_CODE`	آدرس فاقد منطقه_کد الزامی است. کلیدهای فراداده شامل "field_mask" است.
`ADDRESS_EDIT_CHANGES_COUNTRY`	آدرس را نمی توان به کشور دیگری منتقل کرد. کلیدهای فراداده شامل "field_mask" است.
`SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS`	ساعات کاری ویژه را فقط در صورتی می توان مشخص کرد که مکان دارای ساعات کاری منظم باشد. ابرداده خالی است.
`INVALID_TIME_SCHEDULE`	زمان‌بندی نامعتبر، زمان همپوشانی یا پایان زودتر از زمان شروع است. کلیدهای فراداده شامل "field_mask" است.
`INVALID_HOURS_VALUE`	قالب یا مقدار ساعت نامعتبر است. کلیدهای فراداده شامل "field_mask" است.
`OVERLAPPED_SPECIAL_HOURS`	Special_hours نمی توانند همپوشانی داشته باشند. کلیدهای فراداده شامل "field_mask" است.
`INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY`	دسته اصلی کسب و کار شما از این نوع ساعت پشتیبانی نمی‌کند. کلیدهای فراداده عبارتند از "field_mask" و "incompatible_hours_type".
`DUPLICATE_CHILDREN_LOCATIONS`	مکان‌های_کودک در روابط_داده‌های تکراری. کلیدهای فراداده شامل "field_mask" است.
`INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY`	کسب و کار منطقه خدماتی نمی تواند دسته اصلی انتخاب شده را داشته باشد. کلیدهای فراداده شامل "field_mask" است.
`INVALID_SERVICE_AREA_PLACE_ID`	place_id در service_area نامعتبر است. کلیدهای فراداده شامل "field_mask" و "place_id" هستند.
`INVALID_AREA_TYPE_FOR_SERVICE_AREA`	نوع ناحیه نامعتبر برای service_area. کلیدهای فراداده شامل "field_mask" و "place_id" هستند.
`OPENING_DATE_TOO_FAR_IN_THE_FUTURE`	تاریخ بازگشایی را در عرض یک سال وارد کنید. کلیدهای فراداده شامل "field_mask" است.
`OPENING_DATE_MISSING_YEAR_OR_MONTH`	تاریخ افتتاح باید یک سال یا یک ماه مشخص باشد. کلیدهای فراداده شامل "field_mask" است.
`OPENING_DATE_BEFORE_1AD`	تاریخ افتتاح نمی تواند قبل از 1 بعد از میلاد باشد. کلیدهای فراداده شامل "field_mask" است.
`TOO_MANY_ENTRIES`	تعداد ورودی های این رشته بسیار زیاد است. کلیدهای فراداده شامل "field_mask" و "max_count" هستند.
`INVALID_PHONE_NUMBER`	ورودی شماره تلفن شناسایی نمی شود. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`INVALID_PHONE_NUMBER_FOR_REGION`	شماره تلفن برای منطقه نامعتبر است. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`MISSING_PRIMARY_PHONE_NUMBER`	شماره تلفن اصلی وجود ندارد. کلیدهای فراداده شامل "field_mask" است.
`THROTTLED`	فیلد در حال حاضر به روز نمی شود. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`UNSUPPORTED_POINT_RADIUS_SERVICE_AREA`	مناطق خدمات شعاع نقطه ای دیگر پشتیبانی نمی شوند. کلیدهای فراداده شامل "field_mask" است.
`INVALID_CATEGORY`	شناسه دسته نامعتبر است. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`CANNOT_REOPEN`	کسب و کار نمی تواند بازگشایی شود. کلیدهای فراداده شامل "field_mask" است.
`INVALID_BUSINESS_OPENING_DATE`	تاریخ افتتاح کسب و کار نامعتبر است. کلیدهای فراداده شامل "field_mask" است.
`INVALID_LATLNG`	latlng نامعتبر است. کلیدهای فراداده شامل "field_mask" است.
`PROFILE_DESCRIPTION_CONTAINS_URL`	شرح کسب و کار نباید حاوی URL باشد. کلیدهای فراداده شامل "field_mask" است.
`LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION`	شرح نمایه محل اقامت قابل ویرایش نیست. کلیدهای فراداده شامل "field_mask" است.
`INVALID_URL`	لینک نامعتبر کلیدهای فراداده شامل "field_mask" است.
`INVALID_ADDRESS`	آدرس نامعتبر. کلیدهای فراداده شامل "field_mask" است.
`PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF`	ParentChain نمی تواند خود مکان باشد. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`RELATION_CANNOT_BE_THE_LOCATION_ITSELF`	رابطه نمی تواند خود مکان باشد. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`MISSING_ADDRESS_COMPONENTS`	مقدار از دست رفته برای اجزای آدرس. کلیدهای فراداده شامل "field_mask" است.
`READ_ONLY_ADDRESS_COMPONENTS`	نمی توان اجزای آدرس فقط خواندنی را ویرایش کرد. کلیدهای فراداده شامل "field_mask" است.
`STRING_TOO_LONG`	رشته خیلی طولانی است. کلیدهای فراداده شامل "field_mask" و "max_length" هستند.
`STRING_TOO_SHORT`	رشته خیلی کوتاه است. کلیدهای فراداده عبارتند از "field_mask" و "min_length".
`REQUIRED_FIELD_MISSING_VALUE`	مقدار از دست رفته برای فیلد الزامی. کلیدهای فراداده شامل "field_mask" است.
`ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED`	URL برای یک ارائه دهنده قابل افزودن یا ویرایش نیست. کلیدهای فراداده شامل "ویژگی_نام" است.
`ATTRIBUTE_INVALID_ENUM_VALUE`	مقدار ناشناخته برای ویژگی enum. کلیدهای فراداده شامل "ویژگی_نام" است.
`ATTRIBUTE_NOT_AVAILABLE`	ویژگی مقیاس پذیر برای این مکان معتبر نیست. کلیدهای فراداده شامل ""ویژگی_نام" است.
`ATTRIBUTE_CANNOT_BE_REPEATED`	ویژگی مقیاس پذیر فقط یک بار مشخص می شود. کلیدهای فراداده شامل "ویژگی_نام" است.
`ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY`	ویژگی مقیاس پذیر با دسته بندی های تنظیم شده در مکان سازگار نیست. کلیدهای فراداده شامل "ویژگی_نام" است.
`ADDRESS_REMOVAL_NOT_ALLOWED`	حذف آدرس برای کسب و کار شما مجاز نیست. کلیدهای فراداده شامل "field_mask" است.
`AMBIGUOUS_TITLE`	بهترین نام برای یک زبان مبهم است. کلیدهای فراداده شامل "field_mask" است.
`INVALID_CATEGORY_FOR_SAB`	یک SAB خالص نمی تواند gcid هایی داشته باشد که زیرگروه های gcid:establishment_poi هستند. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`RELATION_ENDPOINTS_TOO_FAR`	نقاط پایانی رابطه از یکدیگر بسیار دور هستند. کلیدهای فراداده شامل "field_mask" و "value" هستند.
`INVALID_SERVICE_ITEM`	ساختار_service_item و free_form_service_item تنظیم نشده اند. کلیدهای فراداده شامل "field_mask" است.
`SERVICE_ITEM_LABEL_NO_DISPLAY_NAME`	برچسب نام نمایشی ندارد. کلیدهای فراداده شامل "field_mask" است.
`SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME`	نام نمایشی برای همه برچسب ها در همه لیست قیمت ها منحصر به فرد نیست. کلیدهای فراداده شامل "field_mask" است.
`SERVICE_ITEM_LABEL_INVALID_UTF8`	برچسب حاوی نمادهای UTF-8 نامعتبر است. کلیدهای فراداده شامل "field_mask" است.
`FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID`	فیلد category_id در free_form_service_item وجود ندارد. کلیدهای فراداده شامل "field_mask" است.
`FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL`	برچسب موجود در free_form_service_item وجود ندارد. کلیدهای فراداده شامل "field_mask" است.
`SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID`	فیلد service_type_id در structured_service_item وجود ندارد. کلیدهای فراداده شامل "field_mask" است.
`INVALID_LANGUAGE`	کد زبان نامعتبر است. کلیدهای فراداده شامل "field_mask" است.
`PRICE_CURRENCY_MISSING`	کد ارز ISO 4217 وجود ندارد. کلیدهای فراداده شامل "field_mask" است.
`PRICE_CURRENCY_INVALID`	کد ارز ارائه شده ISO 4217 معتبر نیست. کلیدهای فراداده شامل "field_mask" هستند.
`SERVICE_TYPE_ID_DUPLICATE`	شناسه های نوع خدمات در مکان منحصر به فرد نیستند. کلیدهای فراداده شامل "field_mask" است.
`PIN_DROP_REQUIRED`	آدرس مشخص شده قابل یافتن نیست. لطفاً از رابط کاربری برای ارائه یک دراپ پین استفاده کنید. کلیدهای فراداده شامل "field_mask" است.
`STALE_DATA`	یک یا چند مورد اخیراً توسط Google به‌روزرسانی شده است. فقط مالک این کسب‌وکار می‌تواند در حال حاضر با بازدید از business.google.com، تغییراتی در داده‌های موجود در "فیلد" ایجاد کند. کلیدهای فراداده شامل "field_mask" است.
`PHONE_NUMBER_EDITS_NOT_ALLOWED`	فیلد شماره تلفن برای این مکان غیرفعال شده است و ویرایش ها مجاز نیستند. کلیدهای فراداده شامل "field_mask" است.
`MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION`	بیش از یک رابطه وجود دارد که رابطه منطقی بین دو مکان را مدل می‌کند (مثلاً فروپاشی، کارها در). کلیدهای فراداده شامل "field_mask" و "value" هستند.

GetAttributesRequest

درخواست AttributesService.GetAttributes.

زمینه های

زمینه های
`name`	`string` ضروری. شناسه Google برای این مکان به شکل `locations/{location_id}/attributes` .

name

string

ضروری. شناسه Google برای این مکان به شکل locations/{location_id}/attributes .

GetChainRequest

درخواست پیام برای Locations.GetChain.

زمینه های

زمینه های
`name`	`string` ضروری. نام منبع زنجیره، با قالب `chains/{chain_place_id}` .

name

string

ضروری. نام منبع زنجیره، با قالب chains/{chain_place_id} .

GetGoogleUpdatedAttributesRequest

درخواست AttributesService.GetGoogleUpdatedAttributes.

زمینه های

زمینه های
`name`	`string` ضروری. شناسه Google برای این مکان به شکل `locations/{location_id}/attributes` .

name

string

ضروری. شناسه Google برای این مکان به شکل locations/{location_id}/attributes .

GetGoogleUpdatedLocationRequest

درخواست پیام برای Locations.GetGoogleUpdatedLocation.

زمینه های

زمینه های
`name`	`string` ضروری. نام مکان برای واکشی.
`read_mask`	`FieldMask` ضروری. ماسک را بخوانید تا مشخص کنید چه فیلدهایی در پاسخ بازگردانده می شوند.

name

string

ضروری. نام مکان برای واکشی.

read_mask

ضروری. ماسک را بخوانید تا مشخص کنید چه فیلدهایی در پاسخ بازگردانده می شوند.

GetLocationRequest

درخواست پیام برای Locations.GetLocation.

زمینه های

زمینه های
`name`	`string` ضروری. نام مکان برای واکشی.
`read_mask`	`FieldMask` ضروری. ماسک را بخوانید تا مشخص کنید چه فیلدهایی در پاسخ بازگردانده می شوند.

name

string

ضروری. نام مکان برای واکشی.

read_mask

ضروری. ماسک را بخوانید تا مشخص کنید چه فیلدهایی در پاسخ بازگردانده می شوند.

GoogleLocation

نشان دهنده Location است که در Google وجود دارد. این می‌تواند مکانی باشد که توسط کاربر، شخص دیگری ادعا شده است یا می‌تواند بدون ادعا باشد.

زمینه های

زمینه های
`name`	`string` نام منبع این GoogleLocation، در قالب `googleLocations/{googleLocationId}` .
`location`	`Location` اطلاعات `Location` پرجمعیت. این فیلد را می توان مجدداً در `CreateLocation` استفاده کرد اگر در حال حاضر توسط کاربر ادعا نشده باشد.
`request_admin_rights_uri`	`string` نشانی اینترنتی که کاربر را به رابط کاربری حقوق سرپرست درخواست هدایت می‌کند. این فیلد فقط در صورتی وجود دارد که مکان قبلاً توسط هر کاربری از جمله کاربر فعلی ادعا شده باشد.

name

string

نام منبع این GoogleLocation، در قالب googleLocations/{googleLocationId} .

location

اطلاعات Location پرجمعیت. این فیلد را می توان مجدداً در CreateLocation استفاده کرد اگر در حال حاضر توسط کاربر ادعا نشده باشد.

request_admin_rights_uri

string

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

GoogleUpdatedLocation

نشان دهنده مکانی است که توسط Google اصلاح شده است.

زمینه های

زمینه های
`location`	`Location` نسخه به‌روزرسانی‌شده این مکان توسط Google.
`diff_mask`	`FieldMask` فیلدهایی که گوگل به روز کرد.
`pending_mask`	`FieldMask` فیلدهایی که ویرایش‌های معلق دارند و هنوز به Maps و Search منتقل نشده‌اند.

location

نسخه به‌روزرسانی‌شده این مکان توسط Google.

diff_mask

فیلدهایی که گوگل به روز کرد.

pending_mask

فیلدهایی که ویرایش‌های معلق دارند و هنوز به Maps و Search منتقل نشده‌اند.

برچسب

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

زمینه های

زمینه های
`display_name`	`string` ضروری. نام نمایشی برای لیست قیمت، بخش یا مورد.
`description`	`string` اختیاری. شرح لیست قیمت، بخش، یا آیتم.
`language_code`	`string` اختیاری. کد زبان BCP-47 که این رشته ها برای آن اعمال می شوند. فقط یک مجموعه از برچسب ها را می توان در هر زبان تنظیم کرد.

display_name

string

ضروری. نام نمایشی برای لیست قیمت، بخش یا مورد.

description

string

اختیاری. شرح لیست قیمت، بخش، یا آیتم.

language_code

string

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

ListAttributeMetadataRequest

درخواست AttributesService.ListAttributeMetadata.

زمینه های
`parent`	`string` نام منبع مکان برای جستجوی ویژگی های موجود. اگر این فیلد تنظیم شده باشد، category_name، region_code، language_code و show_all مورد نیاز نیست و نباید تنظیم شود.
`category_name`	`string` شناسه پایدار دسته اصلی برای یافتن ویژگی‌های موجود. باید از دسته‌های قالب/{category_id} باشد.
`region_code`	`string` کد کشور ISO 3166-1 آلفا-2 برای یافتن ویژگی های موجود.
`language_code`	`string` کد زبان BCP 47 برای دریافت نام‌های نمایشی ویژگی‌ها. اگر این زبان در دسترس نباشد، آنها به زبان انگلیسی ارائه می‌شوند.
`show_all`	`bool` هنگامی که این فیلد روی true تنظیم شود، بدون توجه به فیلدهای والد و kategori_نام، متادیتا برای همه ویژگی‌های موجود برگردانده می‌شود. وقتی show_all روی true تنظیم شده باشد، language_code و region_code مورد نیاز است.
`page_size`	`int32` در هر صفحه چند ویژگی باید درج شود. پیش فرض 200 است، حداقل 1 است.
`page_token`	`string` اگر مشخص شده باشد، صفحه بعدی متادیتای ویژگی بازیابی می شود.

ListAttributeMetadataResponse

پاسخ برای AttributesService.ListAttributeMetadata.

زمینه های

attribute_metadata[]

AttributeMetadata

مجموعه ای از فراداده های ویژگی برای ویژگی های موجود.

next_page_token

string

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

ListCategoriesRequest

درخواست پیام برای BusinessCategories.ListCategories.

زمینه های
`region_code`	`string` ضروری. کد کشور ISO 3166-1 آلفا-2.
`language_code`	`string` ضروری. کد زبان BCP 47.
`filter`	`string` اختیاری. رشته فیلتر از کاربر. تنها فیلدی که پشتیبانی می شود `displayName` است. به عنوان مثال: `filter=displayName=foo` .
`page_size`	`int32` اختیاری. چند دسته برای واکشی در هر صفحه. پیش فرض 100، حداقل 1 و حداکثر اندازه صفحه 100 است.
`page_token`	`string` اختیاری. در صورت مشخص شدن، صفحه بعدی دسته ها واکشی می شود.
`view`	`CategoryView` ضروری. مشخص می کند که کدام بخش از منبع Category باید در پاسخ بازگردانده شود.

ListCategoriesResponse

پیام پاسخ برای BusinessCategories.ListCategories.

زمینه های

زمینه های
`categories[]`	`Category` دسته های تطبیق بر اساس پارامترهای درخواستی.
`next_page_token`	`string` اگر تعداد دسته‌ها از اندازه صفحه درخواستی بیشتر شود، این فیلد با یک نشانه پر می‌شود تا صفحه بعدی دسته‌ها در تماس بعدی با `ListCategories` واکشی شود.

categories[]

دسته های تطبیق بر اساس پارامترهای درخواستی.

next_page_token

string

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

ListLocationsRequest

درخواست پیام برای Locations.ListLocations.

زمینه های
`parent`	`string` ضروری. نام حساب برای واکشی مکان‌ها از آن. اگر [حساب] والدین [google.mybusiness.accountmanagement.v1.Account] از [AccountType] [google.mybusiness.accountmanagement.v1.Account.AccountType] PERSONAL باشد، فقط مکان‌هایی که مستقیماً متعلق به حساب هستند برگردانده می‌شوند، در غیر این صورت همه مکان های قابل دسترسی را از حساب، به طور مستقیم یا غیرمستقیم، برمی گرداند.
`page_size`	`int32` اختیاری. چند مکان برای واکشی در هر صفحه. مقدار پیش فرض در صورت تنظیم نشدن 10 است. حداقل 1 و حداکثر اندازه صفحه 100 است.
`page_token`	`string` اختیاری. اگر مشخص شده باشد، `page` بعدی مکان ها را واکشی می کند. نشانه صفحه با تماس های قبلی به `ListLocations` برگردانده می شود، زمانی که مکان های بیشتری نسبت به اندازه صفحه درخواستی وجود دارد.
`filter`	`string` اختیاری. فیلتری که مکان ها را برای بازگشت محدود می کند. پاسخ فقط شامل ورودی هایی می شود که با فیلتر مطابقت دارند. اگر `filter` خالی باشد، محدودیت ها اعمال می شود و همه مکان ها (صفحه بندی شده) برای حساب درخواستی بازیابی می شوند. برای اطلاعات بیشتر در مورد فیلدهای معتبر و استفاده از نمونه، به راهنمای کار با داده های مکان مراجعه کنید.
`order_by`	`string` اختیاری. ترتیب مرتب سازی برای درخواست چندین فیلد باید با کاما از هم جدا شوند، به دنبال نحو SQL. ترتیب مرتب سازی پیش فرض صعودی است. برای تعیین ترتیب نزولی، پسوند "desc" باید اضافه شود. فیلدهای معتبر برای order_by عبارتند از عنوان و store_code. به عنوان مثال: "title, store_code desc" یا "title" یا "store_code desc"
`read_mask`	`FieldMask` ضروری. ماسک را بخوانید تا مشخص کنید چه فیلدهایی در پاسخ بازگردانده می شوند.

ListLocationsResponse

پیام پاسخ برای Locations.ListLocations.

زمینه های

زمینه های
`locations[]`	`Location` مکان ها
`next_page_token`	`string` اگر تعداد مکان‌ها از اندازه صفحه درخواستی بیشتر باشد، این فیلد با یک نشانه پر می‌شود تا صفحه بعدی مکان‌ها را در تماس بعدی با `ListLocations` واکشی کند. اگر مکان دیگری وجود نداشته باشد، این فیلد در پاسخ وجود ندارد.
`total_size`	`int32` تعداد تقریبی مکان‌ها در فهرست صرف نظر از صفحه‌بندی. این فیلد تنها در صورتی برگردانده می شود که `filter` به عنوان پارامتر پرس و جو استفاده شود.

locations[]

مکان ها

next_page_token

string

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

total_size

int32

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

محل

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

زمینه های
`name`	`string` شناسه Google برای این مکان به شکل: `locations/{location_id}` .
`language_code`	`string` تغییرناپذیر. زبان مکان. در حین ایجاد تنظیم شده و به روز نمی شود.
`store_code`	`string` اختیاری. شناسه خارجی برای این مکان، که باید در یک حساب مشخص منحصر به فرد باشد. این وسیله ای برای مرتبط کردن مکان با سوابق خود است.
`title`	`string` ضروری. نام مکان باید نشان دهنده نام واقعی کسب و کار شما باشد، همانطور که به طور مداوم در ویترین فروشگاه، وب سایت و لوازم التحریر شما استفاده می شود و برای مشتریان شناخته شده است. هر گونه اطلاعات اضافی، در صورت لزوم، می تواند در سایر زمینه های منبع گنجانده شود (به عنوان مثال، `Address` ، `Categories` ). اطلاعات غیر ضروری را به نام خود اضافه نکنید (مثلاً «Google» را به «Google Inc. - Mountain View Corporate Headquarters» ترجیح دهید). برچسب‌های بازاریابی، کدهای فروشگاه، نویسه‌های خاص، ساعات کاری یا وضعیت بسته/باز بودن، شماره تلفن، نشانی‌های وب سایت، اطلاعات خدمات/محصول، مکان/آدرس یا مسیرها، یا اطلاعات مربوط به محدودیت را شامل نشود (به عنوان مثال، «Chase ATM in Duane Reade ").
`phone_numbers`	`PhoneNumbers` اختیاری. شماره تلفن های مختلفی که مشتریان می توانند برای ارتباط با کسب و کار استفاده کنند.
`categories`	`Categories` اختیاری. دسته بندی های مختلفی که کسب و کار را توصیف می کند.
`storefront_address`	`PostalAddress` اختیاری. یک آدرس دقیق و دقیق برای توصیف مکان کسب و کار شما. صندوق پستی یا صندوق پستی واقع در مکان های دور قابل قبول نیست. در این زمان می توانید حداکثر پنج مقدار `address_lines` را در آدرس مشخص کنید. این فیلد فقط باید برای مشاغلی تنظیم شود که ویترین دارند. این فیلد نباید برای مکان‌هایی از نوع `CUSTOMER_LOCATION_ONLY` تنظیم شود، اما اگر تنظیم شود، هر مقدار ارائه شده نادیده گرفته می‌شود.
`website_uri`	`string` اختیاری. یک URL برای این کسب و کار. در صورت امکان، به جای یک وب‌سایت/URL عمومی که همه مکان‌ها یا نام تجاری را نشان می‌دهد، از نشانی اینترنتی استفاده کنید که نشان‌دهنده این مکان تجاری فردی است.
`regular_hours`	`BusinessHours` اختیاری. ساعات کاری برای کسب و کار
`special_hours`	`SpecialHours` اختیاری. ساعات کاری ویژه برای کسب و کار این معمولاً شامل ساعات تعطیلات و سایر اوقات خارج از ساعات کاری عادی می شود. اینها ساعات کاری منظم را لغو می کنند. این فیلد را نمی توان بدون ساعت کاری منظم تنظیم کرد.
`service_area`	`ServiceAreaBusiness` اختیاری. مشاغل حوزه خدمات خدمات خود را در محل مشتری ارائه می دهند. اگر این کسب‌وکار یک کسب‌وکار با منطقه خدماتی است، این قسمت منطقه(های) خدماتی توسط کسب‌وکار را توصیف می‌کند.
`labels[]`	`string` اختیاری. مجموعه ای از رشته های آزاد که به شما امکان می دهد کسب و کار خود را برچسب گذاری کنید. این برچسب ها رو به روی کاربر نیستند. فقط شما می توانید آنها را ببینید باید بین 1 تا 255 نویسه در هر برچسب باشد.
`ad_words_location_extensions`	`AdWordsLocationExtensions` اختیاری. اطلاعات اضافی که در AdWords ظاهر می شود.
`latlng`	`LatLng` اختیاری. طول و عرض جغرافیایی ارائه شده توسط کاربر. هنگام ایجاد یک مکان، در صورت موفقیت آمیز بودن کدهای جغرافیایی آدرس ارائه شده، این فیلد نادیده گرفته می شود. این فیلد تنها در صورت درخواست‌های دریافت بازگردانده می‌شود که مقدار `latlng` ارائه‌شده توسط کاربر در حین ایجاد پذیرفته شود، یا مقدار `latlng` از طریق وب‌سایت نمایه کسب‌وکار Google به‌روزرسانی شده باشد. این فیلد فقط توسط مشتریان تایید شده می تواند به روز شود.
`open_info`	`OpenInfo` اختیاری. پرچمی که نشان می دهد مکان در حال حاضر برای تجارت باز است یا خیر.
`metadata`	`Metadata` فقط خروجی اطلاعات اضافی غیر قابل ویرایش توسط کاربر.
`profile`	`Profile` اختیاری. کسب و کار شما را با صدای خودتان توصیف می کند و داستان منحصر به فرد کسب و کار و پیشنهادات شما را با کاربران به اشتراک می گذارد. این فیلد برای همه دسته ها به جز دسته های اقامتی (مانند هتل ها، متل ها، مسافرخانه ها) ضروری است.
`relationship_data`	`RelationshipData` اختیاری. تمام مکان ها و زنجیره مربوط به این یکی.
`more_hours[]`	`MoreHours` اختیاری. ساعات بیشتر برای بخش های مختلف یک کسب و کار یا مشتریان خاص.
`service_items[]`	`ServiceItem` اختیاری. لیست خدمات پشتیبانی شده توسط بازرگانان یک سرویس می تواند مو، نصب آبگرمکن و غیره باشد. موارد تکراری سرویس به طور خودکار حذف می شوند.

فراداده

اطلاعات اضافی غیر قابل ویرایش توسط کاربر در مورد مکان.

زمینه های
`has_google_updated`	`bool` فقط خروجی نشان می‌دهد که آیا شناسه مکان مرتبط با این مکان به‌روزرسانی‌هایی دارد که باید توسط مشتری به‌روزرسانی شوند یا رد شوند. اگر این بولی تنظیم شده است، برای جستجوی اطلاعاتی که باید تأیید شوند، باید روش `getGoogleUpdated` را فراخوانی کنید.
`has_pending_edits`	`bool` فقط خروجی نشان می دهد که آیا هر یک از ویژگی های این مکان در حالت تعلیق ویرایش هستند یا خیر.
`can_delete`	`bool` فقط خروجی نشان می دهد که آیا مکان را می توان با استفاده از API حذف کرد یا خیر.
`can_operate_local_post`	`bool` فقط خروجی نشان می دهد که آیا فهرست می تواند پست های محلی را مدیریت کند یا خیر.
`can_modify_service_list`	`bool` فقط خروجی نشان می دهد که آیا فهرست می تواند لیست خدمات را تغییر دهد یا خیر.
`can_have_food_menus`	`bool` فقط خروجی نشان می دهد که آیا فهرست برای منوی غذا واجد شرایط است یا خیر.
`can_operate_health_data`	`bool` فقط خروجی نشان می دهد که آیا مکان می تواند بر روی داده های Health کار کند یا خیر.
`can_operate_lodging_data`	`bool` فقط خروجی نشان می دهد که آیا مکان می تواند روی داده های اقامتگاه کار کند یا خیر.
`place_id`	`string` فقط خروجی اگر این مکان در Google Maps ظاهر شود، این قسمت با شناسه مکان برای مکان پر می شود. این شناسه را می توان در API های مختلف Places استفاده کرد. این فیلد را می توان در حین ایجاد تماس ها تنظیم کرد، اما نه برای به روز رسانی.
`duplicate_location`	`string` فقط خروجی منبع مکانی که این مکان تکرار می کند.
`maps_uri`	`string` فقط خروجی پیوندی به مکان در Maps.
`new_review_uri`	`string` فقط خروجی پیوندی به صفحه‌ای در جستجوی Google که در آن مشتری می‌تواند نظری برای موقعیت مکانی بگذارد.
`can_have_business_calls`	`bool` فقط خروجی نشان می دهد که آیا فهرست برای تماس های تجاری واجد شرایط است یا خیر.
`has_voice_of_merchant`	`bool` فقط خروجی نشان می دهد که آیا فهرست دارای Voice of Merchant است یا خیر. اگر این بولی نادرست است، باید با locations.getVoiceOfMerchantState API تماس بگیرید تا جزئیات مربوط به عدم وجود Voice of Merchant را دریافت کنید.

بیشتر ساعت

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

زمینه های

زمینه های
`hours_type_id`	`string` ضروری. نوع ساعت مشتریان باید با {#link businessCategories:BatchGet} تماس بگیرند تا انواع ساعت های پشتیبانی شده را برای دسته بندی مکان هایشان دریافت کنند.
`periods[]`	`TimePeriod` ضروری. مجموعه ای از زمان هایی که این مکان باز است. هر دوره نشان دهنده محدوده ای از ساعاتی است که مکان در طول هفته باز است.

hours_type_id

string

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

periods[]

TimePeriod

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

MoreHoursType

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

زمینه های

hours_type_id

string

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

display_name

string

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

localized_display_name

string

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

OpenInfo

اطلاعات مربوط به وضعیت افتتاح کسب و کار.

زمینه های

status

OpenForBusiness

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

can_reopen

bool

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

opening_date

Date

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

OpenForBusiness

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

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

شماره تلفن ها

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

زمینه های

primary_phone

string

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

additional_phones[]

string

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

PlaceInfo

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

زمینه های

place_name

string

ضروری. نام محلی مکان. به عنوان مثال، Scottsdale, AZ .

place_id

string

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

مکان ها

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

زمینه های

place_infos[]

PlaceInfo

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

مشخصات

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

زمینه های

description

string

ضروری. شرح مکان با صدای خودتان، غیر قابل ویرایش توسط شخص دیگری.

RelationshipData

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

زمینه های

parent_location

RelevantLocation

مکان اصلی که این مکان با آن ارتباط دارد.

children_locations[]

RelevantLocation

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

parent_chain

string

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

RelevantLocation

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

زمینه های

place_id

string

ضروری. مکانی را که در طرف دیگر رابطه قرار دارد با شناسه مکان آن مشخص کنید.

relation_type

RelationType

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

نوع رابطه

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

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

RepeatedEnumAttributeValue

مقادیر برای یک ویژگی با value_type REPEATED_ENUM. این شامل دو لیست از شناسه‌های مقدار است: آنهایی که تنظیم شده‌اند (true) و آنهایی که تنظیم نشده‌اند (false). مقادیر غایب ناشناخته در نظر گرفته می شوند. حداقل یک مقدار باید مشخص شود.

زمینه های

set_values[]

string

مقادیر Enum که تنظیم شده اند.

unset_values[]

string

مقادیر Enum که تنظیم نشده اند.

SearchChainsRequest

درخواست پیام برای Locations.SearchChains.

زمینه های

chain_name

string

ضروری. یک زنجیره را با نام آن جستجو کنید. پرسش‌های دقیق/جزئی/فازی/مرتبط پشتیبانی می‌شوند. مثال‌ها: "walmart"، "wal-mart"، "walmmmart"، "沃尔玛"

page_size

int32

حداکثر تعداد زنجیره‌های منطبق برای بازگشت از این جستار. پیش فرض 10 است. حداکثر مقدار ممکن 500 است.

SearchChainsResponse

پیام پاسخ برای Locations.SearchChains.

زمینه های

chains[]

Chain

زنجیره هایی که با chain_display_name درخواست شده در SearchChainsRequest مطابقت دارند. اگر مطابقت وجود نداشته باشد، این فیلد خالی خواهد بود. نتایج به ترتیب ارتباط فهرست شده است.

جستجوی GoogleLocationsRequest

درخواست پیام برای GoogleLocations.SearchGoogleLocations.

زمینه های
`page_size`	`int32` تعداد مسابقات برای بازگشت. مقدار پیش‌فرض 3 و حداکثر 10 است. توجه داشته باشید که در صورت درخواست بیشتر، تاخیر ممکن است افزایش یابد. صفحه بندی وجود ندارد.
فیلد اتحادیه `search_query` . پرس و جو جستجو این می تواند به عنوان یک شی مکان یا به عنوان یک پرس و جو رشته ای ارائه شود. `search_query` فقط می تواند یکی از موارد زیر باشد:
`location`	`Location` مکان برای جستجو در صورت ارائه، مکان هایی را پیدا می کند که با جزئیات مکان ارائه شده مطابقت دارند.
`query`	`string` پرس و جو متنی برای جستجو نتایج جستجو از یک رشته پرس و جو نسبت به ارائه یک مکان دقیق دقت کمتری خواهد داشت، اما می تواند تطابقات نادقیق بیشتری ارائه دهد.

SearchGoogleLocationsResponse

پیام پاسخ برای GoogleLocations.SearchGoogleLocations.

زمینه های

google_locations[]

GoogleLocation

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

Service AreaBusiness

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

زمینه های

business_type

BusinessType

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

places

Places

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

region_code

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 به‌روزرسانی می‌شود، به‌روزرسانی موقعیت مکانی باید حاوی فیلد mask `storefront_address` باشد و فیلد را خالی تنظیم کند.
`CUSTOMER_AND_BUSINESS_LOCATION`	خدمات را در آدرس کسب و کار و منطقه اطراف ارائه می دهد.

Service Item

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

زمینه های
`price`	`Money` اختیاری. نشان دهنده قیمت پولی کالای خدماتی است. توصیه می‌کنیم هنگام درج قیمت، کد و واحدهای ارز تنظیم شوند. این به عنوان یک قیمت ثابت برای کالای خدمات تلقی می شود.
`service_item_info` میدانی اتحادیه. یکی از فیلدهای زیر باید همیشه تنظیم شود. `service_item_info` تنها می تواند یکی از موارد زیر باشد:
`structured_service_item`	`StructuredServiceItem` اختیاری. این فیلد موردی از داده های سرویس های ساخت یافته است.
`free_form_service_item`	`FreeFormServiceItem` اختیاری. این فیلد موردی از داده‌های سرویس‌های فرم آزاد تنظیم می‌شود.

FreeFormServiceItem

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

زمینه های

category

string

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

label

Label

ضروری. برچسب‌های برچسب‌گذاری شده با زبان برای مورد. توصیه می کنیم نام آیتم ها 140 نویسه یا کمتر و توضیحات 250 نویسه یا کمتر باشد. این فیلد فقط در صورتی باید تنظیم شود که ورودی یک مورد سرویس سفارشی باشد. انواع خدمات استاندارد شده باید از طریق service_type_id به روز شوند.

StructuredServiceItem

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

زمینه های

service_type_id

string

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

description

string

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

نوع سرویس

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

زمینه های

service_type_id

string

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

display_name

string

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

Special HourPeriod

نشان دهنده یک دوره زمانی است که ساعات عملیاتی یک مکان با ساعات کاری عادی آن متفاوت است. یک بازه ساعتی خاص باید محدوده ای کمتر از 24 ساعت را نشان دهد. open_time و start_date باید قبل از close_time و end_date باشد. close_time و end_date می تواند تا ساعت 11:59 صبح روز بعد از start_date مشخص شده افزایش یابد. به عنوان مثال، ورودی های زیر معتبر هستند:

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

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

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00

زمینه های
`start_date`	`Date` ضروری. تاریخ تقویمی این دوره ساعتی ویژه در تاریخ شروع می شود.
`open_time`	`TimeOfDay` اختیاری. مقادیر معتبر 00:00-24:00 هستند که ساعت 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است. اگر `closed` نادرست است باید مشخص شود.
`end_date`	`Date` اختیاری. تاریخ تقویمی که این دوره ساعتی ویژه به پایان می رسد. اگر قسمت `end_date` تنظیم نشده است، به طور پیش‌فرض تاریخ مشخص شده در `start_date` را تعیین کنید. در صورت تنظیم، این فیلد باید برابر یا حداکثر 1 روز پس از `start_date` باشد.
`close_time`	`TimeOfDay` اختیاری. مقادیر معتبر 00:00-24:00 هستند، که در آن ساعت 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است. اگر `closed` نادرست است باید مشخص شود.
`closed`	`bool` اختیاری. اگر true باشد، `end_date` ، `open_time` ، و `close_time` نادیده گرفته می‌شوند و تاریخ مشخص‌شده در `start_date` به‌عنوان مکان بسته‌شده برای کل روز تلقی می‌شود.

ساعات ویژه

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

زمینه های

special_hour_periods[]

SpecialHourPeriod

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

بازه زمانی

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

زمینه های
`open_day`	`DayOfWeek` ضروری. `day of the week` را نشان می دهد که این دوره از آن شروع می شود.
`open_time`	`TimeOfDay` ضروری. مقادیر معتبر 00:00-24:00 هستند، که در آن ساعت 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است.
`close_day`	`DayOfWeek` ضروری. `day of the week` را نشان می دهد که این دوره به پایان می رسد.
`close_time`	`TimeOfDay` ضروری. مقادیر معتبر 00:00-24:00 هستند، که در آن ساعت 24:00 نشان دهنده نیمه شب در پایان فیلد روز مشخص شده است.

UpdateAttributesRequest

درخواست AttributesService.UpdateAttributes.

زمینه های

attributes

Attributes

مجموعه ای از ویژگی هایی که باید به روز شوند.

attribute_mask

ضروری. نام ویژگی ویژگی هایی که می خواهید به روز کنید. نشان داده شده توسط attributes/{attribute} .

به‌روزرسانی‌ها: همه ویژگی‌های ارائه شده در فیلد ویژگی‌ها که می‌خواهید به‌روزرسانی شوند باید در attribute_mask تنظیم شوند. ویژگی هایی که در لیست بالا تنظیم شده اند، اما در attribute_mask نیستند، نادیده گرفته خواهند شد.

حذف‌ها: اگر می‌خواهید ویژگی‌های خاصی را حذف کنید، باید آنها را در attribute_mask بدون هیچ ورودی مشابه در لیست ویژگی‌ها مشخص کنید. اگر می‌خواهید همه ویژگی‌های تنظیم‌شده در یک مکان را حذف کنید، باید تمام ویژگی‌های قابل اجرا برای مکان را جستجو کنید و سپس با یک فیلد ویژگی‌های خالی، آنها را به attribute_mask اضافه کنید.

UpdateLocationRequest

درخواست پیام برای Locations.UpdateLocation.

زمینه های

location

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

update_mask