BusinessInfo

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

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

string

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

address

object (PostalAddress)

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

phone

object (PhoneNumber)

النتائج فقط. رقم هاتف النشاط التجاري.

phoneVerificationState

enum (PhoneVerificationState)

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

customerService

object (CustomerService)

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

koreanBusinessRegistrationNumber

string

اختياريّ. رقم تسجيل النشاط التجاري في كوريا المكوّن من 10 أرقام والمفصول بشرطات بالتنسيق: XXX-XX-XXXXX

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

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

رقم الهاتف

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

هذا التمثيل:

  • ويجب عدم استخدامه لتنسيق رقم الهاتف الخاص بالمنطقة، مثل " +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)

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