با استفاده از رابط برنامهنویسی کاربردی (API) مدیریت حساب کاربری کسب و کار من، میتوانید مکانها را به حسابها یا گروههای مکانی مختلف منتقل کنید. برای آشنایی با نحوهی انجام این کار، دستورالعملهای موجود در این مستندات را دنبال کنید.
شروع کنید
برای انتقال مکان، موارد زیر لازم است:
حساب مبدا: حساب مبدا، حسابی است که مالک مکان است. این حساب میتواند یک حساب شخصی یا یک گروه مکان باشد. پس از تکمیل انتقال، حساب مبدا دیگر به مکان دسترسی نخواهد داشت.
حساب مقصد: حساب مقصد، حسابی است که مکان باید به آن منتقل شود. این حساب میتواند یک حساب شخصی یا یک گروه مکان باشد. پس از اتمام انتقال، حساب مقصد مالک اصلی مکان است.
توکنهای بهروزرسانی/دسترسی OAuth2: توکنهای بهروزرسانی/دسترسی OAuth2 برای حسابهای مبدا و مقصد برای هر حساب به منظور فراخوانی API مورد نیاز هستند.
مکانهای انتقال
برای انتقال مکانها، مراحل زیر را انجام دهید:
اگر مالک مکان نیستید، باید یکی شوید. از اعتبارنامههای OAuth مالک فعلی کسبوکار برای فراخوانی
account.admins.createاستفاده کنید و یک کاربر را به مالکیت فهرست دعوت کنید. سپس، از اعتبارنامههای OAuth کاربر دعوتشده برای فراخوانیaccounts.invitations.listاستفاده کنید تا شناسه دعوت را دریافت کنید. برای پذیرش این دعوت،accounts.invitations.acceptرا فراخوانی کنید.از اعتبارنامههای OAuth حساب مقصد مورد نظر برای فراخوانی
accounts.listاستفاده کنید. سپس، شناسه حساب را در لیستی که میخواهید مکان را به آن منتقل کنید، پیدا کنید. شناسه مدیر در پاسخ به فراخوانیaccount.admins.createیا فراخوانیaccounts.invitations.listدر مرحله 1 نیز میتواند به عنوان شناسه حساب استفاده شود. این شناسه حساب میتواند به یک حساب شخصی یا یک گروه مکان اشاره داشته باشد.از شناسه حسابی که در مرحله ۲ بازیابی کردید به عنوان حساب مقصد استفاده کنید. این فیلد destinationAccount در بدنه درخواست است که میتوانید از آن برای فراخوانی
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 با استفاده از شناسه حساب گروه مکان به عنوان آرگومان parent برای بازیابی دعوتنامههای مربوط به location group استفاده کنید. دعوتنامهای را که مکان هدف صحیح را دارد پیدا کنید و سپس accounts.invitations.accept را برای پذیرش دعوتنامه صحیح فراخوانی کنید.