הוספת מיקומים מפרופיל העסק

פרופיל העסק הוא כלי חינמי וקל לשימוש שמאפשר לעסקים ולארגונים לנהל את הנוכחות שלהם באינטרנט ב-Google, כולל בחיפוש Google ובמפות Google.

Google Business Profile API מספק ממשק לניהול פרטי המיקום של העסק ב-Google. עסק יכול להעניק גישה באמצעות הסכמה ל-OAuth לעסק אחר כדי לנהל את הפרופיל שלו בשם העסק.

עסקים מנוהלים ב'פרופיל העסק ב-Google' כבר אומתו באמצעות תהליך האימות של פרופיל העסק. אתם יכולים להרחיב את תהליך ההסכמה של OAuth בפרופיל העסק כדי לצרף את העסקים האלה ל-Business Messages ולאמת אותם באופן אוטומטי לקראת ההשקה ב-Business Messages.

זוהי שיטה מהירה יותר וניתנת להתאמה כדי להפעיל את Business Messages, והיא התהליך המומלץ להפעלת העברת הודעות במיקום של פרופיל העסק.

דרישות מוקדמות

עליכם להיות שותפים קיימים של 'פרופיל העסק ב-Google' עם גישה לממשקי ה-API של 'פרופיל העסק ב-Google'. אם לא, עליכם לפעול לפי הדרישות המוקדמות לפרופיל העסק כדי להגיש בקשה לקבלת גישה.

אחרי שתקבלו גישה ל-Google Business Profile API, עליכם לפעול לפי המדריכים להגדרה הבסיסית ולהגדרת OAuth לפני שתמשיכו.

הפעלת Business Messages במיקום מאומת בפרופיל העסק

התרשים הבא מראה איך שירות האינטרנט שלכם יכול להשתמש באימות המיקום של פרופיל העסק של המותג עבור נציג של Business Messages. בהמשך מפורטות הוראות מפורטות.

1. בתהליך ההסכמה הקיים של OAuth, שבו הבעלים של חשבון פרופיל העסק מעניק לכם גישה לקריאה לממשקי ה-API של פרופיל העסק ב-Google בשמם, מעדכנים את היקפי הרשאות ה-API כך שיכללו את

   • https://www.googleapis.com/auth/business.manage
   • https://www.googleapis.com/auth/businesscommunications

   צריך את שני ההיקפים כדי לבצע אימות אוטומטי של הנציג ומיקומי העסק.

2. יוצרים סוכן עם displayName שתואם לשם של לפחות אחד מהדפים ב'פרופיל העסק ב-Google' שבבעלות פרטי הכניסה ל-OAuth שקיבלתם בשלב הקודם. מחפשים מיקומים באמצעות Google Business Profile API כדי למצוא את שמות העסקים.

   להתאמת שמות,

   • אין חשיבות לאותיות רישיות או קטנות.
   • השם המלא של הנציג חייב להיות זהה למילה או למילים הראשונות בשם המיקום בפרופיל העסק. לדוגמה, סוכן בשם 'GBP Bakery' תואם ל-'Gbp Bakery Mountain View', ל-'Gbp Bakery' ול-'gbp bakery sunnyvale', אבל לא תואם ל-'Bakery San Francisco'.

3. לכל מיקום בפרופיל העסק, יוצרים מיקום עם אותו placeId. השדה placeId של מיקום בפרופיל העסק נכלל באובייקט LocationKey כשאחזור מיקום מ-Google Business Profile API.

4. בעזרת הסוכן שיצרתם ואסימון ה-OAuth שהתקבל, מבקשים אימות סוכן.

   הערה: עליכם להשתמש באסימון ה-OAuth ברמת היקף כפול שהתקבל, ולא במפתח של חשבון השירות של הפרויקט.

   בבקשת האימות נדרשים פרטים ליצירת קשר עם המותג. עם זאת, תהליך האימות לא ישלח אימייל למותג אם שם הנציג תואם לשם בפרופיל העסק, ואם קיבלתם את אסימון ה-OAuth עם ההיקפים הנכונים.

   אם עשיתם זאת בצורה נכונה, הפלט של בקשת האימות אמור להחזיר verificationState של VERIFICATION_STATE_VERIFIED באופן מיידי. אם הפונקציה verificationState מחזירה ערך שונה, סביר להניח שלא השתמשתם באסימון OAuth הנכון בזמן שליחת הבקשה, או שלא ניתן היה להתאים את הסוכן למיקום של פרופיל העסק.

5. באמצעות אותו אסימון OAuth, מבקשים אימות מיקום לכל המיקומים שבבעלות העסק בפרופיל העסק.

   בדומה לאימות סוכן, אם עשיתם זאת בצורה נכונה, הפלט של בקשת האימות אמור להחזיר verificationState של VERIFICATION_STATE_VERIFIED באופן מיידי. אם הפונקציה verificationState מחזירה ערך שונה, סביר להניח שלא השתמשתם באסימון OAuth הנכון בזמן שליחת הבקשה, או שהמיקום של פרופיל העסק הוא לא עסק שהוגשה לגביו תלונה ועבר אימות.

6. מפעילים את הסוכן באמצעות נקודת הכניסה LOCATION.

7. כדי לאפשר הודעות למיקומים ספציפיים, פותחים את המיקומים שרוצים שיהיו זמינים בחיפוש ובמפות Google. אחרי שתהליך ההשקה יתחיל, ההודעות בכל מיקום שיושק יהיו זמינות למשתמשים תוך כמה שעות.

אחרי שתבצעו את השלבים האלה, כל ההודעות מהצרכנים יפורסמו ב-webhook הרשום של Business Messages, ותצטרכו לשלוח תשובות לצרכנים באמצעות Business Messages API.