BusinessInfo

جمع المعلومات ذات الصلة بنشاط تجاري

تمثيل JSON 
{
  "name": string,
  "address": {
    object (PostalAddress)
  },
  "phone": {
    object (PhoneNumber)
  },
  "phoneVerificationState": enum (PhoneVerificationState),
  "customerService": {
    object (CustomerService)
  }
}
الحقول
name

string

المُعرّف. اسم المورد لمعلومات النشاط التجاري. التنسيق: accounts/{account}/businessInfo
address

object (PostalAddress)

اختياريّ. تمثّل هذه السمة عنوان النشاط التجاري.
phone

object (PhoneNumber)

اختياريّ. رقم هاتف النشاط التجاري.
phoneVerificationState

enum (PhoneVerificationState)

النتائج فقط. حالة إثبات ملكية النشاط التجاري عبر الهاتف.
customerService

object (CustomerService)

اختياريّ. خدمة عملاء النشاط التجاري.

PostalAddress

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

في الاستخدام النموذجي، يتم إنشاء عنوان من خلال البيانات التي يُدخلها المستخدم أو من استيراد البيانات الحالية، وذلك حسب نوع العملية.

نصائح بشأن إدخال العنوان أو تعديله: - استخدام تطبيق مصغّر بعنوان جاهز للاستخدام مع مختلف البلدان، مثل https://github.com/google/libaddressinput). يجب عدم تقديم عناصر واجهة المستخدم إلى المستخدمين لإدخال أو تعديل الحقول خارج البلدان التي يُستخدَم فيها هذا الحقل.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478

تمثيل JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
الحقول
revision

integer

تمثّل هذه السمة مراجعة المخطط لـ PostalAddress. يجب تعيين هذا على 0، وهي أحدث مراجعة.

يجب أن تكون جميع النُسخ السابقة متوافقة مع الإصدارات القديمة.
regionCode

string

مطلوبة. رمز CLDR للبلد أو المنطقة التي يقع فيها العنوان. لا يتم استنتاج ذلك أبدًا، وتقع على عاتق المستخدم مسؤولية التأكّد من صحة القيمة. يمكنك الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html لمعرفة التفاصيل. مثال: "CH" بالنسبة إلى الإمارات.
languageCode

string

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

وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة).

أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en".
postalCode

string

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

string

اختياريّ. رمز ترتيب إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. وعند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة اختياريًا برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا) أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (مثل ساحل العاج).
administrativeArea

string

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

string

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

string

اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق.
addressLines[]

string

أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان.

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

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

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

string

اختياريّ. المستلم على العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على معلومات "العناية".
organization

string

اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان.

PhoneNumber

كائن يمثّل رقم هاتف ومناسب لتنسيق سلك واجهة برمجة التطبيقات

هذا التمثيل:

  • يجب عدم استخدامه لتنسيق رقم الهاتف الخاص بالمنطقة، مثلاً " +1 (650) 253-0000 ext. 123"

  • غير مصمم لتوفير مساحة تخزين فعالة

  • قد لا تكون مناسبة للاتصال - يجب استخدام المكتبات المتخصّصة (راجع المراجع) لتحليل الرقم لذلك الغرض

لتنفيذ إجراء مفيد بهذا الرقم، مثل تنسيقه لحالات استخدام مختلفة، عليك تحويله إلى عنصر i18n.phonenumbers.PhoneNumber أولاً.

على سبيل المثال، في Java يكون هذا كالتالي:

com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); }

المراجع: - https://github.com/google/libphonenumber

تمثيل JSON 
{
  "extension": string,

  // Union field kind can be only one of the following:
  "e164Number": string,
  "shortCode": {
    object (ShortCode)
  }
  // End of list of possible types for union field kind.
}
الحقول
extension

string

