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-XXXXXX از هم جدا شده است.

آدرس پستی

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

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

توصیه‌هایی در مورد ورودی/ویرایش آدرس: - از ویجت آدرس آماده بین‌المللی‌سازی مانند https://github.com/google/libaddressinput استفاده کنید - به کاربران نباید عناصر رابط کاربری برای ورودی یا ویرایش فیلدها در خارج از کشورهایی که آن فیلد وجود دارد ارائه شود. استفاده می شود.

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرح، لطفاً به این آدرس مراجعه کنید: https://support.google.com/business/answer/6397478

نمایندگی JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
فیلدها
revision

integer

بازبینی طرحواره PostalAddress . این باید روی 0 تنظیم شود که آخرین ویرایش است.

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

regionCode

string

مورد نیاز. کد منطقه CLDR کشور/منطقه آدرس. این هرگز استنباط نمی شود و اطمینان از صحیح بودن مقدار به عهده کاربر است. برای جزئیات به https://cldr.unicode.org/ و https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس.

languageCode

string

اختیاری. کد زبان BCP-47 محتویات این آدرس (در صورت شناخته شدن). این اغلب زبان رابط کاربری فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورد استفاده در کشور/منطقه آدرس یا معادل‌های نویسه‌گردانی شده آنها مطابقت داشته باشد. این می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر روی اعتبارسنجی یا سایر عملیات مرتبط با قالب‌بندی تأثیر نمی‌گذارد.

اگر این مقدار مشخص نیست، باید حذف شود (به جای تعیین یک پیش فرض احتمالاً نادرست).

مثال: "zh-Hant"، "ja"، "ja-Latn"، "en".

postalCode

string

اختیاری. کد پستی آدرس همه کشورها از وجود کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر قسمت‌های آدرس (مثلاً اعتبارسنجی ایالت/زیپ در ایالات متحده آمریکا) ایجاد کنند.

sortingCode

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است، که به صورت اختیاری با یک عدد دنبال می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی، نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر ناحیه تحویل» است. (مالاوی) یا «نشانگر اداره پست» (مثلاً ساحل عاج).

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

شماره تلفن

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

این نمایندگی:

  • نباید برای قالب‌بندی محلی شماره تلفن، مانند «+1 (650) 253-0000 داخلی 123» استفاده شود.

  • برای ذخیره سازی کارآمد طراحی نشده است

  • ممکن است برای شماره گیری مناسب نباشد - کتابخانه های تخصصی (به منابع مراجعه کنید) باید برای تجزیه شماره برای آن منظور استفاده شود

برای انجام کاری معنادار با این شماره، مانند قالب بندی آن برای موارد مختلف، ابتدا آن را به یک شی i18n.phonenumbers.PhoneNumber تبدیل کنید.

به عنوان مثال، در جاوا این خواهد بود:

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

پسوند شماره تلفن این افزونه در توصیه های ITU استاندارد نشده است، به جز اینکه به عنوان یک سری اعداد با طول حداکثر 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

کد کوتاه

یک شی نشان دهنده یک کد کوتاه، که شماره تلفنی است که معمولاً بسیار کوتاهتر از شماره تلفن های معمولی است و می تواند برای آدرس دهی پیام ها در سیستم های MMS و 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

وضعیت تأیید تلفن

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED مقدار پیش فرض این مقدار استفاده نشده است.
PHONE_VERIFICATION_STATE_VERIFIED گوشی تایید شده است.
PHONE_VERIFICATION_STATE_UNVERIFIED گوشی تایید نشده است

خدمات مشتری

اطلاعات خدمات مشتری

نمایندگی JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
فیلدها
uri

string

اختیاری. URI که در آن خدمات مشتری ممکن است پیدا شود.

email

string

اختیاری. آدرس ایمیلی که ممکن است به خدمات مشتری دسترسی پیدا کند.

phone

object ( PhoneNumber )

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

،

جمع آوری اطلاعات مربوط به یک کسب و کار.

نمایندگی 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-XXXXXX از هم جدا شده است.

آدرس پستی

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

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

توصیه‌هایی در مورد ورودی/ویرایش آدرس: - از ویجت آدرس آماده بین‌المللی‌سازی مانند https://github.com/google/libaddressinput استفاده کنید - به کاربران نباید عناصر رابط کاربری برای ورودی یا ویرایش فیلدها در خارج از کشورهایی که آن فیلد وجود دارد ارائه شود. استفاده می شود.

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرح، لطفاً به این آدرس مراجعه کنید: https://support.google.com/business/answer/6397478

نمایندگی JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
فیلدها
revision

integer

