โอนสถานที่

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

หมายเหตุ: ผู้เรียก 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 เพื่อยอมรับคำเชิญที่ถูกต้อง