נהל אימות

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

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

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

שיטות מומלצות לאימות פאונד באמצעות API

יצירת מיקום

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

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

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

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

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

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

אימות מיקום

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

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

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

למידע נוסף על אימות ליש"ט, אפשר לעיין במאמר התמיכה במרכז העזרה.

מדריך לשיטות האימות לשותפים מוסמכים