מיקומים של Google

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

נקודת הקצה של ה-API מחזירה כתובת URL שמציינת אם כבר נתבעה בעלות על מיקום. אם כבר נתבעה בעלות על אותה כתובת URL, תוכלו להתחיל בתהליך בקשת הגישה.

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

איור 1. תרשים שחייה של בעלות המיקום בדף העסקי

השלבים הבאים מאפשרים לך להשתמש ב-API של GoogleLocations:

  1. איסוף נתוני מיקום מהמוכר.

  2. יש להתקשר לנקודת הקצה googleLocations.search. יש לספק את נתוני המיקום בגוף השיחה. לחלופין, אפשר לספק אותו במחרוזת שאילתה, בדומה למה שהמשתמש מזין בחיפוש או במפות. לדוגמה, "Starbucks 5th Ave NYC."

    ה-API מחזיר רשימה של מיקומים שעשויים להתאים ומידע על כל מיקום, כמו locationName וכתובת.

  3. בוחרים את המיקום שתואם למיקום. אם אין התאמות, מתקשרים accounts.locations.create, ומדלגים לשלב 5.

  4. יש לבצע את הפעולות הבאות בהתאם למצב של requestAdminRightsUrl בתגובה:

    1. אם העסק requestAdminRightsUrl קיים, למשתמש אחר יש בעלות על פרופיל העסק. צריך להפנות את המוכר לכתובת ה-URL כדי להתחיל לבקש גישה לבעלות על המיקום הקיים ב'פרופיל העסק ב-Google'.
    2. אם הדומיין requestAdminRightsUrl לא קיים, צריך להתקשר accounts.locations.create וליצור דף עסקי חדש שיאומת מאוחר יותר.
  5. אם יצרת דפים עסקיים חדשים כחלק מהתהליך הזה, אפשר להשתמש בממשקי ה-API לאימות כדי להתחיל את תהליך האימות של כרטיסי המוצר. מידע נוסף זמין במאמר ניהול האימות.