إدارة علاقات الحسابات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استخدام واجهة برمجة التطبيقات الخاصة بالحسابات لإدارة العلاقات بين حسابك على Merchant Center ومقدّمي الخدمات الآخرين. العلاقة هي ارتباط رسمي يتيح لمزوّد الخدمة تقديم خدمات محدّدة لنشاطك التجاري.
تحدّد الخدمة الأذونات والإمكانات الممنوحة لمقدّم الخدمة، مثل إدارة المنتجات أو إدارة الحملات. على سبيل المثال، يتيح ربط حسابك على Merchant Center بحساب على "إعلانات Google" لحساب "إعلانات Google" استخدام بيانات منتجاتك لتشغيل الحملات الإعلانية.
تتألف العلاقة من السمات التالية:
- حساب Merchant Center الذي يتلقّى الخدمة
- مقدّم الخدمة
- الخدمة أو مجموعة الخدمات المقدَّمة إلى حساب Merchant Center
يمكن لمقدّمي الخدمات ربط اسم مستعار بالحسابات التي يقدّمون خدماتهم لها (هذا الاسم هو المكافئ للحقل seller_id الذي كان متوفّرًا في مصدر الحساب في Content API for Shopping). يمكن تعيين الاسم المستعار باستخدام الحقل الاختياري account_id_alias ضمن المرجع AccountRelationship، ويُستخدَم كمعرّف مخصّص.
بنية عنوان URL للوصول إلى حساب باستخدام الاسم المستعار هي
GET /accounts/v1/accounts/{provider}~{account_id_alias}.
الخدمات
في Accounts API، يمكن أن تتلقّى الحسابات الخدمات التالية:
تجميع الحسابات: يحدّد هذا النموذج العلاقة بين حساب متقدّم والحسابات التي يقدّم لها الخدمات. يحصل مقدّم الخدمة (الحساب المتقدّم) على إذن وصول كامل وغير مقيّد إلى الحسابات الفرعية المرتبطة. في هذه الحالة، يكون
externalAccountId هو معرّف حساب Merchant Center. عند إنشاء حساب فرعي، يجب حذف externalAccountId، لأنّه سيتم تعيينه إلى رقم تعريف الحساب عند إنشائه.
إدارة الحملات: تعمل هذه الخدمة على تصميم الرابط بين حساب على Merchant Center وحساب على "إعلانات Google"، ما يمنح حساب "إعلانات Google" إمكانية الوصول إلى بيانات المنتجات والحساب اللازمة لتنفيذ الحملات الإعلانية. مقدّم الخدمة في هذه الحالة هو GOOGLE_ADS، وexternalAccountId هو معرّف حساب "إعلانات Google".
مقارنة الأسعار: يمثّل هذا الحقل العلاقة مع خدمة مقارنة أسعار (CSS) تدير حساب Merchant Center.
إدارة البيانات المحلية: تمثّل هذه السمة العلاقة مع مدير متجر لإدارة المنتجات المتوفرة محليًا والبيانات باستخدام ملف تجاري على Google.
إدارة الحساب: تتيح هذه الخدمة لمقدّم الخدمة تنفيذ إجراءات إدارية على حساب Merchant Center، مثل ضبط إعدادات الحساب أو إدارة المستخدمين أو تعديل معلومات النشاط التجاري. يمكن للمؤسسة أيضًا تقييد إذن الوصول الممنوح.
إدارة المنتجات: تتيح هذه الخدمة للموفّرين إدارة المنتجات والميزات ذات الصلة، مثل مصادر البيانات والقواعد.
مصافحة
لإنشاء خدمة، يجب أن يمنح كل من الحساب الذي يقدّم الخدمة والحساب الذي يتلقّى الخدمة الإذن بالاتصال. وتُعرف عملية التفويض هذه باسم المصافحة.
المصافحة هي عملية تتضمّن خطوتَين:
- يقترح أحد الطرفين رابطًا للخدمة.
- يوافق الطرف الآخر على الاقتراح أو يرفضه.
بعد قبول الاقتراح، تتم الموافقة على الخدمة ويتم اعتبارها منشأة بالكامل. يتم الآن منح أي حق وصول تم منحه لمقدّم الخدمة للمستخدمين المؤهّلين (راجِع حقوق الوصول أدناه).
يُرجى العِلم أنّ المستخدم الذي ينشئ عرضًا أو يرفضه أو يوافق عليه يجب أن تتوفّر لديه ADMIN أذونات الوصول إلى الحساب الذي يبدأ العملية. لذلك، إذا كان مقدّم الخدمة يقترح خدمة، يجب أن يكون المستخدم الذي يقدّم الاقتراح ADMIN في حساب مقدّم الخدمة، ويجب أن يكون المستخدم الذي يقبل الاقتراح أو يرفضه ADMIN في الحساب المستلِم.
سلوك المصافحة الخاص بالخدمة
في ما يلي وصف لمتطلبات المصافحة المحدّدة لكل خدمة على حدة:
تجميع الحسابات: لا يمكن إنشاء هذه الخدمة إلا كجزء من عملية إنشاء الحساب. من المتوقّع أن يكون مقدّم الخدمة حسابًا متقدّمًا، ويتم تلقائيًا الموافقة على الخدمة لأنّ مستخدمي الحساب المتقدّم لديهم إذن وصول كامل ADMIN إلى الحساب الذي يتم إنشاؤه.
إدارة الحملات: على الرغم من أنّ هذه العملية تتّبع عملية المصافحة العادية، يتم تقديم الاقتراحات في نظام واحد (مثل "إعلانات Google") ويتم الحصول على الموافقات في النظام الآخر (مثل Merchant Center أو من خلال Merchant API).
إدارة البطاقات المحلية: بالنسبة إلى هذه الخدمة، يتم اقتراح المصافحة في طريقة مخصّصة، ويتم الحصول على الموافقات في النظام الآخر (مثل "الملف التجاري على Google"). يمكنك الاطّلاع على الخطوات التفصيلية في
دليل ربط ملف تجاري على Google.
إدارة الحساب: تنطبق على هذه الخدمة عملية المصافحة العادية (يقترحها مقدّم الخدمة أو النشاط التجاري، ثم يقبلها الطرف الآخر).
إدارة المنتجات: تنطبق على هذه الخدمة عملية المصافحة العادية (يقترح أحد الطرفين، ثم يقبل الطرف الآخر).
أذونات الوصول
يوفّر كل نوع خدمة مستوى معيّنًا من الوصول لمستخدمي مقدّم الخدمة إلى الحساب الذي تتم خدمته:
تجميع الحسابات: تمنح هذه الخدمة حقوق ADMIN الكاملة.
إدارة الحملات: توفّر هذه الخدمة إذن وصول محدودًا، ما يتيح لحساب "إعلانات Google" المرتبط الوصول إلى المنتجات ومعلومات الحساب الأساسية.
مقارنة الأسعار: توفّر هذه الخدمة تلقائيًا حقوق ADMIN الكاملة. ومع ذلك، يمكن للمؤسسة حظر الوصول الممنوح في Merchant Center.
إدارة البطاقات المحلية: لا توفّر هذه الخدمة أي حق وصول مباشر.
بدلاً من ذلك، يتيح هذا الخيار للمنتج المدرَج مزامنة منتجاته مع حساب Merchant Center.
ملاحظة مهمة: تنطبق حقوق الوصول الموضّحة لأنواع الخدمات التالية على مقدّمي الخدمات المعتمَدين فقط. يُرجى التواصل مع فريق الدعم إذا كنت مقدّم خدمة وتريد الاستفادة من هذه الإمكانية. إذا تمت الموافقة على استخدامك accounts.link سابقًا لإدارة المنتجات في Content API for Shopping، يمكنك استخدام هذه الخدمة في Merchant API بدون الحاجة إلى موافقات إضافية.
إذا كنت منصة تابعة لجهة خارجية تدير حسابات نيابةً عن مؤسسات أخرى، يوضّح ما يلي كيفية ربط المفاهيم المختلفة ببنية حسابك:
- مقدّم الخدمة: الحساب المتقدّم
- الحساب الذي يتلقّى الخدمة: هو حساب على Merchant Center يمثّل النشاط التجاري الذي تديره.
- الخدمة:
accountAggregation، إذا كنت بصدد إنشاء هذه الحسابات كحسابات فرعية
لحسابك المتقدّم. ومع ذلك، لا ننصح بذلك، والخدمة المفضّلة هي accountManagement.accountManagement، إذا كنت بصدد إعداد هذه الخدمة بعد إنشاء الحسابات التي ليست حسابات فرعية من حسابك المتقدّم.
للحصول على تفاصيل حول كيفية إعداد حساب بامتيازات متقدّمة وربطه بحسابات جديدة على Merchant Center، يُرجى الاطّلاع على إنشاء حسابات فرعية وإدارتها.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eMerchant accounts can be linked through various relationships, defining the services one account provides to another.\u003c/p\u003e\n"],["\u003cp\u003eEach relationship includes a service provider, an external account ID, a service recipient, and the service(s) offered.\u003c/p\u003e\n"],["\u003cp\u003eA primary relationship type is "account aggregation," where an aggregator (like an advanced account) provides services to sub-accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eservice\u003c/code\u003e type specifies the access level granted to the service provider, such as admin access in account aggregation.\u003c/p\u003e\n"],["\u003cp\u003eAdvanced accounts can manage sub-accounts, enabling third-party platforms to manage merchants under their hierarchy.\u003c/p\u003e\n"]]],[],null,["# Manage account relationships\n\nYou can use the Accounts API to manage the relationships between your\nMerchant Center account and other service providers. A relationship is a formal\nconnection that enables a provider to offer specific services to your business.\nA service defines the permissions and capabilities granted to the provider, such\nas product management or campaign management. For example, linking your Merchant\nCenter account to a Google Ads account allows the Ads account to use your\nproduct data for running ad campaigns.\n\nA relationship is composed of the following attributes:\n\n- The Merchant Center account receiving the service\n- The service provider\n- The service or set of services being provided to the Merchant Center account\n\nService providers can associate an alias with accounts they service (this is the\nequivalent of the `seller_id` field that was present in the\n[account](/shopping-content/reference/rest/v2.1/accounts#resource:-account)\nresource in Content API for Shopping). The alias can be assigned using the\noptional `account_id_alias` field within the `AccountRelationship` resource and\nserves as a custom identifier.\n\nThe URL structure for accessing an account using its alias is\n`GET /accounts/v1/accounts/{provider}~{account_id_alias}`.\n\nServices\n--------\n\nIn the Accounts API, accounts can receive the following services:\n\n- **Account aggregation** : This models the relationship between an [advanced\n account](//support.google.com/merchants/answer/188487) and the accounts it\n is providing services to. The service provider (the advanced account) gets\n full, unrestricted access to the linked sub-accounts. The\n `externalAccountId` is, in this case, the identifier of the Merchant Center\n account. When you [create a sub-account](/merchant/api/guides/accounts/sub-accounts),\n the `externalAccountId` must be omitted, as it will be assigned to the\n account's ID upon creation.\n\n- **Campaign management** : This service models the link between a Merchant\n Center account and a Google Ads account, giving the Ads account access to\n product and account data needed to run ad campaigns. The service provider in\n this case is `GOOGLE_ADS` and the `externalAccountId` is the ID of the\n Google Ads account.\n\n- **Comparison shopping**: This represents the relationship with a Comparison\n Shopping Service (CSS) that operates the Merchant Center account.\n\n- **Local listing management**: This represents the relationship with a store\n manager for managing local inventory and listings using a Google business\n profile.\n\n- **Account management**: This service enables the provider to perform\n administrative actions on the Merchant Center account, such as configuring\n account settings, managing users, or updating business information. The\n business can also restrict the access granted.\n\n- **Products management**: This service allows providers to manage products\n and related features like data sources and rules.\n\nHandshake\n---------\n\nTo establish a service, both the account providing the service and the account\nreceiving the service must authorize the connection. This authorization process\nis called a handshake.\n\nThe handshake is a two-step process:\n\n1. One party proposes a service link.\n2. The other party approves or rejects the proposal.\n\nOnce a proposal has been accepted, the service is approved and considered fully\nestablished. Any access right conferred to the service provider\nis now granted to qualified users (See [access rights](#access-rights) below).\n\nNote that the user creating a proposal, rejecting, or approving it must have\n`ADMIN` [access\nrights](/merchant/api/reference/rest/accounts_v1/accounts.users#accessright)\non the account initiating the process. So if the service provider\nproposes a service, the user making the proposal must be an `ADMIN` on the\nservice provider's account and the user accepting or rejecting the proposal\nmust be an `ADMIN` on the receiving account.\n\nService-specific handshake behavior\n-----------------------------------\n\nThe following is a description of the specific handshake requirements for each\nindividual service:\n\n- **Account aggregation** : This service can only be established as part of\n account creation. The service provider is expected to be an advanced\n account, and the service is automatically approved since users of the\n advanced account have full `ADMIN` access to the account being created.\n\n- **Campaign management**: While this follows the normal handshake process,\n proposals are made in one system (for example Google Ads) and approvals are\n done in the other system (for example in Merchant Center or through the\n Merchant API).\n\n- **Local listing management** : For this service, handshake is proposed in a\n dedicated method and approvals are done in the other system (for example\n Google business profile). Detailed steps are in the\n [Guide to link a Google business profile](/merchant/api/guides/accounts/link-business-profile).\n\n- **Account management**: For this service, the regular handshake process\n applies (proposed by the service provider or business, followed by\n acceptance from the other party).\n\n- **Products management**: For this service, the regular handshake process\n applies (proposed by one party, followed by acceptance from the other).\n\nAccess rights\n-------------\n\nEach service type provides a certain level of access for users of the service\nprovider over the account being serviced:\n\n- **Account aggregation** : This service provides full `ADMIN` rights.\n\n- **Campaign management**: This service provides a restricted access right,\n allowing the associated Ads account to access products and basic account\n information.\n\n- **Comparison shopping** : This service provides, by default, full `ADMIN`\n rights. However, the business can restrict the access granted in Merchant\n Center.\n\n- **Local listing management**: This service provides no direct access right.\n Instead, it enables the listing to synchronize its products with the\n Merchant Center account.\n\n**Important** : The access rights described for the following service types apply\nonly to approved service providers. Reach out to our [support\nteam](/merchant/api/support/get-help) if you are a\nservice provider and want to make use of this capability. If you were already\npreviously approved for the `accounts.link` method for products management in\nContent API for Shopping, you can use this service in Merchant API without\nfurther approvals.\n\n- **Account management** : This service provides, by default, full `ADMIN`\n rights.\n\n- **Products management** : This service provides full `ADMIN` rights. Note\n that in the future, this will be limited to only product-related access\n rights.\n\nHow relationships apply for third-party platforms\n-------------------------------------------------\n\nIf you are a third-party platform that manages accounts on behalf of other\nbusinesses, the following shows how the different concepts map to your account\nstructure:\n\n1. **Service provider** : Your [advanced\n account](//support.google.com/merchants/answer/188487).\n2. **Account receiving the service**: A Merchant Center account that represents the business you manage.\n3. **Service** :\n - `accountAggregation`, if you are creating these accounts as sub-accounts of your advanced account. However, this is discouraged and the preferred service is `accountManagement`.\n - `accountManagement`, if you are establishing this service after account creation to accounts that are not sub-accounts of your advanced account.\n\nFor details about how to set up an [advanced\naccount](//support.google.com/merchants/answer/188487) and link to new Merchant\nCenter accounts, see [Create and manage\nsub-accounts](/merchant/api/guides/accounts/sub-accounts)."]]
