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

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

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

שנתחיל?

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

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