يمكنك تنفيذ تقرير Google Ads API باستخدام طلب البحث التالي بلغة GAQL لاسترداد قائمة بجميع الدعوات المعلّقة لربط رقم تعريف عميل على "إعلانات Google" بحساب على Merchant Center.
إذا حاول مستخدم لديه إذن مشرف في كلا الحسابين اتّباع خطوات الدعوة، سيظهر خطأ NO_INVITATION_REQUIRED. يمكنك التحقّق من هذا الخطأ والرجوع إلى مسار الرابط المباشر في مثل هذه الحالات.
رفض دعوة
تشبه عملية رفض دعوة عملية قبول دعوة، إلا أنّه يتم ضبط الحقل product_link_invitation_status على REJECTED. إذا تم رفض دعوة، ستبقى في الحالة REJECTED ولا يمكن قبولها. عليك بعد ذلك إنشاء دعوة جديدة إذا لزم الأمر.
الربط المباشر بدون دعوة
إذا كان المستخدم الذي يحاول ربط حساب "إعلانات Google" بحساب Merchant Center مشرفًا على كلا الحسابَين، يمكنه تخطّي خطوة الدعوة وربط الحسابَين مباشرةً باستخدام Google Ads API.
إذا حاول مستخدم لا يملك أذونات كافية استخدام ميزة الربط المباشر، سيظهر الخطأ CREATION_NOT_PERMITTED. يمكنك التحقّق من هذا الخطأ والرجوع إلى مسار الدعوة في مثل هذه الحالات.
عرض جميع روابط Merchant Center
يمكنك عرض تقرير Google Ads API باستخدام طلب البحث التالي بلغة GAQL لاسترداد قائمة بالروابط لرقم تعريف عميل على "إعلانات Google".
أداة "إدارة النشاط التجاري" هي تمثيل موحّد لنشاط تجاري على Google.
عند إدارة حسابك على "إعلانات Google" وحساباتك على Merchant Center باستخدام حساب على "مركز إدارة النشاط التجاري"، ينشئ
مركز إدارة النشاط التجاري تلقائيًا روابط بين حسابك على "إعلانات Google" وحساب Merchant Center.
يمكنك استرداد هذه الروابط باستخدام Google Ads API، ولكن لا يمكن تعديلها باستخدام 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\u003eTo run Shopping campaigns in Google Ads, you must first link your Google Ads and Google Merchant Center accounts.\u003c/p\u003e\n"],["\u003cp\u003eYou can link accounts by sending a request from Merchant Center and approving it in Google Ads, or directly using the Google Ads API if you have administrative access to both.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Ads API allows you to manage link requests, including listing, accepting, and rejecting invitations, as well as directly creating and removing links.\u003c/p\u003e\n"],["\u003cp\u003eIf using Google Business Manager, links are created automatically and can be retrieved, but not modified, through the Google Ads API.\u003c/p\u003e\n"]]],[],null,["# Link your Merchant Center and Google Ads accounts\n\nBefore you can create a Shopping campaign, you need to first link your Google Ads\naccount to your Google Merchant Center account as follows:\n\n1. Send a link request from your Merchant Center account to your Google Ads account.\n2. Approve the link request in your Google Ads account.\n\nSending link requests from your Merchant Center account\n-------------------------------------------------------\n\nThere are two ways of sending a link request:\n\n1. [Use the Merchant Center web interface to send a link\n request](//support.google.com/merchants/answer/6159060).\n2. [Use the Content API for Shopping](/shopping-content/guides/quickstart) to update the `adsLinks` of your [`Account`](/shopping-content/reference/rest/v2.1/accounts).\n\nManaging link requests in your Google Ads account\n-------------------------------------------------\n\nYou can change the status of Merchant Center links in your Google Ads account by\n[using the Google Ads web interface to approve or reject an\ninvitation](//support.google.com/merchants/answer/6159060). You can also\nupdate invitations or remove existing links using the Google Ads API as explained\nbelow.\n\n### List all Merchant Center invitations\n\nYou can run a [Google Ads API report](/google-ads/api/docs/reporting/overview) using the\nfollowing GAQL query to retrieve a list of all pending invitations to link a\nGoogle Ads customer ID to a Merchant Center account. \n\n SELECT\n product_link_invitation.merchant_center.merchant_center_id,\n product_link_invitation.type\n FROM product_link_invitation\n WHERE product_link_invitation.status = 'PENDING_APPROVAL'\n AND product_link_invitation.type = 'MERCHANT_CENTER'\n\nTo retrieve all invitations, remove the filtering condition for the\n`product_link_invitation.status` field in the query above.\n| **Note:** There can only be one invitation with status `REQUESTED` or `PENDING_APPROVAL` between Google Ads and Merchant Center accounts.\n\n### Accept an invitation\n\nYou can approve the link by setting the `product_link_invitation` status to\n`ACCEPTED`.\n\n1. Construct an\n [`UpdateProductLinkInvitationRequest`](/google-ads/api/reference/rpc/v21/UpdateProductLinkInvitationRequest)\n object and set the\n [`customer_id`](/google-ads/api/reference/rpc/v21/UpdateProductLinkInvitationRequest#customer_id)\n field as the Google Ads customer ID.\n\n2. Set the\n [`resource_name`](/google-ads/api/reference/rpc/v21/UpdateProductLinkInvitationRequest#resource_name)\n field as the resource name of the `product_link_invitation`.\n\n3. Set the\n [`product_link_invitation_status`](/google-ads/api/reference/rpc/v21/UpdateProductLinkInvitationRequest#product_link_invitation_status)\n to `ACCEPTED`.\n\n4. Issue an\n [`UpdateProductLinkInvitation`](/google-ads/api/reference/rpc/v21/ProductLinkInvitationService/UpdateProductLinkInvitation)\n API call.\n\nIf the invitation flow is attempted by a user who is already an\nadministrator on both accounts, then a\n[`NO_INVITATION_REQUIRED`](/google-ads/api/reference/rpc/v21/ProductLinkInvitationErrorEnum.ProductLinkInvitationError#no_invitation_required)\nerror is thrown. You can check for this error and fall back to the direct\nlink flow in such cases.\n\n### Reject an invitation\n\nRejecting an invitation is similar to [accepting an\ninvitation](#accept-invitation) except that the\n[`product_link_invitation_status`](/google-ads/api/reference/rpc/v21/UpdateProductLinkInvitationRequest#product_link_invitation_status)\nfield is set to `REJECTED`. If an invitation is rejected, it remains in the\n`REJECTED` state and cannot be accepted. You must then create a new\ninvitation if required.\n\n### Direct linking without invitation\n\nIf the user attempting to link the Google Ads account to the Merchant Center\naccount is an administrator on both accounts, then you can bypass the\ninvitation step and link both accounts directly using the Google Ads API.\n\n1. Construct a\n [`CreateProductLinkRequest`](/google-ads/api/reference/rpc/v21/CreateProductLinkRequest)\n object and set the\n [`customer_id`](/google-ads/api/reference/rpc/v21/CreateProductLinkRequest#customer_id)\n field as the Google Ads customer ID.\n\n2. Create a new [`ProductLink`](/google-ads/api/reference/rpc/v21/ProductLink) object and set\n its\n [`merchant_center_id`](/google-ads/api/reference/rpc/v21/MerchantCenterIdentifier#merchant_center_id)\n field to the ID of the Merchant Center account.\n\n3. Set the `ProductLink` to the\n [`product_link`](/google-ads/api/reference/rpc/v21/CreateProductLinkRequest#product_link)\n field of the request object.\n\n4. Issue a\n [`CreateProductLink`](/google-ads/api/reference/rpc/v21/ProductLinkService/CreateProductLink)\n API call.\n\nIf direct linking is attempted by a user who doesn't have sufficient\npermissions, then a\n[`CREATION_NOT_PERMITTED`](/google-ads/api/reference/rpc/v21/ProductLinkErrorEnum.ProductLinkError#creation_not_permitted)\nerror is thrown. You can check for this error and fall back to the\ninvitation flow in such cases.\n\n### List all Merchant Center links\n\nYou can run a [Google Ads API report](/google-ads/api/docs/reporting/overview) using the\nfollowing GAQL query to retrieve a list of links for a Google Ads customer ID. \n\n SELECT\n product_link.merchant_center.merchant_center_id,\n product_link.product_link_id\n FROM product_link\n WHERE product_link.type = 'MERCHANT_CENTER'\n\n### Unlink a link\n\nTake the following steps to unlink a link:\n\n1. Construct a\n [`RemoveProductLinkRequest`](/google-ads/api/reference/rpc/v21/RemoveProductLinkRequest)\n object and set the\n [`customer_id`](/google-ads/api/reference/rpc/v21/RemoveProductLinkRequest#customer_id)\n field as the Google Ads customer ID.\n\n2. Set the\n [`resource_name`](/google-ads/api/reference/rpc/v21/RemoveProductLinkRequest#resource_name)\n as the resource name of the `product_link`.\n\n3. Issue a\n [`RemoveProductLink`](/google-ads/api/reference/rpc/v21/ProductLinkService/RemoveProductLink)\n API call.\n\nBusiness Manager\n----------------\n\n[Business Manager](https://support.google.com/business/answer/13548166) is a unified representation of a business on Google.\nWhen you manage both your Google Ads account and your Merchant Center accounts\nusing a Business Manager account, Business Manager [automatically creates\nlinks](https://support.google.com/merchants/answer/12499498) between your Google Ads account and the Merchant Center account.\nYou can retrieve these links using the Google Ads API, but these links cannot be\nmutated with the Google Ads API."]]
