נהל אימות

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

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

המשתמשים יכולים להתקשר ל-locations.getVoiceOfMerchantState ממיקום מסוים כדי לאחזר את הסטטוס הנוכחי שלו. אם הערך הבוליאני hasVoiceOfMerchant הוא true, פירוש הדבר הוא שהמיקום כבר מנוהל באופן תקין ואין צורך בפעולה נוספת. אחרת, אם הפעולה gain_voice_of_merchant בתשובה מכילה verify, עליך להשלים את האימות. לקבלת מידע נוסף, יש לפעול לפי ההוראות שבהמשך.

אפשרויות אימות אחזור

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

כך מאחזרים את אפשרויות האימות:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

התחלת תהליך האימות

אחרי שבוחרים שיטת אימות, מתחילים את תהליך האימות באמצעות locations.verify. בעקבות השיחה, המיקום עובר למצב מאומת או שמוחזר סטטוס שגיאה.

HTTP
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 מאחזרת את היסטוריית בקשות האימות יחד עם הסטטוס שלהן לגבי המיקום שצוין בשיחה.

כדי לאחזר את כל בקשות האימות, יש להשתמש באפשרויות הבאות:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

השלמת אימות בהמתנה

בדרך כלל נדרשים קוד אימות והשיטה locations.verifications.complete כדי להשלים את האימות של עסק.

כדי להשלים אימות בהמתנה, צריך להשתמש בפרטים הבאים:

HTTP
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. אם התשובה היא "אימות", צריך להתקשר אל fetchVerificationOptions כדי לקבל רשימה של שיטות לאימות המיקום.
  5. יש לוודא שנתוני verificationOption כוללים את הכתובת, מספר הטלפון וכתובת האימייל הנכונים.
  6. אחרי שהמנגנון בוחר את אפשרות האימות הזמינה הטובה ביותר, צריך להפעיל את השיטה locations.verify כדי להתחיל את האימות המתאים. כדי לוודא שההפעלה מתבצעת, צריך להתקשר ל-locations.verifications.list.
  7. מפעילים את השיטה locations.verification.complete עם קוד האימות של המוכר.
  8. קוראים ל-method GetVoiceOfMerchant של ה-API. אם HasVoiceOfMerchant = true, אימת בהצלחה את המיקום.

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

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

מדריך לשיטות אימות לשותפים שעברו בדיקה