Package google.mybusiness.businessinformation.v1

الفهرس

• AttributesService (واجهة)
• CategoriesService (واجهة)
• Chains (واجهة)
• GoogleLocations (واجهة)
• Locations (واجهة)
• AdWordsLocationExtensions (رسالة)
• Attribute (رسالة)
• AttributeMetadata (رسالة)
• AttributeMetadata.AttributeValueMetadata (رسالة)
• AttributeValueType (تعداد)
• Attributes (رسالة)
• BatchGetCategoriesRequest (رسالة)
• BatchGetCategoriesResponse (رسالة)
• BusinessHours (رسالة)
• Categories (رسالة)
• Category (رسالة)
• CategoryView (تعداد)
• Chain (رسالة)
• Chain.ChainName (رسالة)
• Chain.ChainUri (رسالة)
• CreateLocationRequest (رسالة)
• DeleteLocationRequest (رسالة)
• ErrorCode (تعداد)
• GetAttributesRequest (رسالة)
• GetChainRequest (رسالة)
• GetGoogleUpdatedAttributesRequest (رسالة)
• GetGoogleUpdatedLocationRequest (رسالة)
• GetLocationRequest (رسالة)
• GoogleLocation (رسالة)
• GoogleUpdatedLocation (رسالة)
• Label (رسالة)
• ListAttributeMetadataRequest (رسالة)
• ListAttributeMetadataResponse (رسالة)
• ListCategoriesRequest (رسالة)
• ListCategoriesResponse (رسالة)
• ListLocationsRequest (رسالة)
• ListLocationsResponse (رسالة)
• Location (رسالة)
• Metadata (رسالة)
• MoreHours (رسالة)
• MoreHoursType (رسالة)
• OpenInfo (رسالة)
• OpenInfo.OpenForBusiness (تعداد)
• PhoneNumbers (رسالة)
• PlaceInfo (رسالة)
• Places (رسالة)
• Profile (رسالة)
• RelationshipData (رسالة)
• RelevantLocation (رسالة)
• RelevantLocation.RelationType (تعداد)
• RepeatedEnumAttributeValue (رسالة)
• SearchChainsRequest (رسالة)
• SearchChainsResponse (رسالة)
• SearchGoogleLocationsRequest (رسالة)
• SearchGoogleLocationsResponse (رسالة)
• ServiceAreaBusiness (رسالة)
• ServiceAreaBusiness.BusinessType (تعداد)
• ServiceItem (رسالة)
• ServiceItem.FreeFormServiceItem (رسالة)
• ServiceItem.StructuredServiceItem (رسالة)
• ServiceType (رسالة)
• SpecialHourPeriod (رسالة)
• SpecialHours (رسالة)
• TimePeriod (رسالة)
• UpdateAttributesRequest (رسالة)
• UpdateLocationRequest (رسالة)
• UriAttributeValue (رسالة)

AttributesService

يسمح للعملاء بالبحث عن السمات وتحديثها لموقع معين.

GetAttributes
rpc GetAttributes(GetAttributesRequest) returns (Attributes) يبحث عن جميع السمات المعيّنة لموقع جغرافي معيّن. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

GetGoogleUpdatedAttributes
rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes) الحصول على النسخة المعدّلة من Google للموقع الجغرافي المحدّد نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

ListAttributeMetadata
rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse) تعرض قائمة السمات التي قد تكون متاحة لموقع مع الفئة الأساسية والبلد المعينين. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

UpdateAttributes
rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes) تعديل السمات لموقع جغرافي معيّن نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

CategoriesService

توفّر واجهة برمجة التطبيقات هذه معلومات عن الفئات المتاحة للمواقع الجغرافية للأنشطة التجارية على Google. كمرجع لك، راجِع قسم الفئات في هذه المقالة: https://support.google.com/business/answer/3038177

BatchGetCategories
rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse) تعرض قائمة بفئات النشاط التجاري للّغة ومعرّفات GConcept المقدَّمة. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse) تعرض قائمة بفئات النشاط التجاري. سيطابق البحث مع اسم الفئة ولكن لن يطابق رقم تعريف الفئة. تتطابق عبارة البحث فقط مع واجهة اسم الفئة (أي أن كلمة "طعام" قد تؤدي إلى ظهور "طعام كورت" وليس "مطعم وجبات سريعة"). نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

السلاسل

خدمة للبحث عن معلومات عن الأنشطة التجارية التابعة لسلسلة

GetChain
rpc GetChain(GetChainRequest) returns (Chain) الحصول على السلسلة المحددة. تعرض الدالة NOT_FOUND إذا لم تكن السلسلة متوفرة. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

SearchChains
rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse) للبحث في السلسلة استنادًا إلى اسم السلسلة. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

GoogleLocations

تتيح واجهة برمجة التطبيقات هذه إمكانية الوصول إلى GoogleLocation والبحث فيه.

SearchGoogleLocations
rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse) يمكنك البحث عن جميع المواقع الجغرافية المحتملة التي تتطابق مع الطلب المحدّد. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

المواقع الجغرافية

تتيح واجهة برمجة التطبيقات هذه إدارة المواقع الجغرافية للنشاط التجاري على Google.

CreateLocation
rpc CreateLocation(CreateLocationRequest) returns (Location) إنشاء موقع جديد يملكه المستخدم الذي سجّل الدخول. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty) يؤدي هذا الإجراء إلى حذف موقع جغرافي. إذا تعذّر حذف هذا الموقع الجغرافي باستخدام واجهة برمجة التطبيقات وتم وضع علامة عليه في google.mybusiness.businessinformation.v1.LocationState، استخدِم الموقع الإلكتروني للملف التجاري على Google. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

