ספקים שמציעים ניהול של כרטיסי מוצר ישירות בפלטפורמה שלהם יכולים לאמת את העסק של המוכר באתר שלהם. כך לא צריך להפנות את המוכר לממשק המשתמש של פרופיל העסק.
קבלת המצב הנוכחי
המשתמשים יכולים להפעיל את locations.getVoiceOfMerchantState במיקום מסוים כדי לאחזר את הסטטוס הנוכחי שלו. אם הערך הבוליאני של hasVoiceOfMerchant הוא true, המיקום כבר במצב תקין ואין צורך בפעולה נוספת. אחרת, אם התגובה כוללת אובייקט verify, צריך להשלים את האימות. כדי לקבל מידע נוסף, פועלים לפי ההוראות בקטעים הבאים.
אחזור של אפשרויות האימות
ספקים יכולים להשתמש ב-locations.fetchVerificationOptions כדי לבקש מהמוכרים לבחור את הדרך המועדפת ליצירת קשר מתוך רשימה של שיטות אימות זמינות.
כדי לאחזר את אפשרויות האימות, משתמשים בשיטה הבאה:
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}:fetchVerificationOptions
{
"languageCode": "en"
}
התחלת תהליך האימות
אחרי שבוחרים שיטת אימות, מתחילים את תהליך האימות באמצעות locations.verify.
כתוצאה מהקריאה הזו, המיקום עובר למצב מאומת או שמוחזר סטטוס שגיאה.
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}:verify
// Use only one of the verification methods below
// For postcard verification:
{
"method": "ADDRESS",
"languageCode": "en",
"mailerContact": "Ann Droyd"
}
// For phone verification:
{
"method": "PHONE_CALL",
"languageCode": "en",
"phoneNumber": "800-555-0136"
}
// For SMS verification:
{
"method": "SMS",
"languageCode": "en",
"phoneNumber": "800-555-0136"
}
// For email verification:
{
"method": "EMAIL",
"languageCode": "en",
"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"
}
שיטות מומלצות לאימות פרופיל העסק ב-Google באמצעות API
יצירת מיקום
באמצעות Business Information API של פרופיל העסק ב-Google, אתם יכולים להטמיע את הפלטפורמה שלכם כדי לספק פונקציונליות של יצירת מיקום. כשאתם מבקשים ממוכרים להוסיף מיקום חדש, חשוב לפעול לפי השלבים הבאים:
אוספים מהמוכר את פרטי המיקום, כמו שם העסק, הכתובת והקטגוריה.
- מבצעים קריאה לנקודת הקצה
googleLocations.search. - בבקשת ה-API, צריך לספק נתוני מיקום, כמו שם העסק, הקטגוריה, הכתובת, מספר הטלפון והאתר.
לחלופין, אפשר לחפש מיקום פוטנציאלי תואם לפי השלבים הבאים:
- חיפוש נתוני מיקומים אפשריים.
- מבקשים מהמוכר לבחור את המיקום הנכון.
- אם
requestAdminRightsUriקיים ב-GoogleLocationהתואם, צריך לעזור למוכר לבקש גישה ובעלות על המיקום הזה בפרופיל העסק ב-Google. - אם
requestAdminRightsUriלא קיים, צריך להתקשר אלaccounts.locations.createבאמצעות הפרטים שלlocationמה-GoogleLocationהתואם. - מאמתים את המיקום החדש.
הערה: אם לא קיבלתם התאמות אפשריות למיקום מהשאילתה הראשונית, התקשרו אל accounts.locations.create עם פרטי המיקום שנאספו מהמוכר, ואז אשרו את המיקום החדש.
אימות מיקום
כדי להתחיל את תהליך האימות באמצעות GBP API, פועלים לפי השלבים הבאים:
- מפעילים את השיטה
accounts.locations.listכדי להציג את כל המיקומים של חשבון Google. - בוחרים מיקום לאימות.
- מפעילים את ה-method
locations.getVoiceOfMerchantStateב-API כדי לבדוק אם המיקום הזה דורש אימות. - אם התשובה מכילה את הערך
verify, צריך להפעיל את השיטהlocations.fetchVerificationOptionsכדי לקבל רשימה של השיטות הזמינות לאימות המיקום הזה. - חשוב לוודא שהנתונים של
VerificationOptionכוללים את הכתובת, מספר הטלפון וכתובת האימייל הנכונים. - אחרי שהמוכר בוחר את שיטת האימות הכי טובה שזמינה, מפעילים את ה-method
locations.verifyכדי להתחיל את האימות המתאים. כדי לוודא שההפעלה מתבצעת, קוראים ל-locations.verifications.list. - מפעילים את השיטה
locations.verifications.completeעם קוד האימות של המוכר. - מפעילים את ה-method
locations.getVoiceOfMerchantStateב-API. אם הערך שלhasVoiceOfMerchantהואtrue, המיקום אומת בהצלחה.
הערה: אם אימות AUTO זמין למיקום, המוכר לא צריך לבצע שלבי אימות.
מידע נוסף על אימות GBP זמין במאמר התמיכה הזה במרכז העזרה.