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

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

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

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

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

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

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

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

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

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

1. בתהליך ההסכמה הקיים שלכם בנושא OAuth, שבו בעלים של חשבון 'פרופיל העסק ב-Google' מעניק לכם גישה לקריאות ל-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 מבוססת Sunvale", אבל הוא לא תואם ל-"Bakery Takery".

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

4. מול הנציג שיצרתם ואסימון OAuth שקיבלתם, מבקשים אימות של הנציג.

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

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

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

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

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

6. הפעלת הנציג עם נקודת הכניסה LOCATION.

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

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