העברת מיקומים

באמצעות My Business Account Management API אפשר להעביר מיקומים לחשבונות שונים או לקבוצות שונות של מיקומים. כדי ללמוד איך לעשות זאת, פעלו לפי ההוראות במסמכי התיעוד האלה.

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

שנתחיל?

כדי להעביר מיקומים, צריך:

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

העברת מיקומים

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

כך מעבירים מיקומים:

1. אם אינך הבעלים של המיקום, עליך להיות מוגדר בתור אחד. משתמשים בפרטי הכניסה OAuth של בעל העסק הנוכחי כדי להפעיל את ההרשאה account.admins.create ולהזמין משתמש להיות הבעלים של הדף העסקי. לאחר מכן, משתמשים בפרטי הכניסה של OAuth של המשתמש שהוזמן כדי לבצע קריאה אל accounts.invitations.list ולקבל את מזהה ההזמנה. אפשר להתקשר אל accounts.invitations.accept כדי לאשר את ההזמנה.

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

2. משתמשים בפרטי הכניסה של OAuth של חשבון היעד המיועד כדי להפעיל את accounts.list. לאחר מכן, מאתרים ברשימה את מספר החשבון שאליו רוצים להעביר את המיקום. אפשר להשתמש במזהה האדמין בתגובה לשיחת account.admins.create או בשיחה עם accounts.invitations.list בשלב 1 גם כמספר החשבון. מספר החשבון הזה יכול להתייחס לחשבון אישי או לקבוצת מיקומים.

3. משתמשים במספר החשבון שאחזרתם בשלב 2 כחשבון היעד. זהו השדה destinationAccount בגוף הבקשה, שאפשר להשתמש בו כדי להפעיל את locations.transfer.

   הערה: אחרי שההעברה מסתיימת, חשבון היעד הוא החשבון הראשי שמשויך לבעלים של הדף העסקי. אם זו לא התוצאה הרצויה, חזרו על שלבים 1-3 עם משתמש חדש. לאחר מכן, מעבירים את המיקום בחזרה לחשבון הראשי המקורי. אפשר להשתמש בנקודת הקצה accounts.admins.patch כדי לשדרג לאחור את תפקיד האדמין בחשבון היעד המקורי.

משתמשים בפרטי הכניסה של OAuth של חשבון היעד כדי להפעיל את accounts.locations.list ולוודא שהמיקום שהועבר מופיע בתוצאות. אם מפעילים את נקודת הקצה accounts.locations.list באמצעות חשבון המקור, המיקום שהועבר לא ייכלל בתוצאות.

העברה לקבוצה לפי מיקום

כדי להעביר מיקום אל location group בארגון, צריך לבצע קריאה אל locations.admins.create באמצעות פרטי הכניסה של merchant בפרוטוקול OAuth. צריך להשתמש בשדה account במשאב Admin כדי להעביר את location group account ID יחד עם ה-role המתאים. כדי לאחזר הזמנות שקשורות אל location group, צריך להשתמש בפרטי הכניסה של האדמין של location group כדי להפעיל את accounts.invitations.list באמצעות מספר החשבון של קבוצת המיקומים בתור הארגומנט parent. מחפשים את ההזמנה עם מיקום היעד הנכון, ולאחר מכן מתקשרים אל accounts.invitations.accept כדי לאשר את ההזמנה הנכונה.