بازبینی طرحواره PostalAddress . این باید روی 0 تنظیم شود که آخرین ویرایش است.

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

regionCode

string

مورد نیاز. کد منطقه CLDR کشور/منطقه آدرس. این هرگز استنباط نمی شود و اطمینان از صحیح بودن مقدار به عهده کاربر است. برای جزئیات به https://cldr.unicode.org/ و https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس.

languageCode

string

اختیاری. کد زبان BCP-47 محتویات این آدرس (در صورت شناخته شدن). این اغلب زبان رابط کاربری فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورد استفاده در کشور/منطقه آدرس یا معادل‌های نویسه‌گردانی شده آنها مطابقت داشته باشد. این می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر روی اعتبارسنجی یا سایر عملیات مرتبط با قالب‌بندی تأثیر نمی‌گذارد.

اگر این مقدار مشخص نیست، باید حذف شود (به جای تعیین یک پیش فرض احتمالاً نادرست).

مثال: "zh-Hant"، "ja"، "ja-Latn"، "en".

postalCode

string

اختیاری. کد پستی آدرس همه کشورها از وجود کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر قسمت‌های آدرس (مثلاً اعتبارسنجی ایالت/زیپ در ایالات متحده آمریکا) ایجاد کنند.

sortingCode

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است، که به صورت اختیاری با یک عدد دنبال می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی، نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر ناحیه تحویل» است. (مالاوی) یا «نشانگر اداره پست» (مثلاً ساحل عاج).

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

شماره تلفن

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

این نمایندگی:

  • نباید برای قالب‌بندی محلی شماره تلفن، مانند «+1 (650) 253-0000 داخلی 123» استفاده شود.

  • برای ذخیره سازی کارآمد طراحی نشده است

  • ممکن است برای شماره گیری مناسب نباشد - کتابخانه های تخصصی (به منابع مراجعه کنید) باید برای تجزیه شماره برای آن منظور استفاده شود

برای انجام کاری معنادار با این شماره، مانند قالب بندی آن برای موارد مختلف، ابتدا آن را به یک شی i18n.phonenumbers.PhoneNumber تبدیل کنید.

به عنوان مثال، در جاوا این خواهد بود:

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

پسوند شماره تلفن این افزونه در توصیه های ITU استاندارد نشده است، به جز اینکه به عنوان یک سری اعداد با طول حداکثر 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

کد کوتاه

یک شی نشان دهنده یک کد کوتاه، که شماره تلفنی است که معمولاً بسیار کوتاهتر از شماره تلفن های معمولی است و می تواند برای آدرس دهی پیام ها در سیستم های MMS و 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

وضعیت تأیید تلفن

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED مقدار پیش فرض این مقدار استفاده نشده است.
PHONE_VERIFICATION_STATE_VERIFIED گوشی تایید شده است.
PHONE_VERIFICATION_STATE_UNVERIFIED گوشی تایید نشده است

خدمات مشتری

اطلاعات خدمات مشتری

نمایندگی JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
فیلدها
uri

string

اختیاری. URI که در آن خدمات مشتری ممکن است پیدا شود.

email

string

اختیاری. آدرس ایمیلی که ممکن است به خدمات مشتری دسترسی پیدا کند.

phone

object ( PhoneNumber )

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

،

جمع آوری اطلاعات مربوط به یک کسب و کار.

نمایندگی 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-XXXXXX از هم جدا شده است.

آدرس پستی

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

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

توصیه‌هایی در مورد ورودی/ویرایش آدرس: - از ویجت آدرس آماده بین‌المللی‌سازی مانند https://github.com/google/libaddressinput استفاده کنید - به کاربران نباید عناصر رابط کاربری برای ورودی یا ویرایش فیلدها در خارج از کشورهایی که آن فیلد وجود دارد ارائه شود. استفاده می شود.

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرح، لطفاً به این آدرس مراجعه کنید: https://support.google.com/business/answer/6397478

نمایندگی JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
فیلدها
revision

integer

بازبینی طرحواره PostalAddress . این باید روی 0 تنظیم شود که آخرین ویرایش است.

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

regionCode

string

مورد نیاز. کد منطقه CLDR کشور/منطقه آدرس. این هرگز استنباط نمی شود و اطمینان از صحیح بودن مقدار به عهده کاربر است. برای جزئیات به https://cldr.unicode.org/ و https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس.

languageCode

string

اختیاری. کد زبان BCP-47 محتویات این آدرس (در صورت شناخته شدن). این اغلب زبان رابط کاربری فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورد استفاده در کشور/منطقه آدرس یا معادل‌های نویسه‌گردانی شده آنها مطابقت داشته باشد. این می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر روی اعتبارسنجی یا سایر عملیات مرتبط با قالب‌بندی تأثیر نمی‌گذارد.

