โอนสถานที่

เมื่อใช้ My Business Account Management API คุณจะโอนสถานที่ไปยังบัญชีหรือกลุ่มสถานที่ตั้งอื่นได้ ทำตามวิธีการในเอกสารประกอบนี้เพื่อดูวิธี

หมายเหตุ: หากต้องการโอนสถานที่ตั้ง ผู้โทรต้องเป็นเจ้าของสถานที่ตั้งและผู้ถือบัญชีปลายทางต้องเป็นผู้จัดการสถานที่ตั้งเป็นอย่างน้อย โปรดดูรายละเอียดเกี่ยวกับวิธีให้สิทธิ์การเป็นเจ้าของข้อมูลในหัวข้อจัดการผู้ดูแลระบบสำหรับบัญชีและสถานที่ตั้ง

เริ่มต้นใช้งาน

คุณต้องดำเนินการต่อไปนี้เพื่อโอนสถานที่

บัญชีต้นทาง: บัญชีต้นทางคือบัญชีที่เป็นเจ้าของสถานที่ บัญชีนี้อาจเป็นบัญชีส่วนตัวหรือกลุ่มสถานที่ตั้งก็ได้ หลังจากการโอนเสร็จสมบูรณ์แล้ว บัญชีต้นทางจะไม่มีสิทธิ์เข้าถึงสถานที่ตั้งนั้นอีกต่อไป
บัญชีปลายทาง: บัญชีปลายทางคือบัญชีที่ควรโอนตำแหน่ง บัญชีนี้อาจเป็นบัญชีส่วนบุคคลหรือกลุ่มสถานที่ก็ได้ หลังจากการโอนเสร็จสมบูรณ์ บัญชีปลายทางจะเป็นเจ้าของหลักของสถานที่
โทเค็นการรีเฟรช/การเข้าถึง OAuth2: แต่ละบัญชีต้องมีโทเค็นการรีเฟรช/การเข้าถึง OAuth2 ของบัญชีต้นทางและปลายทางเพื่อเรียกใช้ API

สถานที่โอน

หมายเหตุ: Business Profile จะมีระยะเวลาทดลองสำหรับผู้ดูแลระบบสถานที่ตั้ง เมื่อเพิ่มผู้ใช้ในโปรไฟล์ในฐานะเจ้าของหรือผู้จัดการ ผู้ใช้รายดังกล่าวจะถูกจํากัดการดำเนินการที่ทำได้กับผู้ใช้และสถานที่ตั้งของอีกแห่งเป็นเวลา 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 โดยใช้ข้อมูลเข้าสู่ระบบ OAuth ของ merchant ใช้ช่อง account ในทรัพยากร Admin เพื่อส่ง location group account ID พร้อมกับ role ที่เหมาะสม คุณควรใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลระบบ location group เพื่อเรียกใช้ accounts.invitations.list โดยใช้รหัสบัญชีของกลุ่มสถานที่ตั้งเป็นอาร์กิวเมนต์ parent เพื่อเรียกข้อมูลคําเชิญที่เกี่ยวข้องกับ location group ค้นหาคำเชิญที่มีตำแหน่งเป้าหมายที่ถูกต้อง แล้วโทรหา accounts.invitations.accept เพื่อยอมรับคำเชิญที่ถูกต้อง