امتداد رقم الهاتف. لم يتم توحيد الامتداد في اقتراحات الاتحاد الدولي للاتصالات، باستثناء ما يتم تعريفه كسلسلة من الأرقام التي يصل طولها إلى 40 رقمًا كحد أقصى. ما عدا الأرقام، قد يتم تخزين بعض رموز الاتصال الأخرى، مثل ',' (التي تشير إلى الانتظار) أو "#" هنا.

تجدر الإشارة إلى أنّه ما مِن مناطق تستخدم حاليًا إضافات ذات رموز قصيرة، لذلك يتم ضبط هذا الحقل عادةً بالاقتران مع رقم E.164 فقط. ويتم الاحتفاظ بها بشكل منفصل عن رقم E.164 للسماح بامتدادات الرموز القصيرة في المستقبل.
حقل الاتحاد kind. مطلوبة. تكون إما رقمًا عاديًا أو رمزًا قصيرًا. يمكن إضافة حقول جديدة إلى الحقل التالي في المستقبل، لذلك يجب على العملاء تجاهل أرقام الهواتف التي لم يتم تعيين أي من الحقول التي تم الترميز وفقًا لها. يمكن أن يكون kind واحدًا فقط مما يلي:
e164Number

string

رقم الهاتف الممثَّل بعلامة زائد بادئة ("+")، متبوعًا برقم هاتف يستخدم تنسيق ITU E.164 المريح الذي يتكون من رمز الاتصال الخاص بالبلد (من 1 إلى 3 أرقام) ورقم المشترك، بدون مسافات أو تنسيق إضافي، على سبيل المثال: - صحيح: " +15552220123" - غير صحيح: " +1 (555) 222-01234 x123".

يحصر تنسيق ITU E.164 الرقم الأخير بـ 12 رقمًا، لكن من الناحية العملية لا تلتزم بعض البلدان بذلك، لذا نخفّف من صرامة هذا القيد. لا يُسمح باستخدام الأرقام الوطنية فقط.

المراجع: https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164 - https://en.wikipedia.org/wiki/List_of_country_calling_codes
shortCode

object (ShortCode)

رمز قصير.

المراجع: https://en.wikipedia.org/wiki/Short_code

ShortCode

كائن يمثل رمزًا قصيرًا، وهو رقم هاتف عادةً ما يكون أقصر بكثير من أرقام الهواتف العادية ويمكن استخدامه لتوجيه الرسائل في أنظمة رسائل الوسائط المتعددة وأنظمة الرسائل القصيرة SMS، بالإضافة إلى الاتصال المختصَر (مثل "إرسال رسالة نصية إلى 611 لمعرفة عدد الدقائق المتبقية في خطتك").

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

تمثيل JSON 
{
  "regionCode": string,
  "number": string
}
الحقول
regionCode

string

مطلوبة. رمز المنطقة BCP-47 للموقع الجغرافي الذي يمكن فيه إجراء الطلبات لهذا الرمز القصير، مثل US وBB.

المراجع: http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

مطلوبة. أرقام الرمز القصير، بدون علامة زائد ("+") أو رمز اتصال للبلد، مثال "611"

PhoneVerificationState

حالة إثبات صحة رقم الهاتف.

عمليات التعداد
PHONE_VERIFICATION_STATE_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
PHONE_VERIFICATION_STATE_VERIFIED تم إثبات ملكية الهاتف.
PHONE_VERIFICATION_STATE_UNVERIFIED لم يتم إثبات ملكية الهاتف

CustomerService

معلومات خدمة العملاء

تمثيل JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
الحقول
uri

string

اختياريّ. معرّف الموارد المنتظم (URI) الذي يمكن العثور على خدمة العملاء فيه
email

string

اختياريّ. عنوان البريد الإلكتروني الذي يمكن التواصل من خلاله مع خدمة العملاء.
phone

object (PhoneNumber)

اختياريّ. تمثّل هذه السمة رقم الهاتف الذي قد يتم الاتصال بخدمة العملاء عليه.