اگر این مقدار مشخص نیست، باید حذف شود (به جای تعیین یک پیش فرض احتمالاً نادرست).

مثال: "zh-Hant"، "ja"، "ja-Latn"، "en".

postalCode

string

اختیاری. کد پستی آدرس همه کشورها از وجود کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر قسمت‌های آدرس (مثلاً اعتبارسنجی ایالت/زیپ در ایالات متحده آمریکا) ایجاد کنند.

sortingCode

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است، که به صورت اختیاری با یک عدد دنبال می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی، نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر ناحیه تحویل» است. (مالاوی) یا «نشانگر اداره پست» (مثلاً ساحل عاج).

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

شماره تلفن

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

این نمایندگی:

  • نباید برای قالب‌بندی محلی شماره تلفن، مانند «+1 (650) 253-0000 داخلی 123» استفاده شود.

  • برای ذخیره سازی کارآمد طراحی نشده است

  • ممکن است برای شماره گیری مناسب نباشد - کتابخانه های تخصصی (به منابع مراجعه کنید) باید برای تجزیه شماره برای آن منظور استفاده شود

برای انجام کاری معنادار با این شماره، مانند قالب بندی آن برای موارد مختلف، ابتدا آن را به یک شی i18n.phonenumbers.PhoneNumber تبدیل کنید.

به عنوان مثال، در جاوا این خواهد بود:

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

پسوند شماره تلفن این افزونه در توصیه های ITU استاندارد نشده است، به جز اینکه به عنوان یک سری اعداد با طول حداکثر 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

کد کوتاه

یک شی نشان دهنده یک کد کوتاه، که شماره تلفنی است که معمولاً بسیار کوتاهتر از شماره تلفن های معمولی است و می تواند برای آدرس دهی پیام ها در سیستم های MMS و 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

وضعیت تأیید تلفن

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED مقدار پیش فرض این مقدار استفاده نشده است.
PHONE_VERIFICATION_STATE_VERIFIED گوشی تایید شده است.
PHONE_VERIFICATION_STATE_UNVERIFIED گوشی تایید نشده است

خدمات مشتری

اطلاعات خدمات مشتری

نمایندگی JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
فیلدها
uri

string

اختیاری. URI که در آن خدمات مشتری ممکن است پیدا شود.

email

string

اختیاری. آدرس ایمیلی که ممکن است به خدمات مشتری دسترسی پیدا کند.

phone

object ( PhoneNumber )

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

،

جمع آوری اطلاعات مربوط به یک کسب و کار.

نمایندگی 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-XXXXXX از هم جدا شده است.

آدرس پستی

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

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

توصیه‌هایی در مورد ورودی/ویرایش آدرس: - از ویجت آدرس آماده بین‌المللی‌سازی مانند https://github.com/google/libaddressinput استفاده کنید - به کاربران نباید عناصر رابط کاربری برای ورودی یا ویرایش فیلدها در خارج از کشورهایی که آن فیلد وجود دارد ارائه شود. استفاده می شود.

برای راهنمایی بیشتر در مورد نحوه استفاده از این طرح، لطفاً به این آدرس مراجعه کنید: https://support.google.com/business/answer/6397478

نمایندگی JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
فیلدها
revision

integer

بازبینی طرحواره PostalAddress . این باید روی 0 تنظیم شود که آخرین ویرایش است.

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

regionCode

string

مورد نیاز. کد منطقه CLDR کشور/منطقه آدرس. این هرگز استنباط نمی شود و اطمینان از صحیح بودن مقدار به عهده کاربر است. برای جزئیات به https://cldr.unicode.org/ و https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html مراجعه کنید. مثال: "CH" برای سوئیس.

languageCode

string

اختیاری. کد زبان BCP-47 محتویات این آدرس (در صورت شناخته شدن). این اغلب زبان رابط کاربری فرم ورودی است یا انتظار می‌رود با یکی از زبان‌های مورد استفاده در کشور/منطقه آدرس یا معادل‌های نویسه‌گردانی شده آنها مطابقت داشته باشد. این می‌تواند بر قالب‌بندی در برخی کشورها تأثیر بگذارد، اما برای صحت داده‌ها حیاتی نیست و هرگز بر روی اعتبارسنجی یا سایر عملیات مرتبط با قالب‌بندی تأثیر نمی‌گذارد.

اگر این مقدار مشخص نیست، باید حذف شود (به جای تعیین یک پیش فرض احتمالاً نادرست).

مثال: "zh-Hant"، "ja"، "ja-Latn"، "en".

