נהל אימות

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

קבלת המצב הנוכחי

המשתמשים יכולים להתקשר אל 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"
  }
}

אחזור האימותים הנוכחיים

הקריאה ל-API‏ 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, אפשר להטמיע את הפלטפורמה שלכם כדי לספק פונקציונליות של יצירת מיקומים. כשמבקשים ממוֹכרים להוסיף מיקום חדש, חשוב לפעול לפי השלבים הבאים:

איסוף פרטי מיקום כמו שם העסק, הכתובת והקטגוריה מהמוֹכר.

1. מתקשרים לנקודת הקצה googleLocations.search.
2. בבקשת ה-API, צריך לספק נתוני מיקום כמו שם העסק, הקטגוריה, הכתובת, מספר הטלפון וכתובת האתר.

אפשר גם לחפש מיקום תואם פוטנציאלי לפי השלבים הבאים:

1. חיפוש התאמות אפשריות של מיקומים.
2. מבקשים מהמוֹכר לבחור את המיקום הנכון.
3. אם הערך requestAdminRightsUrl קיים בתגובת המיקום, צריך לעזור למוֹכרים לבקש גישה ובעלות על המיקום הזה בפרופיל העסק ב-Google.
4. אם requestAdminRightsUrl לא קיים, יוצרים מיקום חדש עם מזהה המקום בתגובה של המיקום.
5. מאמתים את המיקום החדש.

הערה: אם לא מתקבלים מיקומים תואמים מהשאילתה הראשונית, אפשר להשתמש במזהה מקום ריק כדי ליצור מיקום חדש. לאחר מכן, מאמתים את המיקום החדש.

אימות מיקום

כדי להתחיל בתהליך האימות באמצעות GBP API, צריך לפעול לפי השלבים הבאים:

1. מתקשרים לשיטה accounts.locations.list כדי להציג את כל המיקומים בחשבון Google.
2. בוחרים מיקום לאימות.
3. כדי לוודא אם נדרש אימות של המיקום, מתקשרים לשיטת ה-API‏ GetVoiceOfMerchant.
4. אם התשובה היא verify, מתקשרים אל fetchVerificationOptions כדי לקבל רשימה של שיטות שזמינות לאימות המיקום.
5. בודקים שוב שנתוני verificationOption כוללים את הכתובת, מספר הטלפון וכתובת האימייל הנכונים.
6. אחרי שהמוֹכר בוחר את אפשרות האימות הכי טובה שזמינה, צריך להפעיל את שיטת locations.verify כדי להתחיל את האימות המתאים. כדי לוודא שההפעלה מתבצעת, מתקשרים אל locations.verifications.list.
7. מתקשרים לשיטה locations.verification.complete עם קוד האימות של המוכר.
8. קוראים ל-method של ה-API ‏GetVoiceOfMerchant. אם מופיע HasVoiceOfMerchant = true, סימן שהצלחתם לאמת את המיקום.

הערה: אם AUTO אימות זמין למיקום, המוכר לא צריך לבצע שלבי אימות

מידע נוסף על אימות פרופיל ב-GBP זמין במאמר הזה במרכז העזרה.