נהל אימות

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

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

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

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

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

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

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

{
  "languageCode": "en"
}

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

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

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

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

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"
}

שיטות מומלצות לאימות פרופיל העסק ב-Google באמצעות API

יצירת מיקום

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

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

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

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

  1. חיפוש נתוני מיקומים אפשריים.
  2. מבקשים מהמוכר לבחור את המיקום הנכון.
  3. אם requestAdminRightsUri קיים ב-GoogleLocation התואם, צריך לעזור למוכר לבקש גישה ובעלות על המיקום הזה בפרופיל העסק ב-Google.
  4. אם requestAdminRightsUri לא קיים, צריך להתקשר אל accounts.locations.create באמצעות הפרטים של location מה-GoogleLocation התואם.
  5. מאמתים את המיקום החדש.

הערה: אם לא קיבלתם התאמות אפשריות למיקום מהשאילתה הראשונית, התקשרו אל accounts.locations.create עם פרטי המיקום שנאספו מהמוכר, ואז אשרו את המיקום החדש.

אימות מיקום

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

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

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

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