postalCode

string

اختیاری. کد پستی آدرس همه کشورها از وجود کدهای پستی استفاده نمی‌کنند یا نیاز به وجود کد پستی ندارند، اما در جایی که از آنها استفاده می‌شود، ممکن است اعتبار سنجی اضافی را با سایر قسمت‌های آدرس (مثلاً اعتبارسنجی ایالت/زیپ در ایالات متحده آمریکا) ایجاد کنند.

sortingCode

string

اختیاری. کد مرتب‌سازی اضافی، خاص کشور. این در اکثر مناطق استفاده نمی شود. در جایی که از آن استفاده می‌شود، مقدار یا رشته‌ای مانند «CEDEX» است، که به صورت اختیاری با یک عدد دنبال می‌شود (مثلاً «CEDEX 7»)، یا فقط یک عدد به تنهایی، نشان‌دهنده «کد بخش» (جامائیکا)، «نشانگر ناحیه تحویل» است. (مالاوی) یا «نشانگر اداره پست» (مثلاً ساحل عاج).

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

شماره تلفن

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

این نمایندگی:

  • نباید برای قالب‌بندی محلی شماره تلفن، مانند «+1 (650) 253-0000 داخلی 123» استفاده شود.

  • برای ذخیره سازی کارآمد طراحی نشده است

  • ممکن است برای شماره گیری مناسب نباشد - کتابخانه های تخصصی (به منابع مراجعه کنید) باید برای تجزیه شماره برای آن منظور استفاده شود

برای انجام کاری معنادار با این شماره، مانند قالب بندی آن برای موارد مختلف، ابتدا آن را به یک شی i18n.phonenumbers.PhoneNumber تبدیل کنید.

به عنوان مثال، در جاوا این خواهد بود:

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

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

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

kind Union Field. مورد نیاز. یا یک شماره معمولی یا یک کد کوتاه. زمینه های جدید ممکن است در آینده به موارد زیر اضافه شود ، بنابراین مشتریان باید شماره تلفن هایی را که هیچ یک از زمینه هایی که آنها را کدگذاری کرده اند ، نادیده بگیرند ، نادیده بگیرند. kind فقط می تواند یکی از موارد زیر باشد:
e164Number

string

شماره تلفن ، به عنوان یک علامت به علاوه پیشرو ('+') و به دنبال آن یک شماره تلفن که از یک فرمت آرام ITU E.164 متشکل از کد فراخوانی کشور (1 تا 3 رقم) و شماره مشترک استفاده می کند ، بدون شماره اضافی ، فضاها یا قالب بندی ، به عنوان مثال: - صحیح: "+15552220123" - نادرست: "+1 (555) 222-01234 x123".

فرمت ITU E.164 دومی را به 12 رقم محدود می کند ، اما در عمل همه کشورها به آن احترام نمی گذارند ، بنابراین ما این محدودیت را در اینجا آرام می کنیم. اعداد فقط ملی مجاز نیست.

منابع: - https://www.itu.int/rec/trec-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

کد کوتاه

یک شیء که یک کد کوتاه را نشان می دهد ، که یک شماره تلفن است که به طور معمول بسیار کوتاه تر از شماره تلفن های معمولی است و می تواند برای پرداختن به پیام ها در سیستم های MMS و SMS و همچنین برای شماره گیری مختصر استفاده شود (به عنوان مثال "متن 611 برای دیدن چند دقیقه شما در برنامه خود باقی مانده اید. ").

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

نمایندگی JSON 
{
  "regionCode": string,
  "number": string
}
فیلدها
regionCode

string

مورد نیاز. کد منطقه BCP-47 از مکان که در آن می توان به این کد کوتاه تماس گرفت ، مانند "ما" و "BB".

مرجع (ها): - http://www.unicode.org/reports/tr35/#unicode_region_subtag

number

string

مورد نیاز. رقم های کوتاه کد ، بدون پیشرو به علاوه ('+') یا کد فراخوانی کشور ، به عنوان مثال "611".

تلفن

وضعیت تأیید تلفن

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED مقدار پیش فرض این مقدار بلااستفاده است.
PHONE_VERIFICATION_STATE_VERIFIED تلفن تأیید شده است.
PHONE_VERIFICATION_STATE_UNVERIFIED تلفن تأیید نشده است

مشتریان

اطلاعات خدمات مشتری.

نمایندگی JSON 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
فیلدها
uri

string

اختیاری. URI که در آن خدمات مشتری پیدا می شود.

email

string

اختیاری. آدرس ایمیل که در آن ممکن است به خدمات مشتری برسد.

phone

object ( PhoneNumber )

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