GetGoogleUpdatedLocation
rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation) الحصول على النسخة المعدّلة من Google للموقع الجغرافي المحدّد نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

الحصول على موقع
rpc GetLocation(GetLocationRequest) returns (Location) لعرض الموقع المحدد. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

المواقع الجغرافية المدرَجة في القائمة
rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse) يسرد المواقع الجغرافية للحساب المحدّد. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

UpdateLocation
rpc UpdateLocation(UpdateLocationRequest) returns (Location) لتعديل الموقع الجغرافي المحدّد. نطاقات الأذونات يجب توفير نطاق OAuth التالي: https://www.googleapis.com/auth/business.manage لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

AdWordsLocationExtensions

المعلومات الإضافية التي يتم عرضها في AdWords

الحقول
ad_phone	string مطلوب. رقم هاتف بديل للعرض في إضافات مواقع AdWords بدلاً من رقم الهاتف الأساسي للموقع.

السمة

سمة الموقع الجغرافي توفّر السمات معلومات إضافية حول الموقع الجغرافي. وقد تختلف السمات التي يمكن ضبطها بناءً على موقع جغرافي حسب خصائص هذا الموقع الجغرافي (على سبيل المثال، الفئة). تحدِّد Google السمات المتاحة ويمكن إضافتها وإزالتها بدون إجراء تغييرات على واجهة برمجة التطبيقات.

الحقول
name	string مطلوب. اسم المورد لهذه السمة.
value_type	AttributeValueType النتائج فقط. نوع القيمة التي تحتوي عليها هذه السمة. يجب استخدام هذا لتحديد كيفية تفسير القيمة.
values[]	Value قيم هذه السمة. يجب أن يتطابق نوع القيم المقدَّمة مع تلك المتوقَّعة لهذه السمة. هذا حقل متكرّر حيث يمكن توفير قيم سمات متعدّدة. يمكن استخدام قيمة واحدة فقط في أنواع السمات.
repeated_enum_value	RepeatedEnumAttributeValue عندما يكون نوع قيمة السمة هو REPEATED_ENUM، يجب أن تحتوي القيمة على قيمة السمة، ويجب أن تكون حقول القيم الأخرى فارغة.
uri_values[]	UriAttributeValue عندما يكون نوع قيمة السمة هو "عنوان URL"، هذا الحقل يحتوي على قيم هذه السمة، ويجب أن تكون حقول القيم الأخرى فارغة.

AttributeMetadata

البيانات الوصفية لسمة معيّنة تحتوي على معلومات عرض للسمة، بما في ذلك الاسم المترجَم وعنوان لتجميع السمات ذات الصلة معًا.

الحقول
parent	string المعرّف الفريد للسمة.
value_type	AttributeValueType نوع قيمة السمة. يجب أن تكون القيم التي تم ضبطها واستردادها من هذا النوع.
display_name	string الاسم المعروض للسمة باللغة المحلية، إذا كان متاحًا وإلا، فهو الاسم المعروض باللغة الإنجليزية.
group_display_name	string الاسم المعروض المترجم للمجموعة التي تحتوي على هذه السمة، إذا كان متاحًا وبخلاف ذلك، اسم المجموعة الإنجليزية. يتم جمع السمات ذات الصلة في مجموعة ويجب عرضها معًا تحت العنوان الموضح هنا.
repeatable	bool إذا كانت القيمة هي true، تتيح السمة قيمًا متعددة. إذا كانت القيمة "false"، يجب تقديم قيمة واحدة فقط.
value_metadata[]	AttributeValueMetadata بالنسبة إلى بعض أنواع السمات (مثل التعداد)، يتم تقديم قائمة بالقيم المسموح بها والأسماء المعروضة المقابلة لهذه القيم.
deprecated	bool إذا كانت القيمة هي true، سيتم إيقاف السمة نهائيًا ويجب عدم استخدامها بعد ذلك. إذا تم إيقافها، لن يؤدي تعديل هذه السمة إلى حدوث خطأ، ولكن لن يتم حفظ التعديلات. في مرحلة ما بعد إيقافها، ستتم إزالة السمة بالكامل وستصبح خطأً.

AttributeValueMetadata

البيانات الوصفية لقيم السمات المسموح بها

الحقول
value	Value قيمة السمة.
display_name	string الاسم المعروض لهذه القيمة، بما يناسب السوق المحلية حيثما كان ذلك متاحًا أو باللغة الإنجليزية. تم تصميم القيمة "الاسم المعروض" لاستخدامها مع السياق مع الاسم المعروض للسمة. على سبيل المثال، بالنسبة إلى "WiFi" enum، ويمكن أن تحتوي هذه القيمة على "مدفوع" لتمثيل شبكات Wi-Fi المدفوعة.

AttributeValueType

نوع قيمة السمة.

عمليات التعداد
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED	لم يتم تحديده.
BOOL	قيم هذه السمة هي قيم منطقية.
ENUM	تتضمّن السمة قائمة محدّدة مسبقًا بالقيم المتوفّرة التي يمكن استخدامها. ستدرج البيانات الوصفية لهذه السمة هذه القيم.
URL	قيم هذه السمة هي عناوين URL.
REPEATED_ENUM	قيمة السمة هي تعداد يضم عدة قيم محتملة يمكن ضبطها أو إلغاء ضبطها بشكل صريح.

السمات

