با استفاده از My Business Account Management API، می‌توانید مکان‌ها را به حساب‌ها یا گروه‌های مکان مختلف منتقل کنید. دستورالعمل های این مستندات را دنبال کنید تا نحوه انجام آن را بیاموزید.
شروع کنید
موارد زیر برای انتقال مکان مورد نیاز است:
حساب منبع: حساب منبع، حسابی است که مالک مکان است. این حساب می تواند یک حساب شخصی یا یک گروه مکان باشد. پس از تکمیل انتقال، حساب منبع دیگر به مکان دسترسی ندارد.
حساب مقصد: حساب مقصد، حسابی است که مکان باید به آن منتقل شود. این حساب می تواند یک حساب شخصی یا یک گروه مکان باشد. پس از تکمیل انتقال، حساب مقصد مالک اصلی مکان است.
نشانه‌های تازه‌سازی/دسترسی OAuth2: نشانه‌های بازخوانی/دسترسی OAuth2 برای حساب‌های مبدا و مقصد برای هر حساب به منظور فراخوانی API مورد نیاز است.
انتقال مکان ها
برای انتقال مکان، مراحل زیر را انجام دهید:
اگر مالک مکان نیستید، باید یکی شوید. برای تماس با
account.admins.createو دعوت از کاربر برای مالکیت فهرست، از اعتبارنامه OAuth مالک کسب و کار فعلی استفاده کنید. سپس، از اطلاعات کاربری OAuth کاربر دعوت شده برای تماس باaccounts.invitations.listبرای دریافت شناسه دعوت استفاده کنید. برای پذیرش این دعوتaccounts.invitations.acceptتماس بگیرید.برای فراخوانی
accounts.listاز اعتبارنامه OAuth حساب مقصد مورد نظر استفاده کنید. سپس، شناسه حساب را در لیستی که می‌خواهید مکان را به آن منتقل کنید، پیدا کنید. شناسه سرپرست در پاسخ به تماسaccount.admins.createیا تماسaccounts.invitations.listدر مرحله 1 نیز می تواند به عنوان شناسه حساب استفاده شود. این شناسه حساب می تواند به یک حساب شخصی یا یک گروه مکان اشاره کند.از شناسه حسابی که در مرحله 2 بازیابی کرده اید به عنوان حساب مقصد استفاده کنید. این قسمت مقصدAccount در بدنه درخواست است که می‌توانید از آن برای فراخوانی
locations.transferاستفاده کنید.
از اعتبارنامه OAuth حساب مقصد برای تماس با accounts.locations.list استفاده کنید و بررسی کنید که مکان منتقل شده در نتایج نشان داده شود. اگر با حساب مبدأ با نقطه پایانی accounts.locations.list تماس بگیرید، مکان منتقل شده در نتایج لحاظ نمی شود.
انتقال به یک گروه مکان
برای انتقال یک مکان به یک location group در سازمان، با استفاده از اطلاعات کاربری OAuth merchant با locations.admins.create تماس بگیرید. از فیلد account در منبع Admin برای ارسال location group account ID به همراه role مناسب استفاده کنید. برای بازیابی دعوت‌نامه‌های location group ، باید از اعتبار سرپرست گروه مکان برای فراخوانی accounts.invitations.list با استفاده از شناسه حساب گروه location group به عنوان آرگومان parent استفاده کنید. دعوت‌نامه‌ای را پیدا کنید که مکان هدف صحیحی دارد و سپس با accounts.invitations.accept تماس بگیرید تا دعوت صحیح را بپذیرید.