אוסף של מידע שקשור לעסק.
ייצוג JSON |
---|
{ "name": string, "address": { object ( |
שדות | |
---|---|
name |
מזהה. שם המשאב של פרטי העסק. פורמט: |
address |
זה שינוי אופציונלי. כתובת העסק. |
phone |
פלט בלבד. מספר הטלפון של העסק. |
phoneVerificationState |
פלט בלבד. מצב האימות הטלפוני של העסק. |
customerService |
זה שינוי אופציונלי. שירות הלקוחות של העסק. |
koreanBusinessRegistrationNumber |
זה שינוי אופציונלי. מספר רישום לעסק בקוריאה בן 10 ספרות שמופרד במקפים בפורמט: XXX-XX-XXXXX. |
PostalAddress
מייצג כתובת למשלוח דואר, למשל עבור כתובות למשלוח דואר או תשלומים. אם תספקו כתובת למשלוח דואר, שירות הדואר יכול לשלוח פריטים לעסק שלכם, P.O. Box או דומה. הוא לא נועד לבנות מודלים של מיקומים גיאוגרפיים (כבישים, ערים, הרים).
בשימוש אופייני, כתובת תיווצר על ידי קלט של משתמשים או על ידי ייבוא נתונים קיימים, בהתאם לסוג התהליך.
עצות לגבי קלט / עריכה של כתובת: - שימוש בווידג'ט כתובת שמוכן ללוקליזציה כמו 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 |
הגרסה הקודמת של הסכימה של כל הגרסאות החדשות חייבות להיות תואמות לאחור לגרסאות קודמות. |
regionCode |
חובה. קוד האזור במאגר CLDR של המדינה או האזור של הכתובת. אף פעם לא מסיקים את זה, ובאחריות המשתמש לוודא שהערך נכון. פרטים נוספים זמינים בכתובת https://cldr.unicode.org/ ובכתובת https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. דוגמה: 'CH' עבור שווייץ. |
languageCode |
זה שינוי אופציונלי. קוד שפה BCP-47 של תוכן הכתובת הזו (אם ידוע). לרוב זוהי שפת ממשק המשתמש של טופס הקלט, או שהיא אמורה להתאים לאחת מהשפות שציינת בכתובת מדינה/אזור, או את המקבילים בתעתיק שלהם. הפעולה הזו יכולה להשפיע על הפורמט במדינות מסוימות, אבל היא לא קריטית לנכונות של הנתונים ולא תשפיע אף פעם על אימות או על פעולות אחרות שלא קשורות לעיצוב. אם הערך לא ידוע, יש להשמיט אותו (במקום לציין ברירת מחדל שעשויה להיות שגויה). דוגמאות: 'zh-Hant', 'ja', 'ja-Latn', 'en'. |
postalCode |
זה שינוי אופציונלי. המיקוד של הכתובת. לא בכל המדינות נעשה שימוש במספרי המיקוד או שחובה לציין אותם, אבל במקומות שבהם נעשה שימוש בתכונה הזו, המערכת עשויה להפעיל אימות נוסף בחלקים אחרים של הכתובת (למשל, אימות מדינה או מיקוד בארה"ב). |
sortingCode |
זה שינוי אופציונלי. קוד מיון נוסף ספציפי למדינה. ברוב האזורים לא נעשה שימוש בהרשאה הזו. במקומות שבהם משתמשים בו, הערך הוא מחרוזת כמו CEDEX, ואחריו מספר (למשל CEDEX 7) או מספר בלבד, שמייצג את 'קוד המגזר'. (ג'מייקה), "אינדיקטור אזור למשלוחים" (מלאווי) או "אינדיקטור של סניף דואר" (למשל, חוף השנהב). |
administrativeArea |
זה שינוי אופציונלי. חלוקת המשנה האדמיניסטרטיבית הגבוהה ביותר שמשמשת לכתובות דואר של מדינה או אזור. לדוגמה, סוג המשנה יכול להיות מדינה, מחוז, אובלסט או מחוז. באופן ספציפי, בספרד מדובר במחוז ולא בקהילה האוטונומית (למשל, "ברצלונה" ולא "קטלוניה"). במדינות רבות לא נעשה שימוש באזור מנהלי בכתובות דואר. לדוגמה בשווייץ, אין למלא את השדה הזה. |
locality |
זה שינוי אופציונלי. מתייחס באופן כללי לחלק של העיר או העיר בכתובת. דוגמאות: עיר בארה"ב, קהילת IT, עיר דואר בבריטניה. באזורים בעולם שבהם רשויות מוניציפאליות לא מוגדרות היטב או שלא מתאימות למבנה הזה בצורה טובה, השאירו את הרשות המוניציפאלית ריקה והשתמשו בקווי כתובת. |
sublocality |
זה שינוי אופציונלי. אזור המשנה של הכתובת. לדוגמה, המאפיינים יכולים להיות שכונות, רובעים או מחוזות. |
addressLines[] |
שורות כתובת לא מובנות, שמתארות את הרמות הנמוכות יותר של כתובת. מכיוון שערכים ב-addressLines לא כוללים פרטי סוג ולפעמים הם עשויים להכיל ערכים מרובים בשדה יחיד (למשל "Austin, TX"), חשוב שסדר השורות יהיה ברור. סדר שורות הכתובת צריך להיות "סדר מעטפה" עבור המדינה/האזור של הכתובת. במקומות שבהם הערך הזה יכול להשתנות (למשל, יפן), משתמשים ב-address_language כדי לציין אותה באופן מפורש (למשל 'ja' לסידור מהגדול לקטן ו-'ja-Latn' או 'en' לקטן לגדול). כך ניתן לבחור את שורת הכתובת הספציפית ביותר בהתאם לשפה. הייצוג המבני המינימלי המותר של כתובת מורכב מ-regionCode עם כל שאר המידע שמוצב בשורות הכתובת. ניתן יהיה לעצב כתובת כזו באופן מאוד ללא קידוד גיאוגרפי, אבל לא ניתן יהיה לספק נימוק סמנטי לגבי אף אחד מרכיבי הכתובת עד לפתרון חלקי של הבעיה. יצירת כתובת שמכילה רק regionCode ושורות כתובת, ולאחר מכן קידוד גיאוגרפי היא הדרך המומלצת לטיפול בכתובות לא מובנות לחלוטין (בניגוד לניחוש אילו חלקים של הכתובת צריכים להיות רשויות מוניציפאליות או אזורים מנהליים). |
recipients[] |
זה שינוי אופציונלי. הנמען בכתובת. בנסיבות מסוימות השדה הזה יכול להכיל מידע על כמה שורות. לדוגמה, יכול להיות שהשם כולל את המונח 'טיפול ב-' מידע. |
organization |
זה שינוי אופציונלי. שם הארגון בכתובת. |
מספר טלפון
אובייקט שמייצג מספר טלפון, מתאים בפורמט של כבל API.
הייצוג הזה:
אין להשתמש בפורמט הזה לציון מספר טלפון בפורמט ספציפי ללוקאל, למשל +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 |
שדות | |
---|---|
extension |
התוסף של מספר הטלפון. התוסף לא סטנדרטי בהמלצות ITU, למעט שהוא מוגדר כסדרת מספרים באורך מקסימלי של 40 ספרות. מלבד ספרות, כמה תווי חיוג אחרים כגון , (מציין המתנה) או '#' . הערה: אף אזור לא משתמש כרגע בתוספים עם קודים קצרים, ולכן בדרך כלל השדה הזה מוגדר רק יחד עם מספר E.164. הוא נשמר בנפרד ממספר E.164 כדי לאפשר שימוש בתוספי קוד קצרים בעתיד. |
שדה איחוד kind . חובה. מספר רגיל או קוד מקוצר. יכול להיות שבעתיד יתווספו שדות חדשים לאחד מהשדות שלמטה, לכן על הלקוחות להתעלם ממספרי טלפון שלא מוגדר עבורם אף אחד מהשדות שהם מקודדים. kind יכול להיות רק אחת מהאפשרויות הבאות: |
|
e164Number |
מספר הטלפון, מיוצג באמצעות סימן פלוס ('+') ואחריו מספר טלפון בפורמט רגוע של 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 |
קוד מקוצר. קובצי עזר: – https://en.wikipedia.org/wiki/Short_code |
ShortCode
אובייקט שמייצג קוד מקוצר, שהוא מספר טלפון שבדרך כלל קצר בהרבה ממספרי טלפון רגילים, ואפשר להשתמש בו כדי לטפל בהודעות במערכות MMS ו-SMS, וגם לחיוג מקוצר (למשל, "Text 611 כדי לראות כמה דקות נותרו לך בתוכנית").
המספרים המקוצרים מוגבלים לאזור ואי אפשר להתקשר בהם בכל העולם. כלומר, אותו קוד מקוצר יכול להיות קיים באזורים שונים, עם אופן שימוש ותמחור שונים, גם אם קידומת החיוג של המדינה זהה (למשל, ארה"ב וקנדה).
ייצוג JSON |
---|
{ "regionCode": string, "number": string } |
שדות | |
---|---|
regionCode |
חובה. קוד האזור BCP-47 של המיקום שבו ניתן לבצע שיחות למספר המקוצר הזה, למשל "US" ו-'BB'. קובצי עזר: - http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
חובה. הספרות הקצרות, ללא סימן פלוס ('+') בהתחלה או קידומת מדינה, למשל: '611'. |
PhoneVerificationState
מצב האימות של מספר הטלפון.
טיפוסים בני מנייה (enum) | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
ערך ברירת המחדל. הערך הזה לא בשימוש. |
PHONE_VERIFICATION_STATE_VERIFIED |
מספר הטלפון מאומת. |
PHONE_VERIFICATION_STATE_UNVERIFIED |
הטלפון לא מאומת |
CustomerService
מידע על שירות הלקוחות.
ייצוג JSON |
---|
{
"uri": string,
"email": string,
"phone": {
object ( |
שדות | |
---|---|
uri |
זה שינוי אופציונלי. ה-URI שבו ניתן למצוא את שירות הלקוחות. |
email |
זה שינוי אופציונלי. כתובת האימייל שבאמצעותה ניתן ליצור קשר עם שירות הלקוחות. |
phone |
זה שינוי אופציונלי. מספר הטלפון שאליו ניתן להתקשר לשירות הלקוחות. |