با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
API فرعی حسابها در Merchant API به شما امکان میدهد حسابهای Google Merchant Center خود را به صورت برنامهنویسی ایجاد، پیکربندی و مدیریت کنید. مجموعه جامعی از ابزارها را برای مدیریت کل چرخه حیات و پیکربندی های اصلی حساب های Merchant Center شما ارائه می دهد. این API برای مشاغل و ارائه دهندگان شخص ثالثی که به دنبال تنظیم خودکار حساب و نگهداری مداوم هستند ضروری است.
با زیر API حساب ها، می توانید کارهای زیر را انجام دهید:
انجام عملیات حساب مرکزی Merchant Center: ایجاد حسابهای Merchant Center جدید، بازیابی جزئیات آنها، بهروزرسانی تنظیمات اصلی، نظارت بر مشکلات سطح حساب، فهرست کردن حسابهایی که میتوانید به آنها دسترسی داشته باشید، و حذف حسابها در صورت لزوم.
اطلاعات کسب و کار و حضور در فروشگاه آنلاین خود را ایجاد کنید: جزئیات ضروری کسب و کار خود (مانند آدرس و اطلاعات تماس)، ویژگی های هویتی خود اعلام شده را پیکربندی کنید و با مشخص کردن، تأیید و ادعای URL صفحه اصلی خود، وب سایت فروشگاه آنلاین خود را راه اندازی کنید. این کلید نحوه نمایش کسب و کار شما است.
دسترسی کاربر و تنظیمات برگزیده ارتباط را مدیریت کنید: نحوه کنترل افرادی که می توانند به حساب Merchant Center شما دسترسی داشته باشند را کشف کنید، مجوزهای خاص آنها را مشخص کنید و تنظیمات برگزیده اعلان ایمیل آنها را برای به روز رسانی ها و اخبار مهم حساب پیکربندی کنید.
ثبت نام و مشارکت در برنامه را مدیریت کنید: ثبت نام خود را در برنامه های مختلف Merchant Center (مانند لیست های رایگان یا تبلیغات خرید) مدیریت کنید، وضعیت مشارکت خود را مدیریت کنید، و الزامات خاص برنامه را برای گسترش دامنه دسترسی محصول خود درک کنید.
تدارکات را پیکربندی کنید: حمل و نقل، بازگشت و مناطق: تنظیمات حمل و نقل در سطح حساب خود را تنظیم کنید، خط مشی های بازگشت آنلاین خود را برای مشتریان تعریف کنید، و مناطق جغرافیایی را برای هدف گیری دقیق و ارائه خدمات ایجاد کنید.
از ادغامهای پیشرفته و پیوند حساب استفاده کنید: مدیریت تنظیمات تجربههای چند کاناله، پیوند دادن به حسابهای نمایه کسبوکار Google و ارائهدهندگان شراکت فیدهای محلی (LFP) و ایجاد و مدیریت روابط خدمات با حسابهای دیگر، مانند ارائهدهندگان یا نمایندگیهای شخص ثالث را بیاموزید.
این مجموعه راهنماها دستورالعملها و مثالهای دقیقی را برای موارد استفاده رایج ارائه میدهد:
ایجاد یک حساب : مراحل ایجاد یک حساب Merchant Center جدید را از طریق برنامهریزی بیاموزید.
روابط : درک کنید که چگونه روابط خدماتی بین حساب های مختلف Merchant Center (مثلاً با حساب های پیشرفته یا ارائه دهندگان شخص ثالث) ساختار یافته و مدیریت می شود.
پیوند یک نمایه کسب و کار Google : حساب Merchant Center خود را با نمایه کسب و کار Google خود متصل کنید تا حضور کسب و کار محلی خود را افزایش دهید.
دسترسی به حساب خود را کنترل کنید : مجوزها و نقش های کاربر را در حساب Merchant Center خود مدیریت کنید تا کنترل کنید چه کسی می تواند اقدامات خاصی را انجام دهد.
تنظیمات صفحه اصلی را مدیریت کنید : URL وب سایت فروشگاه آنلاین خود را تنظیم، تأیید و ادعا کنید که یک گام مهم برای تأیید حساب و مشارکت در برنامه است.
انتقال Content API : برای اطلاع از انتقال از Content API برای خرید، به مدیریت حساب مهاجرت مراجعه کنید.
ساختار و روابط حساب Merchant Center
اکوسیستم Merchant Center از ساختارهای مختلف حساب پشتیبانی می کند تا نیازهای مختلف کسب و کار را برآورده کند. این حساب ها همچنین می توانند روابطی با یکدیگر ایجاد کنند، جایی که یک حساب (یک ارائه دهنده خدمات) خدمات خاصی را به دیگری ارائه می دهد. API فرعی حسابها به شما امکان میدهد با این انواع و روابط آنها تعامل داشته باشید و آنها را مدیریت کنید.
حساب های تجاری
این یک حساب Merchant Center است که معمولاً توسط یک کسبوکار منفرد برای مدیریت مستقیم فهرستهای محصولات و برنامههای خود استفاده میشود.
موارد استفاده رایج:
کسب و کارهای کوچک تا متوسط که حضور خود را در تجارت الکترونیک مدیریت می کنند.
بازرگانی که خواهان کنترل مستقیم بر تنظیمات Google Merchant Center خود هستند.
بازرگانانی که از پلتفرم های تجارت الکترونیک استفاده می کنند که در آن پلتفرم به ایجاد و مدیریت حساب آنها کمک می کند.
روابط و خدمات:
حسابهای تجاری را میتوان برای کمک به کارهایی مانند مدیریت دادههای محصول یا مدیریت حساب و کمپین به ارائهدهندگان خدمات مرتبط کرد.
حساب های پیشرفته
حساب پیشرفته یک حساب تخصصی در Google Merchant Center است. این برای مشاغل و پلتفرم هایی طراحی شده است که نیاز به مدیریت چندین حساب Merchant Center در مقیاس دارند.
موارد استفاده متداول:
سازندگان فروشگاه: پلتفرم های تجارت الکترونیکی که تجار را قادر می سازد تا فروشگاه های آنلاین خود را ایجاد و راه اندازی کنند.
بازارها: پلتفرم های آنلاینی که میزبان چندین تاجر فردی هستند که محصولات خود را می فروشند.
بازرگانانی که دارای چندین برند هستند: این تجار مالک چندین برند هستند و محصولات را در فروشگاه های فیزیکی یا آنلاین در دامنه های مختلف به فروش می رسانند.
خرده فروشان بین المللی: خرده فروشانی که محصولات را در چندین کشور و دامنه می فروشند.
شرکای کانال: نهادهایی که به بازرگانان کمک می کنند محصولات خود را در کانال های بازاریابی مختلف فهرست کنند و اغلب خدمات مرتبط را ارائه می دهند.
روابط و خدمات:
در حالی که همه حساب های پیشرفته چندین حساب تجاری را مدیریت می کنند، پیکربندی و استفاده بهینه از روابط و خدمات اغلب بر اساس مدل کسب و کار خاص متفاوت است. درک این تمایزات کلیدی برای استفاده موثر از API است. موارد زیر بهترین روشها برای موارد استفاده رایج توصیه میشوند:
فروشگاه سازان و شرکای کانال
این شرکا باید یک حساب کاربری پیشرفته ایجاد کنند و با بازرگانی که با آنها کار می کنند رابطه برقرار کنند.
برای حسابهای موجود Merchant Center: پلتفرم باید یک پیوند خدمات Account Management با حساب فردی موجود تاجر ایجاد کند. این به پلتفرم اجازه میدهد تا جنبههای حساب را با رضایت تاجر مدیریت کند.
برای تاجران جدید بدون حساب: پلتفرم میتواند از API برای ایجاد یک حساب جدید Merchant Center برای تاجر استفاده کند. با استفاده از سرویس Account Aggregation می توان یک حساب کاربری جدید تحت حساب پیشرفته پلتفرم ایجاد کرد.
بازارها
Marketplace ها یک حساب پیشرفته در هر دامنه دارند و حساب های فروشنده را با سرویس Account Aggregation ایجاد می کنند. معمولاً بازارها از چندین نوع فروشنده استفاده می کنند که برخی از آنها نیاز به پیکربندی اضافی توسط تیم پشتیبانی Google دارند. ادعای دامنه و مدیریت برنامه در سطح پیشرفته حساب انجام می شود و به حساب های فروشنده به ارث می رسد. برای جزئیات بیشتر به مقاله مرکز راهنمای ساختار حساب بازار معتبر مراجعه کنید.
حساب فروشنده متعلق به بازار: یک حساب اختصاصی برای محصولات خود بازار. این به بازار اجازه می دهد تا از شناخت برند، رتبه بندی فروشنده و استراتژی های کمپین 1P خاص خود استفاده کند.
حساب های تک فروشنده: هر حساب شامل محصولاتی برای یک فروشنده شخص ثالث است. این ساختار برای فروشندگان بزرگتر که به ویژگی های متمایز و خاص فروشنده یا اجرای کمپین های تبلیغاتی خاص فروشنده نیاز دارند ایده آل است.
حساب های چند فروشنده: یک حساب واحد حاوی محصولاتی از چندین فروشنده شخص ثالث است که مدیریت حساب و محصول را ساده می کند. برای جزئیات بیشتر به مقاله مرکز راهنمای حسابهای چند فروشنده مراجعه کنید.
بازرگانانی که چندین برند دارند
کسبوکارهای چند برند معمولاً از یک حساب پیشرفته برای مدیریت حسابهای فردی برای هر برند استفاده میکنند که با استفاده از یک سرویس Account Aggregation پیوند داده شده است. این به برندها اجازه می دهد تا به طور مستقل عمل کنند (مثلاً ادعاهای وب سایت، داده های محصول) در حالی که حساب پیشرفته عملکردهای متمرکز مانند دسترسی کاربر، گزارش دهی و گاهی اوقات نظارت بر کمپین را ساده می کند.
خرده فروشان بین المللی
خردهفروشان بینالمللی حضور جهانی خود را با استفاده از یک حساب پیشرفته مدیریت میکنند، با حسابهای فردی در هر کشور یا منطقه که با استفاده از یک سرویس Account Aggregation پیوند داده شدهاند. تنظیم آنها اغلب بر اساس ساختار دامنه متفاوت است:
دامنه تک (با زیر دامنه ها/مسیرهای کشور): دامنه اصلی معمولاً در سطح حساب پیشرفته ادعا می شود و توسط حساب های منطقه ای به ارث می رسد. سپس این حسابهای منطقهای بر روی مدیریت دادههای محصول محلی، قیمتگذاری و در دسترس بودن تمرکز میکنند.
چندین دامنه خاص کشور: هر حساب منطقه ای دامنه خاص خود را ادعا می کند. در این مدل، حسابهای فردی عملیات محلی را مدیریت میکنند، در حالی که حساب پیشرفته عمدتاً برای عملکردهای متمرکز مانند دسترسی کاربر، گزارشدهی جهانی و مدیریت کمپین فراگیر استفاده میشود.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Merchant Accounts API enables programmatic creation and management of merchant accounts, users, and sub-accounts.\u003c/p\u003e\n"],["\u003cp\u003eThird-party providers can leverage the API to build interfaces for merchants to manage their account details.\u003c/p\u003e\n"],["\u003cp\u003eGet started by creating your first merchant account and verifying its connection to the Merchant API for seamless integration.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive details about the API can be found in the \u003ccode\u003eAccount\u003c/code\u003e reference documentation.\u003c/p\u003e\n"]]],["The Merchant Accounts API facilitates programmatic creation and management of merchant accounts, users, and sub-accounts. Third-party developers can build interfaces for merchants to manage their account details. Key actions include creating a merchant account, verifying its API access, and creating/managing sub-accounts. Information on controlling account access is also provided. The `Account` reference documentation offers further details on the API. Guides are provided on creating and configuring accounts, managing sub-accounts and managing account access.\n"],null,["# Overview of Accounts sub-API\n\nThe Accounts sub-API within the Merchant API lets you programmatically create,\nconfigure, and manage your Google Merchant Center accounts. It offers a\ncomprehensive suite of tools for managing the entire lifecycle and core\nconfigurations of your Merchant Center accounts. This API is essential for\nbusinesses and third-party providers looking to automate account setup and\nongoing maintenance.\n\nWith the Accounts sub-API, you can do the following:\n\n- **Perform core Merchant Center account operations:** Creating new Merchant Center accounts, retrieving their details, updating core settings, monitoring for account-level issues, listing accounts you can access, and deleting accounts when necessary.\n- **Establish your business information and online store presence:** Configure your essential business details (like address and contact information), self-declared identity attributes, and set up your online store's website by specifying, verifying, and claiming your homepage URL. This is key to how your business is represented.\n- **Manage user access and communication preferences:** Discover how to control who can access your Merchant Center account, define their specific permissions, and configure their email notification preferences for important account updates and news.\n- **Manage program enrollment and participation:** Manage your enrollment in various Merchant Center programs (like Free listings or Shopping ads), manage your participation status, and understand program-specific requirements to expand your product's reach.\n- **Configure logistics: shipping, returns, and regions:** Set up your account-level shipping settings, define your online return policies for customers, and create geographical regions for precise targeting and service delivery.\n- **Leverage advanced integrations and account linking:** Learn to manage settings for omnichannel experiences, link to Google Business Profile accounts and local feeds partnership (LFP) providers, and establish and manage service relationships with other accounts, such as third-party providers or agencies.\n\nThis set of guides provides detailed instructions and examples for common use\ncases:\n\n- **[Create an account](//developers.google.com/merchant/api/guides/accounts/create-and-configure):** Learn the steps to programmatically establish a new Merchant Center account.\n- **[Create and manage sub-accounts](/merchant/api/guides/accounts/sub-accounts):** Discover how to create and oversee accounts if you operate an [advanced account](//support.google.com/merchants/answer/14089347), essential for managing multiple sellers or brands.\n- **[Relationships](//developers.google.com/merchant/api/guides/accounts/relationships):** Understand how service relationships between different Merchant Center accounts (e.g., with advanced accounts or third-party providers) are structured and managed.\n- **[Link a Google Business Profile](//developers.google.com/merchant/api/guides/accounts/link-business-profile):** Connect your Merchant Center account with your Google Business Profile to enhance your local business presence.\n- **[Control access to your account](//developers.google.com/merchant/api/guides/accounts/control-access):** Manage user permissions and roles within your Merchant Center account to control who can perform specific actions.\n- **[Manage Merchant Center email notifications](//developers.google.com/merchant/api/guides/accounts/email-notifications):** Customize the email notifications you and other users receive for account alerts, news, and tips.\n- **[Manage homepage settings](//developers.google.com/merchant/api/guides/accounts/manage-homepage-settings):** Set, verify, and claim your online store's website URL, a crucial step for account verification and program participation.\n- **[Content API migration](//developers.google.com/merchant/api/guides/compatibility/accounts):** To learn about the migration from Content API for Shopping, see Migrate account management.\n\nMerchant Center account structure and relationships\n---------------------------------------------------\n\nThe Merchant Center ecosystem supports different account structures to cater to\nvarious business needs. These accounts can also form relationships with each\nother, where one account (a service provider) offers specific services to\nanother. The Accounts sub-API lets you interact with and manage these types and\ntheir relationships.\n\n### Merchant Accounts\n\nThis is a Merchant Center account, typically used by an individual business to\nmanage their own product listings and programs directly.\n\n**Common Use Cases:**\n\n- Small to medium-sized businesses managing their own ecommerce presence.\n- Merchants who want direct control over their Google Merchant Center setup.\n- Merchants who use ecommerce platforms where the platform helps create and manage their account.\n\n**Relationships and services:**\n\nMerchant accounts can be linked to service providers for assistance with tasks\nlike product data management or account and campaign management.\n\n### Advanced Accounts\n\nAn [advanced account](//support.google.com/merchants/answer/14089347) is a specialized account within Google\nMerchant Center. It's designed for businesses and platforms that need to manage\nmultiple Merchant Center accounts at scale.\n| **Important:** Some API methods are not applicable to advanced accounts. Refer to individual method documentation for details on applicability.\n\n**Common use cases:**\n\n- **Store builders:** Ecommerce platforms that enable merchants to create and operate their online stores.\n- **Marketplaces:** Online platforms that host multiple individual merchants selling their products.\n- **Merchants that own multiple brands:** These merchants own multiple brands and sell products in physical stores or online on multiple domains.\n- **International retailers:** Retailers selling products across multiple countries and domains.\n- **Channel partners:** Entities that help merchants list their products on various marketing channels and often provide related services.\n\n**Relationships and Services:**\n\nWhile all advanced accounts manage multiple merchant accounts, the optimal\nconfiguration and use of relationships and services often differ based on the\nspecific business model. Understanding these distinctions is key to leveraging\nthe API effectively. The following are recommended best practices for common use\ncases:\n\n#### Store builders and Channel partners\n\nThese partners should create an advanced account and establish relationships\nwith the merchants they work with.\n\n- **For existing Merchant Center accounts:** The platform should establish an `Account Management` service link with the merchant's existing individual account. This allows the platform to manage aspects of the account with the merchant's consent.\n- **For new merchants without an account:** The platform can use the API to create a new individual Merchant Center account for the merchant. A new account can be created under the platform's advanced account using the `Account Aggregation` service.\n\n| **Important:** The setup for Channel Partners can resemble that of Store Builders, especially if they provide services using store builder app stores. In these instances, the account relationship and service configurations may be analogous. Refer to the [Storebuilder Blueprint guide](//developers.google.com/merchant/storebuilder/online) for integration best practices.\n\n#### Marketplaces\n\nMarketplaces operate one advanced account per domain and create seller accounts\nwith the `Account Aggregation` service. It is common for marketplaces to use\nmultiple seller types, some of which require additional configuration by\nGoogle's support team. The domain claim and program management is done on the\nadvanced account level and inherited by the seller accounts. For additional\ndetails refer to the\n[valid marketplace account structure](//support.google.com/merchants/answer/14228975) help center\narticle.\n\n- **Marketplace-owned seller account:** A dedicated account for the marketplace's own products. This allows the marketplace to use its brand recognition, seller ratings, and specific 1P campaign strategies.\n- **Single-seller accounts:** Each account contains products for a single third-party seller. This structure is ideal for larger sellers requiring distinct, seller-specific attributes or running seller-specific advertising campaigns.\n- **Multi-Seller accounts:** A single account contains products from multiple third-party sellers, which simplifies the account and product management. For additional details refer to the [multi-seller accounts](//support.google.com/merchants/answer/15108683) help center article.\n\n#### Merchants that own multiple brands\n\nMulti-brand businesses typically use an advanced account to manage individual\naccounts for each brand, linked using an `Account Aggregation` service. This\nallows brands to operate independently (e.g., website claims, product data)\nwhile the advanced account simplifies centralized functions like user access,\nreporting, and sometimes campaign oversight.\n\n#### International retailers\n\nInternational retailers manage their global presence using an advanced account,\nwith individual accounts per country or region linked using an `Account\nAggregation` service. Their setup often varies based on domain structure:\n\n- **Single domain (with country subdomains/paths):** The main domain is typically claimed at the advanced account level and inherited by regional accounts. These regional accounts then focus on managing localized product data, pricing, and availability.\n- **Multiple country-specific domains:** Each regional account claims its own specific domain. In this model, the individual accounts handle local operations, while the advanced account is primarily used for centralized functions like user access, global reporting, and overarching campaign management."]]