شما می‌توانید از API حساب‌ها برای مدیریت روابط بین حساب مرکز فروشندگان خود و سایر ارائه‌دهندگان خدمات استفاده کنید. یک رابطه، یک اتصال رسمی است که یک ارائه‌دهنده را قادر می‌سازد خدمات خاصی را به کسب‌وکار شما ارائه دهد. یک سرویس، مجوزها و قابلیت‌های اعطا شده به ارائه‌دهنده، مانند مدیریت محصول یا مدیریت کمپین را تعریف می‌کند. به عنوان مثال، پیوند دادن حساب مرکز فروشندگان خود به یک حساب Google Ads به حساب Ads اجازه می‌دهد تا از داده‌های محصول شما برای اجرای کمپین‌های تبلیغاتی استفاده کند.
یک رابطه از ویژگی‌های زیر تشکیل شده است:
- حساب مرکز بازرگانان که سرویس را دریافت می‌کند
- ارائه دهنده خدمات
- سرویس یا مجموعه‌ای از سرویس‌ها که به حساب مرکز فروشندگان ارائه می‌شود
نام مستعار
ارائه دهندگان خدمات می‌توانند یک نام مستعار را به حساب‌هایی که به آنها خدمات می‌دهند، مرتبط کنند (این معادل فیلد seller_id است که در منبع حساب در Content API for Shopping وجود داشت). این نام مستعار را می‌توان با استفاده از فیلد اختیاری account_id_alias در منبع AccountRelationship اختصاص داد و به عنوان یک شناسه سفارشی عمل کرد. نام مستعار باید شامل ۱ تا ۵۰ کاراکتر باشد که از حروف ASCII، ارقام اعشاری، خط فاصله، زیرخط، نقطه یا تیلدها انتخاب می‌شوند ( [A-Za-z0-9_~.-]{1,50} ).
ساختار URL برای دسترسی به یک حساب کاربری با استفاده از نام مستعار آن به GET /accounts/v1/accounts/{provider}~{account_id_alias} است.
خدمات
در API حساب‌ها، حساب‌ها می‌توانند سرویس‌های زیر را دریافت کنند. می‌توانید بسیاری از این سرویس‌ها را هنگام ایجاد حساب اضافه کنید.
تجمیع حساب‌ها : این سرویس یک حساب پیشرفته را به یک حساب دیگر متصل می‌کند و به حساب پیشرفته دسترسی کامل و بدون محدودیت می‌دهد. این سرویس معمولاً توسط فروشگاه‌های آنلاین، خرده‌فروشان چند برندی یا خرده‌فروشان بین‌المللی که به کنترل متمرکز بر حساب‌های تو در تو نیاز دارند، استفاده می‌شود. اگر شما یک پلتفرم تجارت الکترونیک یا شریک کانال هستید، توصیه می‌کنیم به جای آن
accountManagementاستفاده کنید. هنگام ایجاد حساب با استفاده از تجمیع حساب‌ها، بایدexternalAccountIdحذف شود.مدیریت کمپین : این سرویس، ارتباط بین یک حساب مرکز فروش و یک حساب گوگل ادز را مدل‌سازی می‌کند و به حساب ادز دسترسی به داده‌های محصول و حساب مورد نیاز برای اجرای کمپین‌های تبلیغاتی را می‌دهد. ارائه‌دهنده خدمات در این مورد
GOOGLE_ADSاست وexternalAccountIdشناسه حساب گوگل ادز است. این سرویس همچنین می‌تواند به یک حساب موجود پیشنهاد شود.خرید مقایسه‌ای : این نشان دهنده ارتباط با یک سرویس خرید مقایسه‌ای (CSS) است که حساب مرکز فروشندگان را اداره می‌کند.
مدیریت فهرست محلی : این نشان دهنده ارتباط با مدیر فروشگاه برای مدیریت موجودی و فهرست‌های محلی با استفاده از نمایه تجاری گوگل است.
مدیریت حساب : این سرویس به ارائه‌دهنده امکان می‌دهد تا اقدامات مدیریتی را روی حساب مرکز فروشندگان انجام دهد، مانند پیکربندی تنظیمات حساب، مدیریت کاربران یا به‌روزرسانی اطلاعات کسب‌وکار. کسب‌وکار همچنین می‌تواند دسترسی‌های اعطا شده را محدود کند. هنگامی که این سرویس در هنگام ایجاد حساب استفاده می‌شود، یک حساب کاربری مرتبط با ارائه‌دهنده ایجاد می‌کند که رویکرد توصیه‌شده برای پلتفرم‌های تجارت الکترونیک و شرکای کانال است. همچنین می‌توان آن را به یک حساب کاربری موجود پیشنهاد داد.
مدیریت محصولات : این سرویس به ارائه‌دهندگان اجازه می‌دهد تا محصولات و ویژگی‌های مرتبط مانند منابع داده و قوانین را مدیریت کنند. وقتی در طول ایجاد حساب اضافه می‌شود، معمولاً در ترکیب با
accountManagementیاaccountAggregationاست. این سرویس همچنین می‌تواند برای یک حساب موجود پیشنهاد شود.
دست دادن
برای ایجاد یک سرویس، هم حساب ارائه دهنده سرویس و هم حساب دریافت کننده سرویس باید اتصال را تأیید کنند. این فرآیند تأیید، handshake نامیده می‌شود.
دست دادن یک فرآیند دو مرحله‌ای است:
- یکی از طرفین پیشنهاد پیوند خدماتی می‌دهد.
- طرف مقابل پیشنهاد را تأیید یا رد می‌کند.
پس از پذیرش پیشنهاد، سرویس تأیید شده و کاملاً تثبیت شده تلقی می‌شود. اکنون هرگونه حق دسترسی که به ارائه‌دهنده خدمات اعطا شده باشد، به کاربران واجد شرایط اعطا می‌شود (به حقوق دسترسی در زیر مراجعه کنید).
توجه داشته باشید که کاربری که پیشنهادی را ایجاد، رد یا تأیید می‌کند، باید در حسابی که فرآیند را آغاز می‌کند، حق دسترسی ADMIN داشته باشد. بنابراین اگر ارائه‌دهنده خدمات، خدماتی را پیشنهاد می‌دهد، کاربری که پیشنهاد می‌دهد باید در حساب ارائه‌دهنده خدمات ADMIN باشد و کاربری که پیشنهاد را می‌پذیرد یا رد می‌کند، باید در حساب دریافت‌کننده، ADMIN باشد.
رفتار دست دادن مختص سرویس
در زیر شرح الزامات خاص handshake برای هر سرویس جداگانه آمده است:
تجمیع حساب : این سرویس فقط می‌تواند به عنوان بخشی از ایجاد حساب ایجاد شود. انتظار می‌رود ارائه دهنده خدمات یک حساب پیشرفته باشد و این سرویس به طور خودکار تأیید می‌شود زیرا کاربران حساب پیشرفته دسترسی کامل به
ADMINبه حساب ایجاد شده دارند.خرید مقایسه‌ای : این سرویس هنگام ایجاد حساب با استفاده از
createAndConfigureبه طور خودکار تأیید می‌شود.مدیریت کمپین : اگرچه این فرآیند از روند معمول تبادل اطلاعات پیروی می‌کند، اما پیشنهادها در یک سیستم (مثلاً گوگل ادز) ارائه می‌شوند و تأییدها در سیستم دیگر (مثلاً در مرکز فروشندگان یا از طریق رابط برنامه‌نویسی کاربردی فروشندگان) انجام می‌شود.
مدیریت فهرست محلی : برای این سرویس، روش handshake (دست دادن) به صورت اختصاصی پیشنهاد شده و تأییدها در سیستم دیگر (مثلاً نمایه تجاری گوگل) انجام می‌شود. مراحل دقیق در راهنمای پیوند نمایه تجاری گوگل آمده است.
مدیریت حساب : برای این سرویس، فرآیند معمول handshake هنگام استفاده از
proposeاعمال می‌شود. اگر سرویس هنگام ایجاد حساب با استفاده ازcreateAndConfigureاضافه شود، به طور خودکار تأیید می‌شود.مدیریت محصولات : برای این سرویس، فرآیند معمول handshake (پیشنهاد توسط یک طرف و به دنبال آن پذیرش از طرف دیگر) اعمال می‌شود.
حقوق دسترسی
هر نوع سرویس، سطح دسترسی مشخصی را برای کاربران ارائه‌دهنده سرویس، از طریق حسابی که به آن سرویس داده می‌شود، فراهم می‌کند:
تجمیع حساب‌ها : این سرویس حقوق کامل
ADMINرا ارائه می‌دهد.مدیریت کمپین : این سرویس یک حق دسترسی محدود ارائه می‌دهد و به حساب تبلیغات مرتبط اجازه می‌دهد به محصولات و اطلاعات اولیه حساب دسترسی داشته باشد.
خرید مقایسه‌ای : این سرویس به طور پیش‌فرض، حقوق کامل
ADMINرا ارائه می‌دهد. با این حال، کسب و کار می‌تواند دسترسی‌های اعطا شده در مرکز فروشندگان را محدود کند.مدیریت فهرست محلی : این سرویس هیچ حق دسترسی مستقیمی ارائه نمی‌دهد. در عوض، فهرست را قادر می‌سازد تا محصولات خود را با حساب مرکز فروشندگان همگام‌سازی کند.
مهم : حقوق دسترسی شرح داده شده برای انواع خدمات زیر فقط برای ارائه دهندگان خدمات تأیید شده اعمال می‌شود. اگر شما ارائه دهنده خدمات هستید و می‌خواهید از این قابلیت استفاده کنید، با تیم پشتیبانی ما تماس بگیرید. اگر قبلاً برای روش accounts.link برای مدیریت محصولات در Content API for Shopping تأیید شده‌اید، می‌توانید بدون تأیید بیشتر از این سرویس در Merchant API استفاده کنید.
مدیریت حساب : این سرویس به طور پیش‌فرض، حقوق کامل
ADMINرا ارائه می‌دهد.مدیریت محصولات : این سرویس حقوق کامل
ADMINرا ارائه می‌دهد. توجه داشته باشید که در آینده، این حقوق فقط به حقوق دسترسی مرتبط با محصول محدود خواهد شد.
نحوه اعمال روابط برای پلتفرم‌های شخص ثالث
اگر شما یک پلتفرم شخص ثالث هستید که حساب‌ها را از طرف سایر کسب‌وکارها مدیریت می‌کند، موارد زیر نشان می‌دهد که چگونه مفاهیم مختلف با ساختار حساب شما مطابقت دارند:
- ارائه دهنده خدمات : حساب پیشرفته شما.
- حساب دریافت‌کننده سرویس : یک حساب مرکز تجاری که نشان‌دهنده کسب‌وکاری است که شما مدیریت می‌کنید.
- خدمات :
-
accountManagement: این سرویس برای پلتفرم‌های تجارت الکترونیک و شرکای کانال که از طرف فروشندگان حساب‌های جدید ایجاد می‌کنند، توصیه می‌شود. این سرویس، حسابی ایجاد می‌کند که متعلق به فروشنده است و برای مدیریت به شما لینک می‌شود. این سرویس با ساختار ترجیحی مرکز فروشندگان برای این مورد استفاده، همسو است. -
accountAggregation: این سرویس حساب پیشرفته شما را به یک حساب دیگر متصل می‌کند. اگرچه پشتیبانی می‌شود، اما برای پلتفرم‌های تجارت الکترونیک و شرکای کانال توصیه نمی‌شود.
-
برای جزئیات بیشتر در مورد نحوه راه‌اندازی یک حساب پیشرفته و پیوند به حساب‌های جدید مرکز بازرگانان، به ایجاد حساب‌ها مراجعه کنید.