باستخدام واجهة برمجة التطبيقات 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 لقبول الدعوة الصحيحة.