تمثّل هذه السمة حاوية لجميع السمات لموقع جغرافي معيّن.

الحقول
name	string مطلوب. معرّف Google لهذا الموقع في شكل locations/{location_id}/attributes.
attributes[]	Attribute يشير ذلك المصطلح إلى مجموعة من السمات التي تحتاج إلى تعديل.

BatchGetCategoriesRequest

اطلب رسالة لفئة BusinessCategory.BatchGetBusinessCategory.

الحقول
names[]	string مطلوب. يجب ضبط اسم واحد على الأقل. معرّفات GConcept التي يجب عرض أسماء الفئات المترجَمة من أجلها. لعرض تفاصيل لأكثر من فئة واحدة، كرِّر هذه المَعلمة في الطلب.
language_code	string مطلوب. رمز اللغة BCP 47 الذي يجب عرض أسماء الفئات به.
region_code	string اختياريّ. تمثّل هذه السمة رمز البلد بصيغة ISO 3166-1 alpha-2 المستخدَم لاستنتاج لغة غير عادية.
view	CategoryView مطلوب. تحدِّد هذه السياسة الأجزاء التي يجب عرضها في الردّ ضمن مورد "الفئة".

BatchGetCategoriesResponse

رسالة ردّ لفئة BusinessCategory.BatchGetBusinessCategory.

الحقول
categories[]	Category الفئات التي تتطابق مع أرقام تعريف GConcept المقدَّمة في الطلب. لن تأتي بالترتيب نفسه كمعرّفات الفئات في الطلب.

BusinessHours

