rocket
نقدّم لك
Merchant API
التي تحلّ رسميًا محلّ Content API في Shopping.
updateالاطّلاع على آخر الأخبار
بشأن الميزات الجديدة وإصلاحات الأخطاء وتحديثات الإصدارات من Merchant API
point_of_sale
تعرَّف على كيفية إدارة نشاطك التجاري ومنتجاتك على Google وكيفية الحصول على إذن وصول آلي إلى البيانات والإحصاءات والميزات الفريدة على نطاق واسع.
ابدأ استخدام Merchant API اليوم.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملخّص
عند ربط حساب حالي على إعلانات Google بحساب إداري، لن يتغيّر حساب "إعلانات Google" وسجلّه. لن يفقد المعلنون الأصليون إذن الوصول إلى الفوترة أو تسجيل الدخول.
يمكنك أيضًا ربط حساب إداري آخر بحسابك الإداري، ما يتيح لك إدارة البيانات وعرضها لكلّ حسابات "إعلانات Google" ضمن ذلك الحساب الإداري.
يمكن أن يكون لدى الحساب الإداري حساب إداري واحد فقط أعلى منه بدرجة واحدة.
لا يمكن ربط حساب فردي على "إعلانات Google" بأكثر من خمسة حسابات إدارية، ويجب ألا يتجاوز عمق بنية حسابك الإداري ستة مستويات.
بعد مراجعة البنود، أدخِل رقم تعريف العميل الخاص بحساب "إعلانات Google". لربط عدة حسابات مرة واحدة، أدخِل رقم تعريف واحدًا للعميل في كل سطر.
انقر على إرسال الطلب. يتلقّى حساب "إعلانات Google" إشعارًا في الحساب ورسالة إلكترونية تدعوه إلى الربط بحسابك الإداري.
يظهر إشعار في انتظار المراجعة في طلبات الربط في انتظار المراجعة ضمن حسابك الإداري. بعد أن يقبل الحساب المدعو دعوتك، ستتلقّى تأكيدًا بالبريد الإلكتروني وسيتم ربط الحسابات. يمكنك الاطّلاع على مقالة ربط الحسابات لمزيد من المعلومات.
قبول الربط
يمكن لأي مستخدم لديه إذن وصول إداري إلى الحساب المدعو أو إلى حساب إداري مرتبط قبول دعوتك باتّباع الخطوات التالية:
انقر على رمز الترس.
اختَر إعدادات الحساب من القائمة المنسدلة.
اختَر الوصول إلى الحساب من قائمة التنقّل الجانبية، ثمّ انقر على قبول الدعوة.
يمكن منح الحسابات الإدارية مستويات الوصول التالية:
يجب أن يبدأ الحساب الإداري عملية ربط الحسابات وأن يوافق عليها الحساب الفردي. يتم تخزين حالة الرابط في الحقل status ضمن CustomerClientLink أو CustomerManagerLink.
اطّلِع على قائمة
الحالات الصالحة. استخدِم
PENDING لبدء عملية الربط، وACTIVE لقبول الربط.
يمكن ربط حسابَين حاليَين على "إعلانات Google" من خلال اتّباع الخطوات التالية:
أثناء المصادقة بصفتك الحساب الإداري، أرسِل دعوة إلى حساب العميل من خلال إنشاء CustomerClientLink بالحالة PENDING.
أثناء المصادقة بصفتك حساب العميل، اقبل الدعوة من الحساب الإداري عن طريق تعديل CustomerManagerLink لتصبح حالته ACTIVE.
إذا لم يكن لديك إذن الوصول إلى الحساب الفرعي، استخدِم أحد الخيارَين التاليَين استنادًا إلى عملية التنفيذ:
مسارات المستخدمين على الويب
استخدِم نموذج مصادقة تطبيق الويب OAuth لإعداد مصادقة OAuth2
لبرنامجك نيابةً عن الحساب الفرعي. للحصول على تعليمات حول كيفية إعداد مصادقة متعددة المستخدمين، اتّبِع التعليمات الواردة في مكتبة البرامج.
تطبيقات أخرى
ننصحك بتنفيذ نظام انتظار يتحقّق من الدعوات المعلّقة بشكل دوري.
للاطّلاع على نماذج التعليمات البرمجية حول كيفية إدارة حسابات "إعلانات Google" باستخدام Google Ads API (بما في ذلك الحسابات المتقدّمة والفرعية والاختبارية)، راجِع إدارة الحسابات.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLinking a Google Ads account to a manager account preserves the original account's history, access, and billing, allowing centralized management.\u003c/p\u003e\n"],["\u003cp\u003eManager accounts offer hierarchical management, with up to six levels and a limit of five manager accounts per individual Google Ads account.\u003c/p\u003e\n"],["\u003cp\u003eLinking can be done manually through the Google Ads UI or automatically using the Google Ads API, requiring actions from both the manager and client accounts.\u003c/p\u003e\n"],["\u003cp\u003eManager accounts can have varying access levels to linked accounts, including administrative, standard, read-only, and email-only.\u003c/p\u003e\n"],["\u003cp\u003eDetailed instructions for manual and automatic linking, along with access level information, are provided in linked resources for comprehensive guidance.\u003c/p\u003e\n"]]],[],null,["# Administer an existing Google Ads account\n\nSummary\n-------\n\nWhen you link an existing [Google Ads](/google-ads/api/docs/start) account to a\nmanager account, the Google Ads account and its history don't change. The\noriginal advertisers don't lose access to billing or sign-in.\n\nYou can also link another manager account to your manager account, which lets\nyou manage and view data for all of the Google Ads accounts under that manager\naccount.\n\nA manager account can only have one manager account directly above it.\n\nAn individual Google Ads account can be linked to no more than five manager\naccounts, and your manager account structure can be no more than six levels\ndeep.\n\nManual steps\n------------\n\n### Request link\n\n1. [Find the Google Ads customer ID](https://support.google.com/google-ads/answer/1704344) for the account you want to manage in the top right corner of the Google Ads account.\n2. Sign in to your manager account on the [Google Ads UI](https://ads.google.com).\n3. Click the **Accounts** tab.\n4. Click the **Performance** tab.\n5. Click the **+** plus button.\n6. Click **+ Link existing account**.\n7. Once you've reviewed the terms, enter the Google Ads Customer ID. To link multiple accounts at once, enter one Customer ID per line.\n8. Click **SEND REQUEST**. The Google Ads account receives an account notification and email that invite them to link to your manager account.\n\nA pending notification appears in your manager account's **Pending link\nrequests** . Once the invited account accepts your invitation, you receive an\nemail confirmation and the accounts are linked. See [Link accounts](https://support.google.com/google-ads/answer/7459601) for more\ninformation.\n\n### Accept link\n\nAny user with administrative access on the invited account or on a linked\nmanager account can accept your invitation with the following steps:\n\n1. Click the gear icon.\n2. Choose **Account settings** from the drop-down menu.\n3. Select **Account access** from the side navigation, then click **Accept\n invitation**.\n\nManager accounts can be assigned the following levels of access:\n\n- Administrative\n- Standard\n- Read only\n- Email only\n\nSee [About access levels](https://support.google.com/google-ads/answer/9978556) to learn more.\n\nAutomatic steps\n---------------\n\nLinking accounts must be initiated by the manager account and accepted by the\nindividual account. The state of the link is stored in the `status` field of the\n[`CustomerClientLink`](/google-ads/api/reference/rpc/v21/CustomerClientLink) or\n[`CustomerManagerLink`](/google-ads/api/reference/rpc/v21/CustomerManagerLink).\n\nSee the [list of\nvalid statuses](/google-ads/api/reference/rpc/v21/ManagerLinkStatusEnum.ManagerLinkStatus). Use\n`PENDING` to initiate the link, and `ACTIVE` to accept the link.\n\nLinking two pre-existing Google Ads accounts can be accomplished through these\nsteps:\n\n1. While authenticating as the manager account, extend an invitation to the client account by creating a [`CustomerClientLink`](/google-ads/api/reference/rpc/v21/CustomerClientLink) with status `PENDING`.\n2. While authenticating as the manager account, query the [`GoogleAdsService`](/google-ads/api/reference/rpc/v21/GoogleAdsService) to find the [`manager_link_id`](/google-ads/api/reference/rpc/v21/CustomerClientLink#manager_link_id) of the [`CustomerClientLink`](/google-ads/api/reference/rpc/v21/CustomerClientLink) you created.\n3. While authenticating as the client account, accept the invitation from the manager account by mutating the [`CustomerManagerLink`](/google-ads/api/reference/rpc/v21/CustomerManagerLink) to have status `ACTIVE`.\n\nIf you don't have access to the sub-account, use one of the following\noptions based on your implementation:\n\nWeb flows\n: Use the [OAuth web app authentication model](/google-ads/api/docs/oauth/cloud-project) to set up OAuth2 authentication\n for your software on behalf of the sub-account. For instructions on how\n to set up multiple-user authentication, follow the instructions in the [client\n library](/google-ads/api/docs/client-libs).\n\nOther apps\n: You may want to implement a waiting system that checks for pending invitations\n periodically.\n\nFor code samples on how to manage Google Ads accounts with the Google Ads API\n(including advanced, sub- and test accounts), see [Account Management](/google-ads/api/docs/account-management/overview).\n\nSee\n[Linking to manager accounts](/google-ads/api/docs/account-management/linking-manager-accounts#procedure)\nfor more details."]]
