נהל אימות

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

אחזור המצב הנוכחי

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

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

ספקים יכולים להשתמש ב-method‏ 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

יצירת מיקום

באמצעות ה-API של פרטי העסק ב-GBP, אפשר להטמיע את הפלטפורמה שלכם כדי לספק פונקציונליות ליצירת מיקומים. כשמבקשים מהמוכרים להוסיף מיקום חדש, חשוב לפעול לפי השלבים הבאים:

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

  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. קוראים ל-method‏ locations.verification.complete עם מספר ה-pin של המוכר.
  8. קוראים לשיטת ה-API GetVoiceOfMerchant. אם הערך הוא HasVoiceOfMerchant = true, סימן שהמיקום אומת.

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

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

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