نظرة عامة على واجهة برمجة التطبيقات الفرعية "الحسابات"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك واجهة برمجة التطبيقات الفرعية "الحسابات" ضمن Merchant API إنشاء حساباتك على Google Merchant Center وإعدادها وإدارتها آليًا. تقدّم هذه المنصة مجموعة شاملة من الأدوات لإدارة دورة الحياة الكاملة والإعدادات الأساسية لحساباتك على Merchant Center. تُعدّ واجهة برمجة التطبيقات هذه ضرورية للأنشطة التجارية وموفّري الخدمات التابعين لجهات خارجية الذين يتطلّعون إلى إعداد الحسابات وصيانتها بشكل آلي.
باستخدام واجهة برمجة التطبيقات الفرعية "الحسابات"، يمكنك إجراء ما يلي:
تنفيذ العمليات الأساسية في حساب Merchant Center: إنشاء حسابات جديدة على Merchant Center، واسترداد تفاصيلها، وتعديل الإعدادات الأساسية، وتتبُّع المشاكل على مستوى الحساب، وعرض قائمة بالحسابات التي يمكنك الوصول إليها، وحذف الحسابات عند الضرورة
تحديد معلومات نشاطك التجاري وحضوره على الإنترنت: يمكنك ضبط التفاصيل الأساسية لنشاطك التجاري (مثل العنوان ومعلومات الاتصال) وسمات الهوية التي تم الإفصاح عنها ذاتيًا، وإعداد الموقع الإلكتروني لمتجرك على الإنترنت من خلال تحديد عنوان URL لصفحتك الرئيسية وإثبات ملكيته والمطالبة به. وهذا أمر أساسي لطريقة تمثيل نشاطك التجاري.
إدارة أذونات الوصول إلى الحساب وإعدادات التواصل المفضّلة: تعرَّف على كيفية التحكّم في المستخدمين الذين يمكنهم الوصول إلى حسابك على Merchant Center، وتحديد أذوناتهم المحدّدة، وضبط إعدادات تلقّي الإشعارات عبر البريد الإلكتروني بشأن الأخبار والتحديثات المهمة في الحساب.
إدارة عملية التسجيل والمشاركة في البرامج: يمكنك إدارة عملية التسجيل في برامج مختلفة من Merchant Center (مثل البيانات المجانية أو إعلانات Shopping)، وإدارة حالة مشاركتك، والتعرّف على المتطلبات الخاصة بكل برنامج لتوسيع نطاق وصول منتجك إلى العملاء.
ضبط الخدمات اللوجستية: الشحن والمرتجعات والمناطق: يمكنك ضبط إعدادات الشحن على مستوى الحساب، وتحديد سياسات الإرجاع على الإنترنت للعملاء، وإنشاء مناطق جغرافية لاستهداف العملاء بدقة وتقديم الخدمات.
الاستفادة من عمليات الدمج المتقدّمة وربط الحسابات: تعرَّف على كيفية إدارة الإعدادات للحصول على تجارب شاملة على جميع القنوات، والربط بحسابات "الملف التجاري على Google" ومقدّمي خدمات "الشراكة في الخلاصات المحلية" (LFP)، وإنشاء علاقات خدمة وإدارتها مع حسابات أخرى، مثل مقدّمي الخدمات أو الوكالات التابعة لجهات خارجية.
تقدّم هذه المجموعة من الأدلة تعليمات مفصّلة وأمثلة على حالات الاستخدام الشائعة:
إنشاء حساب: تعرَّف على خطوات إنشاء حساب جديد على Merchant Center آليًا.
العلاقات: يمكنك فهم كيفية تنظيم وإدارة علاقات الخدمة بين حسابات مختلفة على Merchant Center (مثل الحسابات بامتيازات متقدّمة أو مقدّمي الخدمات الخارجيين).
ربط ملف تجاري على Google: يمكنك ربط حسابك على Merchant Center بملفك التجاري على Google لتعزيز حضور نشاطك التجاري المحلي.
التحكّم في الوصول إلى حسابك: يمكنك إدارة أذونات المستخدمين وأدوارهم في حسابك على Merchant Center للتحكّم في المستخدمين الذين يمكنهم تنفيذ إجراءات معيّنة.
إدارة إعدادات الصفحة الرئيسية: يمكنك ضبط عنوان URL الخاص بموقعك الإلكتروني، وإثبات ملكيته، والمطالبة به، وهي خطوة أساسية لإثبات ملكية الحساب والمشاركة في البرنامج.
نقل البيانات في Content API: للتعرّف على عملية نقل البيانات من Content API for Shopping، يُرجى الاطّلاع على مقالة نقل بيانات إدارة الحساب.
بنية حساب Merchant Center وعلاقاته
يتيح نظام Merchant Center الأساسي بنى حسابات مختلفة لتلبية احتياجات المؤسسات المتنوعة. يمكن أن تنشئ هذه الحسابات أيضًا علاقات مع بعضها البعض، حيث يقدّم أحد الحسابات (مقدّم خدمة) خدمات معيّنة إلى حساب آخر. تتيح لك واجهة برمجة التطبيقات الفرعية "الحسابات" التفاعل مع هذه الأنواع وإدارتها، بالإضافة إلى علاقاتها.
حسابات التجار
هذا هو حساب Merchant Center، ويستخدمه عادةً نشاط تجاري فردي لإدارة برامجه وقوائم منتجاته مباشرةً.
حالات الاستخدام الشائعة:
الأنشطة التجارية الصغيرة والمتوسطة الحجم التي تدير حضورها على الإنترنت بنفسها
التجّار الذين يريدون التحكّم مباشرةً في عملية إعداد حساباتهم على Google Merchant Center
التجّار الذين يستخدمون منصات للتجارة الإلكترونية تساعدهم في إنشاء حساباتهم وإدارتها
العلاقات والخدمات:
يمكن ربط حسابات التجّار بمزوّدي الخدمات للحصول على المساعدة في مهام مثل إدارة بيانات المنتجات أو إدارة الحسابات والحملات.
الحسابات بامتيازات متقدّمة
الحساب المتقدّم هو حساب متخصص ضمن Google Merchant Center. وهي مصمّمة للمؤسسات والمنصات التي تحتاج إلى إدارة حسابات متعدّدة على Merchant Center على نطاق واسع.
حالات الاستخدام الشائعة:
منصّات إنشاء المتاجر: هي منصّات للتجارة الإلكترونية تتيح للتجّار إنشاء متاجرهم على الإنترنت وتشغيلها.
الأسواق: هي منصات على الإنترنت تستضيف عدة تجار فرديين يبيعون منتجاتهم.
التجّار الذين لديهم عدّة علامات تجارية: يملك هؤلاء التجار عدّة علامات تجارية ويبيعون المنتجات في المتاجر أو على الإنترنت من خلال نطاقات متعدّدة.
بائعو التجزئة العالميون: بائعو التجزئة الذين يبيعون المنتجات في بلدان ونطاقات متعدّدة
شركاء القنوات: الجهات التي تساعد التجّار في إدراج منتجاتهم على قنوات تسويقية مختلفة وتقدّم غالبًا خدمات ذات صلة.
العلاقات والخدمات:
مع أنّ جميع الحسابات المتقدّمة تدير حسابات متعدّدة للتجّار، يختلف الإعداد والاستخدام الأمثلَين للعلاقات والخدمات غالبًا استنادًا إلى نموذج النشاط التجاري المحدّد. إنّ فهم هذه الفروق الدقيقة هو المفتاح للاستفادة من واجهة برمجة التطبيقات بفعالية. في ما يلي أفضل الممارسات المقترَحة لحالات الاستخدام الشائعة:
منشئو المتاجر وشركاء القنوات
على هؤلاء الشركاء إنشاء حساب متقدّم وإقامة علاقات مع التجّار الذين يتعاملون معهم.
بالنسبة إلى حسابات Merchant Center الحالية: يجب أن تنشئ المنصة رابط خدمة مع الحساب الفردي الحالي للتاجر.Account Management يتيح ذلك للمنصة إدارة جوانب الحساب بموافقة التاجر.
بالنسبة إلى التجّار الجدد الذين ليس لديهم حساب: يمكن للمنصة استخدام واجهة برمجة التطبيقات لإنشاء حساب فردي جديد على Merchant Center للتاجر. يمكن إنشاء حساب جديد ضمن الحساب المتقدّم على المنصة باستخدام خدمة Account Aggregation.
الأسواق
تستخدم الأسواق حسابًا واحدًا بامتيازات متقدّمة لكل نطاق، وتنشئ حسابات البائعين باستخدام خدمة Account Aggregation. من الشائع أن تستخدم الأسواق أنواعًا متعددة من البائعين، ويتطلّب بعضها إعدادات إضافية من فريق الدعم في Google. يتم إثبات ملكية النطاق وإدارة البرنامج على مستوى الحساب المتقدّم، وتتلقّى حسابات البائعين هذه الإعدادات. للحصول على تفاصيل إضافية، يُرجى الاطّلاع على مقالة بنية حساب السوق الصالحة في مركز المساعدة.
حساب البائع التابع للسوق: هو حساب مخصّص للمنتجات الخاصة بالسوق. يتيح ذلك للسوق استخدام تمييز علامته التجارية وتقييمات البائعين واستراتيجيات حملات الطرف الأول المحدّدة.
حسابات البائع الفردي: يحتوي كل حساب على منتجات لبائع خارجي واحد. هذه البنية مثالية للبائعين الأكبر حجمًا الذين يحتاجون إلى سمات مميزة خاصة بالبائعين أو الذين يطلقون حملات إعلانية خاصة بالبائعين.
حسابات البائعين المتعدّدين: يحتوي حساب واحد على منتجات من عدة بائعين خارجيين، ما يسهّل إدارة الحسابات والمنتجات.
للحصول على تفاصيل إضافية، يُرجى الرجوع إلى مقالة مركز المساعدة حول حسابات البائعين المتعدّدين.
التجّار الذين يملكون علامات تجارية متعدّدة
تستخدم الأنشطة التجارية المتعدّدة العلامات التجارية عادةً حسابًا بامتيازات متقدّمة لإدارة الحسابات الفردية لكل علامة تجارية، ويتم ربطها باستخدام خدمة 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."]]
