ספקים שמציעים ניהול של כרטיסי מוצר ישירות בפלטפורמה שלהם יכולים לאמת את העסק של המוֹכר בתוך האתר שלהם. כך לא צריך להפנות את המוכר לממשק המשתמש של פרופיל העסק.
קבלת המצב הנוכחי
המשתמשים יכולים להתקשר ל-locations.getVoiceOfMerchantState
ממיקום מסוים כדי לאחזר את הסטטוס הנוכחי שלו. אם הערך הבוליאני
hasVoiceOfMerchant
הוא true
, פירוש הדבר הוא שהמיקום כבר מנוהל באופן תקין ואין צורך בפעולה נוספת. אחרת, אם הפעולה gain_voice_of_merchant
בתשובה מכילה verify
, עליך להשלים את האימות. לקבלת מידע נוסף, יש לפעול לפי ההוראות שבהמשך.
אפשרויות אימות אחזור
ספקים יכולים להשתמש בשיטה locations.fetchVerificationOptions
כדי לעודד מוכרים לבחור שיטה מועדפת ליצירת קשר מתוך הרשימה של שיטות האימות הזמינות.
כך מאחזרים את אפשרויות האימות:
POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
התחלת תהליך האימות
אחרי שבוחרים שיטת אימות, מתחילים את תהליך האימות באמצעות
locations.verify
.
בעקבות השיחה, המיקום עובר למצב מאומת או שמוחזר סטטוס שגיאה.
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} :verify // Use only one of the below verification methods // For postcard verification: { "method": "ADDRESS", "languageCode": "en", "addressInput": { "mailerContactName": "Ann Droyd" } } // For phone verification: { "method": "PHONE_CALL", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For SMS verification: { "method": "SMS", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For email verification: { "method": "EMAIL", "languageCode": "en", "emailInput": { "emailAddress": "ex@google.com" } }
אחזור האימותים הנוכחיים
השיחה
locations.verifications.list
מאחזרת את היסטוריית בקשות האימות יחד עם הסטטוס שלהן לגבי המיקום שצוין בשיחה.
כדי לאחזר את כל בקשות האימות, יש להשתמש באפשרויות הבאות:
GET https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications
השלמת אימות בהמתנה
בדרך כלל נדרשים קוד אימות
והשיטה locations.verifications.complete
כדי להשלים את האימות של עסק.
כדי להשלים אימות בהמתנה, צריך להשתמש בפרטים הבאים:
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
שיטות מומלצות לאימות GBP באמצעות API
יצירת מיקום
באמצעות GBP Business Information API, אתם יכולים להטמיע את הפלטפורמה שלכם כדי לספק פונקציונליות של יצירת מיקום. כשמבקשים ממוכרים להוסיף מיקום חדש, חשוב לפעול לפי השלבים הבאים:
לאסוף פרטי מיקום מהמוכר, כמו שם העסק, כתובת וקטגוריה.
- מפעילים את נקודת הקצה
googleLocations.search
. - יש לספק נתוני מיקום, כמו שם העסק, הקטגוריה, הכתובת, מספר הטלפון והאתר של העסק, בבקשה של ה-API.
לחלופין, בצע חיפוש אחר מיקום תואם פוטנציאלי באמצעות השלבים הבאים:
- התאמות אפשריות של מיקומים בשאילתה.
- מבקשים מהמוכר לבחור את המיקום הנכון.
- אם הערך
requestAdminRightsUrl
מופיע בתגובת המיקום, יש לעזור למוכר לבקש גישה למיקום הזה ובעלות עליו בפרופיל העסק ב-Google. - אם המיקום
requestAdminRightsUrl
לא קיים, יש ליצור מיקום חדש עם מזהה המקום בתגובת המיקום. - מאמתים את המיקום החדש.
הערה: אם לא מקבלים התאמות מיקומים אפשריות מהשאילתה הראשונית, צריך להשתמש במזהה מקום ריק כדי ליצור מיקום חדש. לאחר מכן, מאמתים את המיקום החדש.
אימות מיקום
כדי להתחיל את תהליך האימות באמצעות GBP API, צריך לבצע את השלבים הבאים:
- צריך להפעיל את השיטה
accounts.locations.list
כדי להציג את כל המיקומים בחשבון Google. - בוחרים מיקום לאימות.
- מפעילים את שיטת ה-API
GetVoiceOfMerchant
כדי לבדוק אם המיקום דורש אימות. - אם התשובה היא "אימות", צריך להתקשר אל
fetchVerificationOptions
כדי לקבל רשימה של שיטות לאימות המיקום. - יש לוודא שנתוני
verificationOption
כוללים את הכתובת, מספר הטלפון וכתובת האימייל הנכונים. - אחרי שהמנגנון בוחר את אפשרות האימות הזמינה הטובה ביותר, צריך להפעיל את השיטה
locations.verify
כדי להתחיל את האימות המתאים. כדי לוודא שההפעלה מתבצעת, צריך להתקשר ל-locations.verifications.list.
- מפעילים את השיטה
locations.verification.complete
עם קוד האימות של המוכר. - קוראים ל-method
GetVoiceOfMerchant
של ה-API. אםHasVoiceOfMerchant = true
, אימת בהצלחה את המיקום.
הערה: אם קיים אימות של AUTO
למיקום, המוכר לא צריך לבצע פעולות אימות כלשהן
מידע נוסף על אימות GBP זמין במאמר התמיכה במרכז העזרה.