تمثل الفترات الزمنية التي يكون فيها هذا الموقع الجغرافي مفتوحًا للنشاط التجاري. يتضمن مجموعة من مثيلات [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

الحقول
periods[]	TimePeriod مطلوب. هذه مجموعة للأوقات التي يكون فيها هذا الموقع الجغرافي مفتوحًا لمزاولة النشاط التجاري. تمثل كل فترة نطاقًا من الساعات التي يكون فيها الموقع الجغرافي مفتوحًا خلال الأسبوع.

الفئات

هي مجموعة من الفئات التي تصف النشاط التجاري. أثناء إجراء التحديثات، يجب ضبط كلا الحقلَين. ويُحظر على العملاء تعديل الفئات الأساسية أو الإضافية بشكل فردي باستخدام قناع التحديث.

الحقول
primary_category	Category مطلوب. الفئة التي تصف النشاط التجاري الأساسي الذي يشارك فيه هذا الموقع الجغرافي على أفضل وجه
additional_categories[]	Category اختياريّ. فئات إضافية لوصف نشاطك التجاري. تساعد الفئات عملاءك في العثور على نتائج دقيقة ومحددة للخدمات التي تهمهم. وللحفاظ على دقة معلومات نشاطك التجاري واستمرار عرضها، احرص على استخدام أقل عدد ممكن من الفئات لوصف نشاطك التجاري الأساسي بصورة شاملة. اختَر فئات محدّدة قدر الإمكان، على أن تمثّل نشاطك التجاري الرئيسي.

الفئة

فئة تصف ماهية هذا النشاط التجاري (وليس ما يقدّمه). للحصول على قائمة بمعرّفات الفئات الصالحة وعمليات الربط لأسمائها التي يمكن للمستخدمين قراءتها، يُرجى الاطّلاع على categories.list.

الحقول
name	string مطلوب. معرّف ثابت (توفّره Google) لهذه الفئة يجب تحديد القيمة عند تعديل الفئة (عند إنشاء موقع أو تعديله).
display_name	string النتائج فقط. تمثّل هذه السمة اسم الفئة سهل القراءة للمستخدم. ويتم ضبطه عند قراءة الموقع الجغرافي. عند تعديل الموقع الجغرافي، يجب ضبط category_id.
service_types[]	ServiceType النتائج فقط. قائمة بجميع أنواع الخدمات المتاحة لفئة النشاط التجاري هذه.
more_hours_types[]	MoreHoursType النتائج فقط. أنواع ساعات العمل الإضافية المتاحة لفئة النشاط التجاري هذه.

CategoryView

تعداد للمساعدة في الحد من كمية البيانات التي يعرضها الخادم.

عمليات التعداد
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 عدد المواقع الجغرافية التي تُعد جزءًا من هذه السلسلة.

ChainName

الاسم الذي سيتمّ استخدامه عند عرض السلسلة

الحقول
display_name	string الاسم المعروض لهذه السلسلة.
language_code	string تمثّل هذه السمة رمز لغة الاسم BCP 47.

ChainUri

عنوان URL الذي سيتم استخدامه عند عرض السلسلة

الحقول
uri	string تمثّل هذه السمة معرّف الموارد المنتظم (URI) لهذه السلسلة.

CreateLocationRequest

طلب رسالة للمواقع الجغرافية.CreateLocation.

الحقول
parent	string مطلوب. اسم الحساب الذي سيتم إنشاء هذا الموقع الجغرافي فيه.
location	Location مطلوب. البيانات الوصفية الجديدة للموقع الجغرافي
validate_only	bool اختياريّ. إذا كانت القيمة هي true، سيتم التحقّق من صحة الطلب بدون إنشاء الموقع الجغرافي.
request_id	string اختياريّ. رقم تعريف طلب فريد للخادم لرصد الطلبات المكرّرة. ننصحك باستخدام أرقام التعريف الفريدة العالمية (UUID). الحد الأقصى للطول هو 50 حرفًا.

DeleteLocationRequest

طلب رسالة لـ Location.DeleteLocation

الحقول
name	string مطلوب. اسم الموقع الجغرافي الذي تريد حذفه.

ErrorCode

جميع رموز الأخطاء التي تعرضها واجهة برمجة التطبيقات.

عمليات التعداد
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	لا يُسمح لهذا المشروع بتعديل حقل خطوط الطول/العرض على الموقع الجغرافي. يمكنك إما تعديل خطوط الطول والعرض باستخدام وظيفة إضافة الدبوس في واجهة المستخدم أو تزويدنا بعنوان.
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" و"spam_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	لا يمكن أن تتداخل ساعات العمل الخاصة. تتضمن مفاتيح البيانات الوصفية "field_mask"
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY	لا تتوافق الفئة الأساسية لنشاطك التجاري مع نوع ساعات العمل هذا. تتضمن مفاتيح البيانات الوصفية "field_mask" و"inavailable_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" و"القيمة".
INVALID_PHONE_NUMBER_FOR_REGION	رقم الهاتف غير صالح للمنطقة. تتضمن مفاتيح البيانات الوصفية "field_mask" و"القيمة".
MISSING_PRIMARY_PHONE_NUMBER	يجب إدخال رقم الهاتف الأساسي. تتضمن مفاتيح البيانات الوصفية "field_mask"
THROTTLED	لا يمكن تعديل الحقل في الوقت الحالي. تتضمن مفاتيح البيانات الوصفية "field_mask" و"القيمة".
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA	لم تعُد مناطق نطاق خدمة النطاق الجغرافي للنقطة متاحة. تتضمن مفاتيح البيانات الوصفية "field_mask"
INVALID_CATEGORY	رقم تعريف الفئة غير صالح. تتضمن مفاتيح البيانات الوصفية "field_mask" و"القيمة".
CANNOT_REOPEN	لا يمكن إعادة فتح النشاط التجاري. تتضمن مفاتيح البيانات الوصفية "field_mask"
INVALID_BUSINESS_OPENING_DATE	تاريخ افتتاح النشاط التجاري غير صالح. تتضمن مفاتيح البيانات الوصفية "field_mask"
INVALID_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" و"القيمة".
RELATION_CANNOT_BE_THE_LOCATION_ITSELF	لا يمكن أن تكون العلاقة للموقع نفسه. تتضمن مفاتيح البيانات الوصفية "field_mask" و"القيمة".
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_name".
ATTRIBUTE_INVALID_ENUM_VALUE	قيمة سمة enum غير معروفة. تشتمل مفاتيح البيانات الوصفية على "attribute_name".
ATTRIBUTE_NOT_AVAILABLE	السمة القابلة للتطور غير صالحة لهذا الموقع الجغرافي. تتضمن مفاتيح البيانات الوصفية "attribute_name".
ATTRIBUTE_CANNOT_BE_REPEATED	يمكن تحديد السمة Scalable مرة واحدة فقط. تشتمل مفاتيح البيانات الوصفية على "attribute_name".
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY	لا تتوافق السمة Scalable مع الفئات المعيّنة في الموقع. تشتمل مفاتيح البيانات الوصفية على "attribute_name".
ADDRESS_REMOVAL_NOT_ALLOWED	غير مسموح بإزالة العنوان لنشاطك التجاري. تتضمن مفاتيح البيانات الوصفية "field_mask"
AMBIGUOUS_TITLE	أفضل اسم غامض بالنسبة إلى أي لغة. تتضمن مفاتيح البيانات الوصفية "field_mask"
INVALID_CATEGORY_FOR_SAB	لا يمكن أن يحتوي SAB الخالص على gcids التي هي من أنواع فرعية من gcid:settingment_poi. تتضمن مفاتيح البيانات الوصفية "field_mask" و"القيمة".
RELATION_ENDPOINTS_TOO_FAR	نقاط نهاية العلاقة بعيدة جدًا عن بعضها البعض. تتضمن مفاتيح البيانات الوصفية "field_mask" و"القيمة".
INVALID_SERVICE_ITEM	لم يتم ضبط واجهة برمجة التطبيقاتstructured_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" و"القيمة".

GetAttributesRequest

طلب AttributesService.GetAttributes.

الحقول
name	string مطلوب. معرّف Google لهذا الموقع في شكل locations/{location_id}/attributes.

GetChainRequest

طلب رسالة للمواقع الجغرافية.GetChain

الحقول
name	string مطلوب. اسم مورد السلسلة، بالتنسيق chains/{chain_place_id}.

GetGoogleUpdatedAttributesRequest

طلب AttributesService.GetGoogleUpdatedAttributes.

الحقول
name	string مطلوب. معرّف Google لهذا الموقع في شكل locations/{location_id}/attributes.

GetGoogleUpdatedLocationRequest

طلب رسالة لـ Location.GetGoogleUpdatedLocation.

الحقول
name	string مطلوب. اسم الموقع الذي تريد جلبه.
read_mask	FieldMask مطلوب. قراءة القناع لتحديد الحقول التي سيتم عرضها في الردّ

طلب GetLocationRequest

طلب رسالة للمواقع الجغرافية.GetLocation

الحقول
name	string مطلوب. اسم الموقع الذي تريد جلبه.
read_mask	FieldMask مطلوب. قراءة القناع لتحديد الحقول التي سيتم عرضها في الردّ

GoogleLocation

يُمثل Location موجود على Google. قد يكون هذا موقعًا جغرافيًا طالبًا بملكيته من قِبل المستخدم أو شخص آخر أو قد لم يطالب بملكيته.

الحقول
name	string اسم المورد لهذا الموقع الجغرافي في GoogleLocation بالتنسيق googleLocations/{googleLocationId}
location	Location تمثّل هذه السمة معلومات Location التي تمّت تعبئتها بوتيرة منخفضة. ويمكن إعادة استخدام هذا الحقل في CreateLocation إذا لم يطالب به مستخدم حاليًا.
request_admin_rights_uri	string عنوان URL سيعيد توجيه المستخدم إلى واجهة مستخدم حقوق مشرف الطلب. لا يتوفّر هذا الحقل إلا إذا سبق أن تمت المطالبة بالموقع الجغرافي من قِبل أي مستخدم، بما في ذلك المستخدم الحالي.

GoogleUpdatedLocation

يمثل موقعًا جغرافيًا عدّلته Google.

الحقول
location	Location النسخة المعدّلة من Google لهذا الموقع الجغرافي
diff_mask	FieldMask الحقول التي عدّلتها Google.
pending_mask	FieldMask الحقول التي تحتوي على تعديلات معلّقة ولم يتم إرسالها بعد إلى "خرائط Google" و"بحث Google".

التصنيف

تصنيف يتم استخدامه عند عرض قائمة الأسعار أو القسم أو السلعة

الحقول
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 alpha-2 للعثور على السمات المتاحة.
language_code	string رمز اللغة BCP 47 للحصول على أسماء عرض السمات. إذا لم تكن هذه اللغة متاحة، سيتم توفيرها باللغة الإنجليزية.
show_all	bool يتم عرض البيانات الوصفية لجميع السمات المتاحة عند ضبط هذا الحقل على "صحيح"، مع تجاهل الحقلَين الرئيسيَين والفئة "اسم_الفئة". يجب إدخال سمة language_code وregion_code عند ضبط show_all على true.
page_size	int32 عدد السمات المطلوب تضمينها في كل صفحة. القيمة التلقائية هي 200، والحد الأدنى هو 1.
page_token	string إذا تم التحديد، يتم استرداد الصفحة التالية من البيانات الوصفية للسمة.

ListAttributeMetadataResponse

الاستجابة لـ AttributesService.ListAttributeMetadata.

الحقول
attribute_metadata[]	AttributeMetadata هي مجموعة من البيانات الوصفية للسمات الخاصة بالسمات المتاحة.
next_page_token	string إذا تجاوز عدد السمات حجم الصفحة المطلوب، ستتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من السمات في استدعاء لاحق لـ attributes.list. إذا لم يتوفّر المزيد من السمات، لن يكون هذا الحقل متوفّرًا في الردّ.

ListCategoriesRequest

طلب رسالة لفئة BusinessCategory.ListCategory.

الحقول
region_code	string مطلوب. تمثّل هذه السمة رمز البلد بصيغة ISO 3166-1 alpha-2.
language_code	string مطلوب. تمثّل هذه السمة رمز اللغة BCP 47.
filter	string اختياريّ. تصفية سلسلة من المستخدم الحقل الوحيد المتاح هو displayName. على سبيل المثال: filter=displayName=foo.
page_size	int32 اختياريّ. عدد الفئات المطلوب جلبها لكل صفحة. الإعداد التلقائي هو 100، والحد الأدنى هو 1، والحد الأقصى لحجم الصفحة هو 100.
page_token	string اختياريّ. في حال تحديده، سيتم استرجاع صفحة الفئات التالية.
view	CategoryView مطلوب. تحدِّد هذه السياسة الأجزاء التي يجب عرضها في الردّ ضمن مورد "الفئة".

ListCategoriesResponse

رسالة ردّ لـ BusinessCategory.ListCategory.

الحقول
categories[]	Category فئات المطابقة على أساس المعلّمات المطلوبة.
next_page_token	string إذا تجاوز عدد الفئات حجم الصفحة المطلوب، ستتم تعبئة هذا الحقل برمز مميز لجلب الصفحة التالية من الفئات في مكالمة لاحقة إلى ListCategories.

طلب ListLocations

طلب رسالة لـ Location.ListLocations

الحقول
parent	string مطلوب. اسم الحساب الذي تريد استرجاع المواقع الجغرافية منه إذا كان الحساب الرئيسي [Account] [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. يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي، يجب استخدام لاحقة " وصف" . إنّ الحقول الصالحة للطلب "order_by" هي "العنوان" و"رمز المتجر" (store_code). على سبيل المثال: "title, store_code desc" أو "العنوان" أو "store_code desc"
read_mask	FieldMask مطلوب. قراءة القناع لتحديد الحقول التي سيتم عرضها في الردّ

استجابة ListLocations

رسالة ردّ لـ Sites.ListLocations.

الحقول
locations[]	Location المواقع الجغرافية
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. - مقر شركة ماونتن فيو"). لا تُدرِج الجُمل الترويجية التسويقية أو رموز المتاجر أو الرموز الخاصة أو ساعات العمل أو حالة الإغلاق/الفتح أو أرقام الهواتف أو عناوين URL للمواقع الإلكترونية أو معلومات الخدمة/المنتجات أو الموقع الجغرافي/العنوان أو الاتجاهات أو معلومات الاحتواء (مثل "ماكينة الصراف الآلي للبنك الأهلي في دبي").
phone_numbers	PhoneNumbers اختياريّ. أرقام الهاتف المختلفة التي يمكن للعملاء استخدامها للتواصل مع النشاط التجاري.
categories	Categories اختياريّ. الفئات المختلفة التي تصف النشاط التجاري.
storefront_address	PostalAddress اختياريّ. عنوان دقيق ودقيق لوصف الموقع الجغرافي لنشاطك التجاري ولا يتم قبول صناديق البريد الواقعة في مواقع جغرافية نائية. في الوقت الحالي، يمكنك تحديد خمس قيم كحد أقصى للحقل "address_lines" في العنوان. يجب ضبط هذا الحقل فقط للأنشطة التجارية التي لها واجهة محل. يجب عدم ضبط هذا الحقل للمواقع الجغرافية من النوع CUSTOMER_LOCATION_ONLY، ولكن في حال ضبطه، سيتم تجاهل أي قيمة مقدَّمة.
website_uri	string اختياريّ. عنوان URL لهذا النشاط التجاري. استخدِم، إن أمكن، عنوان URL يمثّل الموقع الجغرافي للنشاط التجاري الفردي بدلاً من موقع إلكتروني عام أو عنوان URL عام يمثّل كل المواقع الجغرافية أو العلامة التجارية.
regular_hours	BusinessHours اختياريّ. ساعات العمل للنشاط التجاري.
special_hours	SpecialHours اختياريّ. ساعات العمل الخاصة للنشاط التجاري. ويشمل ذلك عادةً ساعات العمل خلال العطلات وأوقات أخرى خارج ساعات العمل العادية. ويلغي ذلك ساعات العمل العادية. لا يمكن ضبط هذا الحقل بدون ساعات العمل العادية.
service_area	ServiceAreaBusiness اختياريّ. تقدّم الأنشطة التجارية ذات منطقة نطاق الخدمة خدمتها في الموقع الجغرافي للعميل. إذا كان هذا النشاط التجاري عبارة عن نشاط تجاري يقدّم منطقة نطاق خدمة، يصف هذا الحقل المناطق التي يخدمها النشاط التجاري.
labels[]	string اختياريّ. هي مجموعة من السلاسل الحرة التي تتيح لك الإشارة إلى نشاطك التجاري. هذه التصنيفات لا تكون موجّهة للمستخدمين، لا يمكن لأحد سواك رؤيتها. يجب أن يتراوح عدد الأحرف بين حرف واحد و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 النتائج فقط. تشير هذه السياسة إلى ما إذا كان يمكن حذف الموقع الجغرافي باستخدام واجهة برمجة التطبيقات.
can_operate_local_post	bool النتائج فقط. تشير هذه السمة إلى ما إذا كان يمكن لبطاقة بيانات المتجر إدارة المشاركات المحلية.
can_modify_service_list	bool النتائج فقط. يشير هذا الحقل إلى ما إذا كان بإمكان بطاقة بيانات المتجر تعديل قائمة الخدمات.
can_have_food_menus	bool النتائج فقط. تشير هذه السمة إلى ما إذا كانت البيانات مؤهّلة لقائمة الطعام.
can_operate_health_data	bool النتائج فقط. تشير هذه السمة إلى ما إذا كان من الممكن استخدام الموقع الجغرافي استنادًا إلى البيانات الصحية.
can_operate_lodging_data	bool النتائج فقط. يشير إلى ما إذا كان يمكن للموقع الجغرافي العمل استنادًا إلى بيانات الإقامة.
place_id	string النتائج فقط. إذا ظهر هذا الموقع الجغرافي على "خرائط Google"، تتم تعبئة هذا الحقل برقم تعريف المكان للموقع الجغرافي. ويمكن استخدام هذا المعرّف في واجهات برمجة تطبيقات للأماكن المختلفة. يمكن ضبط هذا الحقل أثناء إنشاء مكالمات، ولكن ليس لإجراء "تحديث".
duplicate_location	string النتائج فقط. مورد الموقع الذي يكرر هذا الموقع.
maps_uri	string النتائج فقط. رابط إلى الموقع الجغرافي على "خرائط Google"
new_review_uri	string النتائج فقط. رابط إلى الصفحة على "بحث Google" حيث يمكن للعميل إضافة مراجعة عن الموقع الجغرافي.
can_have_business_calls	bool النتائج فقط. يشير هذا الحقل إلى ما إذا كانت بطاقة بيانات المتجر مؤهَّلة لمكالمات النشاط التجاري.
has_voice_of_merchant	bool النتائج فقط. تشير هذه السمة إلى ما إذا كانت البيانات تتضمّن خدمة Voice of Merchant. إذا كانت هذه القيمة المنطقية خاطئة، يجب طلب واجهة برمجة التطبيقات location.getVoiceOfMerchantState API للحصول على تفاصيل عن سبب عدم توفّر خدمة Voice of Merchant.

MoreHours

الفترات الزمنية التي يفتح خلالها الموقع الجغرافي لأنواع معيّنة من الأنشطة التجارية.

الحقول
hours_type_id	string مطلوب. نوع ساعات العمل. ويجب أن يتصل العملاء بـ {#link businesscategory: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

يشير إلى حالة موقع جغرافي.

عمليات التعداد
OPEN_FOR_BUSINESS_UNSPECIFIED	لم يتم تحديده.
OPEN	يشير إلى أن الموقع مفتوح.
CLOSED_PERMANENTLY	يشير إلى أن الموقع قد تم إغلاقه نهائيًا.
CLOSED_TEMPORARILY	يشير إلى أن الموقع الجغرافي قد تم إغلاقه مؤقتًا.

PhoneNumbers

مجموعة من أرقام الهواتف للنشاط التجاري. أثناء إجراء التحديثات، يجب ضبط كلا الحقلَين. لا يمكن للعملاء تعديل أرقام الهواتف الأساسية أو الإضافية فقط باستخدام قناع التحديث. يُفضَّل استخدام تنسيق الهاتف الدولي، مثل " [phone]"، ويمكنك الاطّلاع على مزيد من المعلومات في (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 مطلوب. نوع العلاقة.

RelationType

علاقات النوع المراد تحديدها.

عمليات التعداد
RELATION_TYPE_UNSPECIFIED	لم يتم تحديد النوع.
DEPARTMENT_OF	يمثّل ذلك العلاقة بين موقعَين جغرافيَّين يتشاركان في منطقة جغرافية واحدة، والعلامة التجارية نفسها أو الإدارة العليا أو المؤسسة نفسها، ولكن بسمات رئيسية مختلفة، مثل ساعات عمل المتجر أو أرقام الهاتف. على سبيل المثال، صيدلية Costco هي قسم في Costco بالجملة.
INDEPENDENT_ESTABLISHMENT_IN	وتمثّل هذه القيمة الحالات التي يتشارك فيها موقعان جغرافيان الموقع الجغرافي نفسه، ولكن من شركات مختلفة (مثل مقهى "ستاربكس" في طريق "سافيواي" والمتاجر في مركز تجاري).

RepeatedEnumAttributeValue

قيم لسمة تحتوي على value_type بقيمة REPEATED_ENUM. يتألف هذا الإجراء من قائمتين من أرقام تعريف القيم: تلك التي تم ضبطها (صحيح) وتلك التي لم يتم ضبطها (خطأ). تُعتبر القيم غير المتوفِّرة غير معروفة. يجب تحديد قيمة واحدة على الأقل.

الحقول
set_values[]	string قيم التعداد التي يتم تعيينها.
unset_values[]	string قيم التعداد التي لم يتم ضبطها

SearchChainsRequest

طلب رسالة للمواقع الجغرافية.SearchChains

الحقول
chain_name	string مطلوب. ابحث عن سلسلة حسب اسمها. تتوفّر طلبات البحث الدقيقة/الجزئية/الضبابية/ذات الصلة. أمثلة: "المارت" و"المارت" و"المارت" و"沃尔玛"
page_size	int32 الحد الأقصى لعدد السلاسل المتطابقة التي يمكن عرضها من طلب البحث هذا. والعدد التلقائي هو 10. وأقصى قيمة ممكنة هي 500.

SearchChainsResponse

رسالة ردّ لـ Location.SearchChains.

الحقول
chains[]	Chain السلاسل التي تتطابق مع series_display_name التي تم الاستعلام عنها في SearchChainsRequest. إذا لم تكن هناك أي تطابقات، سيكون هذا الحقل فارغًا. يتم سرد النتائج بترتيب مدى الصلة بالموضوع.

SearchGoogleLocationsRequest

طلب رسالة إلى GoogleLocations.SearchGoogleLocations.

الحقول
page_size	int32 عدد النتائج المطابقة المطلوب عرضها. القيمة التلقائية هي 3، بحدّ أقصى 10. يُرجى العِلم أنّ وقت الاستجابة قد يزيد في حال طلب المزيد. ولا يتم التقسيم على صفحات.
حقل الاتحاد search_query. استعلام البحث. ويمكن توفيره ككائن موقع جغرافي أو كطلب سلسلة. يمكن أن يكون search_query واحدًا فقط مما يلي:
location	Location موقع البحث. سيتم العثور على المواقع الجغرافية التي تتطابق مع تفاصيل الموقع الجغرافي المقدّمة، في حال توفّرها.
query	string طلب بحث نصي للبحث عنه. وستكون نتائج البحث الواردة من سلسلة طلب بحث أقل دقة مقارنةً بنتائج البحث عن الموقع الجغرافي الدقيق، ولكن يمكن أن تتضمّن المزيد من المطابقات غير الدقيقة.

SearchGoogleLocationsResponse

رسالة ردّ على GoogleLocations.SearchGoogleLocations.

الحقول
google_locations[]	GoogleLocation مجموعة من المواقع الجغرافية على Google التي يُحتمل أن تتطابق مع الطلب المحدّد، مُدرجة بالترتيب من الأكثر إلى الأقل دقة.

ServiceAreaBusiness

تقدّم الأنشطة التجارية ذات نطاق الخدمة خدمتها في موقع العميل (على سبيل المثال، صناعة أقفال أو سباكة).

الحقول
business_type	BusinessType مطلوب. تشير هذه السمة إلى [type]. [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، وسيتم تجاهله في الحالات الأخرى. يمكن أن تختلف المنطقة المحدّدة هنا عن المناطق التي يخدمها هذا النشاط التجاري (مثل الأنشطة التجارية ذات نطاق الخدمة التي تقدّم خدمات في مناطق غير المنطقة التي يقع فيها مقرّ النشاط التجاري). إذا كان هذا الموقع الجغرافي يتطلّب إثبات الهوية بعد إنشائه، يجب أن يكون العنوان المقدَّم لأغراض إثبات الملكية في هذه المنطقة، ويجب أن يتمكّن مالك النشاط التجاري أو ممثله المفوَّض من تلقّي رسائل البريد العادي على عنوان إثبات الملكية المقدَّم.

BusinessType

تشير هذه السمة إلى ما إذا كان هذا النشاط التجاري يقدّم فقط خدمات في الموقع الجغرافي للعميل (مثل شاحنة سحب)، أو في عنوان وفي الموقع معًا (على سبيل المثال، متجر بيتزا يضم مساحة لتناول الطعام ويوفّر خدمة التوصيل إلى العملاء أيضًا).

عمليات التعداد
BUSINESS_TYPE_UNSPECIFIED	النتائج فقط. لم يتم تحديده.
CUSTOMER_LOCATION_ONLY	تقدّم الخدمة في المنطقة المحيطة فقط (وليس في عنوان النشاط التجاري). في حال تعديل بيانات نشاط تجاري من CUSTOMER_AND_business_LOCATION إلى CUSTOMER_LOCATION_ONLY، يجب أن يتضمّن تعديل الموقع الجغرافي قناع الحقل storefront_address وضبط الحقل على "فارغ".
CUSTOMER_AND_BUSINESS_LOCATION	تتوفّر الخدمة في عنوان النشاط التجاري والمنطقة المحيطة.

ServiceItem

يشير ذلك المصطلح إلى رسالة تصف عنصر خدمة واحدًا. وهي تُستخدم لوصف نوع الخدمة التي يقدّمها التاجر. على سبيل المثال، يمكن أن يكون قص الشعر خدمة.

الحقول
price	Money اختياريّ. تمثّل هذه السمة السعر النقدي لعنصر الخدمة. وننصحك بتحديد currency_code والوحدات عند تضمين سعر. وسيتم اعتبار هذا السعر كسعر ثابت لعنصر الخدمة.
حقل الاتحاد 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

إذا كان يمثّل خدمة منظَّمة يقدّمها التاجر على سبيل المثال: toilet_installation.

الحقول
service_type_id	string مطلوب. الحقل service_type_id هو معرّف فريد توفّره Google ويمكن العثور عليه في ServiceType. يتم توفير هذه المعلومات من خلال خدمة متوسط عائد النقرة في "BatchGetCategories".
description	string اختياريّ. وصف عنصر الخدمة المنظَّم. عدد الأحرف المسموح به هو 300.

ServiceType

رسالة تصف نوع الخدمة التي يقدّمها النشاط التجاري

الحقول
service_type_id	string النتائج فقط. معرّف ثابت (توفّره Google) لهذا النوع من الخدمات
display_name	string النتائج فقط. الاسم المعروض لنوع الخدمة الذي يمكن للمستخدمين قراءته.

SpecialHourPeriod

ويمثِّل هذه الفترة فترة زمنية واحدة تختلف فيها ساعات العمل في أحد المواقع الجغرافية عن ساعات العمل العادية لهذا الموقع الجغرافي. يجب أن تمثل فترة الساعات الخاصة نطاقًا أقل من 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. وفي حال ضبطها، يجب أن يساوي هذا الحقل يوم start_date أو بعده بيوم واحد على الأكثر.
close_time	TimeOfDay اختياريّ. القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. يجب تحديدها إذا كانت السمة closed خاطئة.
closed	bool اختياريّ. إذا كانت القيمة هي true، سيتم تجاهل end_date وopen_time وclose_time، ويتم التعامل مع التاريخ المحدّد في start_date على أنّه الموقع الجغرافي الذي يتم إغلاقه طوال اليوم.

SpecialHours

ويمثِّل مجموعة من الفترات الزمنية التي تختلف فيها ساعات العمل في الموقع الجغرافي عن ساعات العمل العادية.

الحقول
special_hour_periods[]	SpecialHourPeriod مطلوب. قائمة بالاستثناءات لساعات العمل العادية للنشاط التجاري.

TimePeriod

يمثل فترة زمنية يكون فيها النشاط التجاري مفتوحًا، بدءًا من اليوم/الوقت المفتوح المحدد والإغلاق في يوم/وقت الإغلاق المحدد. يجب أن يكون وقت الإغلاق بعد وقت الفتح، على سبيل المثال، في وقت لاحق من اليوم نفسه أو في يوم لاحق.

الحقول
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	FieldMask مطلوب. اسم السمة للسمات التي تريد تعديلها. يمثلها attributes/{attribute}. آخر الأخبار: يجب ضبط جميع السمات الواردة في حقل السمات التي تريد تعديلها في attribute_mask. سيتم تجاهل السمات المحدّدة في القائمة أعلاه وليس في attribute_mask. الحذف: إذا أردت حذف سمات معيّنة، يجب تحديدها في attribute_mask بدون إدخال مطابق في قائمة السمات. إذا كنت تريد حذف جميع السمات المضبوطة على موقع جغرافي معيّن، عليك البحث عن جميع السمات المنطبقة للموقع الجغرافي، ثم إضافتها إلى attribute_mask مع ترك حقل سمات فارغ.

UpdateLocationRequest

طلب رسالة لـ Location.UpdateLocation

الحقول
location	Location مطلوب. معلومات الموقع الجغرافي التي تم تعديلها.
update_mask	FieldMask مطلوب. الحقول المحدّدة المطلوب تعديلها.
validate_only	bool اختياريّ. إذا كانت القيمة هي true، يتم التحقّق من صحة الطلب بدون تعديل الموقع الجغرافي. عند ضبط هذا الحقل، لن نعرض أخطاء التحقّق إلا في حال وجود أيّ منها. سيكون الرد فارغًا إذا لم يتم العثور على أخطاء.

UriAttributeValue

يشير إلى قيم سمة تتضمّن value_type لعنوان URL.

الحقول
uri	string مطلوب. تشير هذه السمة إلى قيمة معرّف الموارد المنتظم (URI) المقترَحة لهذه السمة.