می توانید از Accounts API برای مدیریت روابط بین حساب Merchant Center خود و سایر ارائه دهندگان خدمات استفاده کنید. رابطه یک ارتباط رسمی است که ارائه دهنده را قادر می سازد خدمات خاصی را به کسب و کار شما ارائه دهد. یک سرویس مجوزها و قابلیت های اعطا شده به ارائه دهنده را تعریف می کند، مانند مدیریت محصول یا مدیریت کمپین. به عنوان مثال، پیوند دادن حساب Merchant Center خود به حساب Google Ads به حساب Ads اجازه می دهد تا از داده های محصول شما برای اجرای کمپین های تبلیغاتی استفاده کند.
یک رابطه از ویژگی های زیر تشکیل شده است:
- حساب Merchant Center که سرویس را دریافت می کند
- ارائه دهنده خدمات
- سرویس یا مجموعه خدماتی که به حساب Merchant Center ارائه می شود
ارائهدهندگان خدمات میتوانند نام مستعار را با حسابهایی که سرویس میدهند مرتبط کنند (این معادل فیلد seller_id
است که در منبع حساب در Content API برای خرید وجود داشت). نام مستعار را می توان با استفاده از فیلد اختیاری account_id_alias
در منبع AccountRelationship
اختصاص داد و به عنوان یک شناسه سفارشی عمل می کند.
ساختار URL برای دسترسی به یک حساب با استفاده از نام مستعار GET /accounts/v1/accounts/{provider}~{account_id_alias}
است.
خدمات
در Accounts API، حساب ها می توانند خدمات زیر را دریافت کنند:
تجمیع حساب : این رابطه بین یک حساب پیشرفته و حساب هایی که به آنها خدمات ارائه می دهد مدل می کند. ارائهدهنده خدمات (حساب پیشرفته) دسترسی کامل و نامحدود به حسابهای فرعی مرتبط میشود.
externalAccountId
، در این مورد، شناسه حساب Merchant Center است. هنگامی که یک حساب فرعی ایجاد می کنید ،externalAccountId
باید حذف شود، زیرا پس از ایجاد به شناسه حساب اختصاص داده می شود.مدیریت کمپین : این سرویس پیوند بین حساب Merchant Center و حساب Google Ads را مدلسازی میکند و به حساب Ads اجازه میدهد به اطلاعات محصول و حساب مورد نیاز برای اجرای کمپینهای تبلیغاتی دسترسی داشته باشد. ارائهدهنده خدمات در این مورد
GOOGLE_ADS
است وexternalAccountId
شناسه حساب Google Ads است.خرید مقایسه : این نشان دهنده رابطه با یک سرویس خرید مقایسه (CSS) است که حساب Merchant Center را اداره می کند.
مدیریت فهرست محلی : این نشان دهنده رابطه با مدیر فروشگاه برای مدیریت موجودی و فهرست های محلی با استفاده از نمایه کسب و کار Google است.
مدیریت حساب : این سرویس ارائه دهنده را قادر می سازد تا اقدامات اداری را روی حساب Merchant Center انجام دهد، مانند پیکربندی تنظیمات حساب، مدیریت کاربران، یا به روز رسانی اطلاعات کسب و کار. کسب و کار همچنین می تواند دسترسی اعطا شده را محدود کند.
مدیریت محصولات : این سرویس به ارائه دهندگان اجازه می دهد تا محصولات و ویژگی های مرتبط مانند منابع داده و قوانین را مدیریت کنند.
دست دادن
برای ایجاد یک سرویس، هم حساب ارائه دهنده سرویس و هم حساب دریافت کننده سرویس باید مجوز اتصال را صادر کنند. این فرآیند مجوز، دست دادن نامیده می شود.
دست دادن یک فرآیند دو مرحله ای است:
- یکی از طرفین پیوند خدمات را پیشنهاد می کند.
- طرف مقابل پیشنهاد را تایید یا رد می کند.
هنگامی که یک پیشنهاد پذیرفته شد، سرویس مورد تایید قرار می گیرد و به طور کامل ایجاد شده در نظر گرفته می شود. هر گونه حق دسترسی که به ارائه دهنده خدمات اعطا می شود اکنون به کاربران واجد شرایط اعطا می شود (به حقوق دسترسی در زیر مراجعه کنید).
توجه داشته باشید که کاربر ایجاد کننده پیشنهاد، رد یا تایید آن باید از حقوق دسترسی ADMIN
در حساب شروع کننده فرآیند برخوردار باشد. بنابراین اگر ارائهدهنده خدمات سرویسی را پیشنهاد میکند، کاربری که پیشنهاد میدهد باید یک ADMIN
در حساب ارائهدهنده خدمات باشد و کاربر پذیرنده یا رد پیشنهاد باید یک ADMIN
در حساب دریافتکننده باشد.
رفتار دست دادن مخصوص سرویس
در زیر شرحی از الزامات خاص دست دادن برای هر سرویس جداگانه ارائه شده است:
تجمیع حساب : این سرویس فقط می تواند به عنوان بخشی از ایجاد حساب ایجاد شود. انتظار میرود که ارائهدهنده خدمات یک حساب پیشرفته باشد و این سرویس بهطور خودکار تأیید میشود زیرا کاربران حساب پیشرفته دسترسی کامل
ADMIN
به حساب در حال ایجاد دارند.مدیریت کمپین : در حالی که این فرآیند از روند عادی دست دادن پیروی می کند، پیشنهادها در یک سیستم (به عنوان مثال Google Ads) و تأییدیه ها در سیستم دیگر (به عنوان مثال در Merchant Center یا از طریق Merchant API) انجام می شود.
مدیریت فهرست محلی : برای این سرویس، دست دادن به روشی اختصاصی پیشنهاد میشود و تأییدیهها در سیستم دیگر (مثلاً نمایه تجاری Google) انجام میشود. مراحل دقیق در راهنمای پیوند دادن نمایه کسب و کار Google آمده است.
مدیریت حساب : برای این سرویس، فرآیند دست دادن معمولی اعمال میشود (پیشنهاد شده توسط ارائهدهنده خدمات یا کسبوکار، و به دنبال آن پذیرش از طرف دیگر).
مدیریت محصولات : برای این سرویس، فرآیند دست دادن معمولی اعمال میشود (پیشنهاد شده توسط یک طرف و به دنبال آن پذیرش از طرف دیگر).
حقوق دسترسی
هر نوع سرویس سطح معینی از دسترسی را برای کاربران ارائهدهنده خدمات بر روی حسابی که در حال سرویسدهی است فراهم میکند:
تجمع حساب : این سرویس حقوق کامل
ADMIN
را ارائه می دهد.مدیریت کمپین : این سرویس یک حق دسترسی محدود را فراهم میکند و به حساب Ads مرتبط اجازه میدهد به محصولات و اطلاعات اولیه حساب دسترسی داشته باشد.
خرید مقایسه : این سرویس به طور پیش فرض، حقوق کامل
ADMIN
را ارائه می دهد. با این حال، کسبوکار میتواند دسترسی اعطا شده در Merchant Center را محدود کند.مدیریت فهرست محلی : این سرویس هیچ حق دسترسی مستقیمی را ارائه نمی دهد. در عوض، فهرست را قادر میسازد تا محصولات خود را با حساب Merchant Center همگامسازی کند.
مهم : حقوق دسترسی شرح داده شده برای انواع خدمات زیر فقط برای ارائه دهندگان خدمات تایید شده اعمال می شود. اگر ارائه دهنده خدمات هستید و می خواهید از این قابلیت استفاده کنید، با تیم پشتیبانی ما تماس بگیرید. اگر قبلاً برای روش accounts.link
برای مدیریت محصولات در Content API for Shopping تأیید شدهاید، میتوانید بدون تأیید بیشتر از این سرویس در Merchant API استفاده کنید.
مدیریت حساب : این سرویس به طور پیش فرض، حقوق کامل
ADMIN
را ارائه می دهد.مدیریت محصولات : این سرویس حقوق کامل
ADMIN
را ارائه می دهد. توجه داشته باشید که در آینده، این تنها به حقوق دسترسی مرتبط با محصول محدود خواهد شد.
نحوه اعمال روابط برای پلتفرم های شخص ثالث
اگر شما یک پلتفرم شخص ثالث هستید که حسابها را به نمایندگی از سایر کسبوکارها مدیریت میکنید، موارد زیر نشان میدهد که چگونه مفاهیم مختلف با ساختار حساب شما ترسیم میشوند:
- ارائه دهنده خدمات : حساب پیشرفته شما.
- حساب دریافت کننده سرویس : یک حساب Merchant Center که نشان دهنده کسب و کاری است که شما مدیریت می کنید.
- خدمات :
-
accountAggregation
، اگر این حساب ها را به عنوان حساب های فرعی حساب پیشرفته خود ایجاد می کنید. با این حال، این کار منع شده است و سرویس ترجیحیaccountManagement
است. -
accountManagement
، اگر این سرویس را پس از ایجاد حساب در حساب هایی که زیر حساب های حساب پیشرفته شما نیستند ایجاد می کنید.
-
برای جزئیات درباره نحوه راهاندازی یک حساب پیشرفته و پیوند به حسابهای Merchant Center جدید، به ایجاد و مدیریت حسابهای فرعی مراجعه کنید.