با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برای پرچم‌گذاری رابطه با حساب تجاری، شریک خرید ابتدا باید از روش accounts.link برای ارسال درخواست پیوند استفاده کند.
درخواست پیوند حاوی یک linkedAccountId است که تاجر دریافت کننده درخواست را شناسایی می کند و یک نوع action از request دارد. هر پیوند همچنین باید مجموعه‌ای از services را مشخص کند که ویژگی‌هایی را که شریک به تاجر ارائه می‌دهد برمی‌شمارد. مقادیر services زیر پشتیبانی می شوند.
خدمات
توضیحات
shoppingAdsProductManagement
مدیریت داده های محصول برای تبلیغات خرید
shoppingActionsProductManagement
مدیریت داده‌های محصول برای خرید در Google (که قبلاً Shopping Actions نامیده می‌شد)
shoppingActionsOrderManagement
مدیریت سفارش برای خرید در Google (که قبلاً Shopping Actions نام داشت)
علاوه بر این، یک درخواست همچنین باید حاوی یک linkType معتبر باشد که نوع شریک خرید درخواست را توصیف می کند. به شرکای خرید یکی از برچسب های زیر اختصاص داده شده است و باید هنگام فراخوانی API از برچسب تعیین شده خود در قسمت linkType استفاده کنند.
انواع پیوندهای معتبر
channelPartner
eCommercePlatform
مثال
تماس API زیر یک درخواست پیوند از حساب شریک 123456789 به تاجری با linkedAccountId"98765" ارسال می کند.
"eCommercePlatform"linkType شریک را به عنوان یک پلت فرم تجارت الکترونیکی شناسایی می کند. فهرست services نشان می‌دهد که شریک ویژگی‌های "shoppingAdsProductManagement" (مدیریت داده‌های محصول برای تبلیغات خرید) و "shoppingActionsOrderManagement" (مدیریت سفارش برای خرید در Google، که قبلاً به عنوان «اقدامات خرید» شناخته می‌شد) را ارائه می‌کند.
تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eTo establish a relationship, partners must send a linking request using the \u003ccode\u003eaccounts.link\u003c/code\u003e method, specifying the desired services and partner type.\u003c/p\u003e\n"],["\u003cp\u003eThe link request requires approval from the receiving merchant before it becomes fully established.\u003c/p\u003e\n"],["\u003cp\u003ePartners can be categorized as either \u003ccode\u003echannelPartner\u003c/code\u003e or \u003ccode\u003eeCommercePlatform\u003c/code\u003e and must use their designated \u003ccode\u003elinkType\u003c/code\u003e in the API call.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eservices\u003c/code\u003e field allows partners to indicate the specific features they offer to merchants, such as product and order management.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. Shopping partners must use the `accounts.link` method to request a link to a merchant account. This requires specifying the `linkedAccountId` of the merchant, the `linkType` (e.g., `channelPartner`, `eCommercePlatform`), the provided `services` (e.g., `shoppingAdsProductManagement`), and an `action` of `request`. The link requires the receiving merchant's approval to be established. An example API call is provided.\n"],null,["# Request links\n\nTo flag a relationship with a merchant account, a Shopping partner must first\nuse the [`accounts.link`](/shopping-content/reference/rest/v2.1/accounts/link)\nmethod to send a linking request.\n| **Note:** The link is not fully established until the receiving merchant approves the request.\n\nThe link request contains a [`linkedAccountId`](/shopping-content/reference/rest/v2.1/accounts/link#linkedAccountId)\nthat identifies the merchant receiving the request and has an [`action`](/shopping-content/reference/rest/v2.1/accounts/link#action)\ntype of `request`. Each link should also specificy a set of [`services`](/shopping-content/reference/rest/v2.1/accounts/link#linkType)\nthat enumerates which features the partner provides to the merchant. The following\n[`services`](/shopping-content/reference/rest/v2.1/accounts/link#linkType) values\nare supported.\n\n| Service | Description |\n|------------------------------------|--------------------------------------------------------------------------------|\n| `shoppingAdsProductManagement` | Product data management for Shopping ads |\n| `shoppingActionsProductManagement` | Product data management for Buy on Google (formerly known as Shopping Actions) |\n| `shoppingActionsOrderManagement` | Order management for Buy on Google (formerly known as Shopping Actions) |\n\nAdditionally, a request must also contain a valid [`linkType`](/shopping-content/reference/rest/v2.1/accounts/link#linkType)\nthat describes the type of Shopping partner making the request. Shopping\npartners are assigned one of the following labels and should use their designated\nlabel in the `linkType` field when calling the API.\n\n| Valid linkTypes |\n|---------------------|\n| `channelPartner` |\n| `eCommercePlatform` |\n\nExample\n-------\n\nThe following API call sends a link request from a partner's account\n`123456789` to a merchant with `linkedAccountId` of `\"98765\"`.\n\nThe `\"eCommercePlatform\"` `linkType` identifies the partner as an e-commerce\nplatform. The `services` list indicates that the partner provides\n`\"shoppingAdsProductManagement\"` (product data management for Shopping ads) and\n`\"shoppingActionsOrderManagement\"` (order management for Buy on Google, formerly\nknown as Shopping Actions) features. \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link\n {\n \"linkedAccountId\": \"98765\",\n \"linkType\": \"eCommercePlatform\",\n \"services\": [\"shoppingAdsProductManagement\", \"shoppingActionsOrderManagement\"],\n \"action\": \"request\"\n }\n\nThe [next section](/shopping-content/guides/flagging/list) describes how to get a list of existing links."]]
