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

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

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

שנתחיל?

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

חשבון המקור: חשבון המקור הוא החשבון שמוגדר כבעלים של המיקום. החשבון יכול להיות חשבון לשימוש אישי או קבוצת מיקומים. אחרי שההעברה מסתיימת, לחשבון המקור כבר אין גישה למיקום.
חשבון היעד: חשבון היעד הוא החשבון שאליו יועבר המיקום. החשבון יכול להיות חשבון לשימוש אישי או קבוצת מיקומים. אחרי שההעברה תושלם, חשבון היעד יהיה הבעלים הראשי של המיקום.‫
OAuth2 refresh/access tokens: צריך OAuth2 refresh/access tokens לכל חשבון מקור ויעד כדי לשלוח קריאה ל-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 כדי לאשר את ההזמנה הנכונה.