باستخدام My Business Account Management API، يمكنك نقل المواقع الجغرافية إلى حسابات أو مجموعات مواقع جغرافية مختلفة. اتبع التعليمات الواردة في هذه الوثائق للتعرف على كيفية القيام بذلك.
البدء
العناصر التالية مطلوبة لنقل المواقع الجغرافية:
الحساب المصدر: الحساب المصدر هو الحساب الذي يملك الموقع الجغرافي. يمكن أن يكون هذا الحساب حسابًا شخصيًا أو مجموعة مواقع جغرافية. بعد اكتمال عملية النقل، لن يتمكّن الحساب المصدر من الوصول إلى الموقع الجغرافي.
حساب الوجهة: حساب الوجهة هو الحساب الذي
يجب نقل الموقع الجغرافي إليه. يمكن أن يكون هذا الحساب حسابًا شخصيًا
أو مجموعة مواقع جغرافية. بعد اكتمال عملية النقل، يكون حساب الوجهة
هو المالك الأساسي للموقع الجغرافي.
رموز تحديث/وصول OAuth2: يلزم استخدام رموز تحديث/وصول OAuth2
لحسابات المصدر والوجهة لكل حساب من أجل
استدعاء واجهة برمجة التطبيقات.
نقل المواقع الجغرافية
لنقل المواقع الجغرافية، أكمل الخطوات التالية:
وإذا لم تكن مالكًا للموقع الجغرافي، يجب أن تصبح مالكًا لهذا الموقع الجغرافي. استخدِم بيانات اعتماد OAuth لمالك النشاط التجاري الحالي من أجل الاتصال بـ
account.admins.createودعوة مستخدم ليصبح مالك بطاقة بيانات المتجر. بعد ذلك، استخدِم بيانات اعتماد OAuth للمستخدم الذي تمت دعوته من أجل طلبaccounts.invitations.listللحصول على معرِّف الدعوة. اتصل علىaccounts.invitations.acceptلقبول هذه الدعوة.استخدِم بيانات اعتماد OAuth لحساب الوجهة المقصود من أجل الاتصال بها
accounts.list. بعد ذلك، ابحث عن رقم تعريف الحساب في القائمة التي تريد نقل الموقع إليها. يمكن أيضًا استخدام رقم تعريف المشرف في الردّ على المكالمةaccount.admins.createأو المكالمةaccounts.invitations.listالواردة في الخطوة 1 كرقم تعريف الحساب. ويمكن أن يشير رقم تعريف الحساب هذا إلى حساب شخصي أو مجموعة مواقع جغرافية.استخدِم رقم تعريف الحساب الذي تم استرداده في الخطوة 2 كحساب وجهة. هذا هو الحقل destinationAccount في نص الطلب، والذي يمكنك استخدامه لطلب الرمز
locations.transfer.
استخدِم بيانات اعتماد 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 لقبول الدعوة الصحيحة.