با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
خدمات خرید مقایسه (CSS) می‌تواند آگهی‌های خرید را از طرف تاجران کشورهایی که برنامه CSS در آنها در دسترس است، در Google قرار دهد. Content API به دامنه های CSS و گروه های CSS اجازه می دهد تا حساب های مرتبط خود را با استفاده از برچسب ها سازماندهی کنند. دامنه‌های CSS می‌توانند حساب‌های Merchant Center مرتبط با دامنه را فهرست، برچسب‌گذاری و فیلتر کنند. گروه های CSS می توانند دامنه های CSS وابسته به گروه را برچسب گذاری و فهرست کنند. این سرویس‌های Content API معادل‌های برنامه‌ریزی شده برای برخی از ویژگی‌های موجود در مرکز خدمات خرید مقایسه را ارائه می‌کنند.
گروه‌های CSS حساب‌های سطح بالایی هستند که می‌توانند شامل یک یا چند دامنه CSS باشند.
دامنه‌های CSS حساب‌هایی برای خود CSSها هستند که تبلیغات خرید را از طرف تاجران درج می‌کنند. هر دامنه CSS فقط می تواند به یک گروه CSS تعلق داشته باشد.
حساب‌های Merchant Center بازرگانی هستند که دامنه‌های CSS برای آنها تبلیغات خرید قرار می‌دهند. CSS ها را می توان با چندین نوع مختلف از حساب های Merchant Center، از جمله حساب های چند مشتری (MCA) و حساب های تجاری فردی مرتبط کرد. هر حساب Merchant Center فقط می تواند با یک دامنه CSS مرتبط شود. برای اطلاعات بیشتر در مورد انواع حساب‌های Merchant Center، انواع حساب‌ها را در Comparison Shopping Service Center ببینید.
انواع برچسب CSS
CSS ها از دو نوع برچسب استفاده می کنند:
برچسب‌های دستی توسط دامنه‌های CSS به حساب‌های Merchant Center و توسط گروه‌های CSS به دامنه‌های CSS اختصاص داده می‌شوند.
برچسب‌های خودکار به‌طور خودکار توسط مرکز CSS ایجاد و به حساب‌های Merchant Center اختصاص داده می‌شوند. برچسب‌های خودکار برای انواع مختلف معیارهای حساب در دسترس هستند و می‌توانند به شما در شناسایی حساب‌های مهم و فعالیت‌های مهم حساب کمک کنند.
Content API نقاط پایانی زیر را برای CSS ها ارائه می دهد:
accounts.labels : به شما امکان می‌دهد برچسب‌هایی را ایجاد، بازیابی و اصلاح کنید تا به حساب‌های دامنه CSS و Merchant Center اعمال شود. برای مثال، ایجاد برچسب را ببینید.
accounts.list : به شما امکان می‌دهد تمام حساب‌های Merchant Center مرتبط با یک دامنه CSS، از جمله برچسب‌های اعمال شده برای هر حساب را بازیابی کنید. همچنین می‌توانید برای بازیابی زیرمجموعه‌ای از حساب‌های مرتبط، بر اساس شناسه id فیلتر کنید. برای مثال، استفاده از برچسب‌ها برای فیلتر کردن حساب‌های Merchant Center را ببینید.
accounts.get : به شما امکان می‌دهد برچسب‌های اعمال شده روی یک حساب Merchant Center را بازیابی کنید.
csses : به شما امکان می دهد تا ارتباط بین برچسب ها و دامنه های CSS را مشاهده و مدیریت کنید. برای مثال، به اعمال برچسب در دامنه CSS مراجعه کنید.
هنگام فراخوانی نقاط پایانی accounts به عنوان یک دامنه CSS، از شرایط زیر آگاه باشید:
دامنه های CSS باید cssId خود را به جای merchantId ارائه کنند.
دامنه های CSS باید یک پارامتر کوئری view=CSS ارائه دهند.
دامنه های CSS باید شناسه حساب Merchant Center مرتبط خود را به عنوان accountId ارائه دهند.
مثال: یک برچسب ایجاد کنید
برای ایجاد برچسب جدید می توانید از روش accounts.labels.create استفاده کنید. برچسب‌ها را می‌توان برای دامنه‌های CSS و حساب‌های Merchant Center اعمال کرد. با این حال، برچسب‌ها برای انواع مختلف حساب‌ها مجزا هستند و نمی‌توان آنها را به جای هم استفاده کرد. برای ایجاد یک برچسب در سطح دامنه، که می تواند برای حساب های Merchant Center مرتبط با دامنه اعمال شود، از شناسه دامنه CSS به عنوان accountId هنگام ایجاد برچسب استفاده کنید. برای ایجاد یک برچسب در سطح گروه، که می تواند برای دامنه های CSS وابسته به گروه اعمال شود، از شناسه گروه CSS به عنوان accountId هنگام ایجاد برچسب استفاده کنید.
مثال زیر نحوه ایجاد برچسب حساب‌های کلیدی در سطح دامنه را نشان می‌دهد که می‌توان آن را روی حساب‌های Merchant Center مرتبط با دامنه اعمال کرد. برای ایجاد برچسب، یک درخواست POST با استفاده از URL و بدنه درخواست زیر ایجاد کنید:
{"name":"key-accounts","description":"All accounts with over a million products"}
مثال: برچسبی را به حساب Merchant Center اعمال کنید
می‌توانید از روش accounts.updatelabels برای اختصاص برچسب‌ها به حساب Merchant Center مرتبط با دامنه CSS استفاده کنید. مثال زیر نحوه اعمال برچسب حساب‌های کلیدی ایجاد شده در مثال قبلی را به یکی از مهم‌ترین حساب‌های Merchant Center نشان می‌دهد.
برای اعمال برچسب، با استفاده از URL و بدنه درخواست زیر، یک درخواست POST ایجاد کنید:
مثال: از برچسب‌ها برای فیلتر کردن حساب‌های Merchant Center استفاده کنید
پس از ایجاد و اعمال برچسب‌ها به حساب‌های Merchant Center مرتبط با یک دامنه CSS، می‌توانید از روش accounts.list استفاده کنید و پارامتر query label را در درخواست خود ارسال کنید تا فقط حساب‌های دارای آن برچسب را برگردانید. مثال زیر نحوه فیلتر کردن حساب‌های Merchant Center مرتبط با یک دامنه CSS را با استفاده از id ( 123 ) برچسب حساب‌های کلیدی ایجاد شده در مثال ایجاد برچسب نشان می‌دهد. برای بازیابی حساب‌ها، با استفاده از URL زیر درخواست GET کنید:
همچنین می‌توانید از روش csses.updatelabels برای اختصاص برچسب‌ها به یک دامنه CSS وابسته به یک گروه CSS استفاده کنید. مثال زیر نشان می دهد که چگونه می توان یک برچسب در سطح گروه دامنه های کلیدی ایجاد شده با استفاده از روش accounts.labels.create را در یکی از مهم ترین حساب های دامنه CSS خود اعمال کرد. به خاطر داشته باشید که برچسب‌ها برای دامنه‌های CSS و حساب‌های Merchant Center مجزا هستند. برچسب‌های سطح گروه باید با استفاده از شناسه گروه CSS به عنوان accountId ایجاد شوند.
برای اعمال برچسب، با استفاده از URL و بدنه درخواست زیر، یک درخواست POST ایجاد کنید:
تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-08-13 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and allows Comparison Shopping Services (CSSs) to manage accounts and data programmatically.\u003c/p\u003e\n"],["\u003cp\u003eCSSs can utilize the API to organize their associated accounts using labels, which can be manually created or automatically generated based on account metrics.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides endpoints for creating, applying, and retrieving labels for both CSS domains and Merchant Center accounts.\u003c/p\u003e\n"],["\u003cp\u003eCSS domains have specific requirements when using the API, including using their \u003ccode\u003ecssId\u003c/code\u003e and specifying the \u003ccode\u003eview=CSS\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eExamples are provided for creating labels, applying labels to accounts, filtering accounts by labels, and managing labels for CSS domains.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, allows Comparison Shopping Services (CSSs) to manage Merchant Center accounts. CSSs can use `accounts.labels` to create manual labels and `accounts.updatelabels` to apply them to Merchant Center accounts or CSS domains. `accounts.list` enables filtering Merchant Center accounts by label, and `csses` manages associations between labels and CSS domains. This allows for the creation of labels to identify important accounts and use them to filter and organize accounts.\n"],null,["# CSS label management\n\nComparison Shopping Services (CSSs) can place shopping ads on Google on behalf\nof merchants in countries where the CSS program is available. The Content API\nallows CSS domains and CSS groups to organize their associated accounts using\nlabels. CSS domains can list, label, and filter the Merchant Center accounts\nassociated with the domain. CSS groups can label and list the CSS domains\naffiliated with the group. These Content API services provide programmatic\nequivalents to some of the features available in the [Comparison Shopping\nService Center](//support.google.com/merchants/answer/9773265).\n\nFor more information about CSSs, see\n[Comparison Shopping Services](//support.google.com/merchants/topic/9080307).\nFor information on working with labels in CSS Center, see\n[Use account labels in Comparison Shopping Service Center](//support.google.com/merchants/answer/9773369).\n\nCSS account types\n-----------------\n\nCSSs use the following three types of accounts:\n\n- *CSS groups* are the top-level accounts that can contain one or multiple CSS domains.\n- *CSS domains* are the accounts for the CSSs themselves, which place Shopping ads on behalf of merchants. Each CSS domain can only belong to one CSS group.\n- *Merchant Center accounts* are the merchants for which CSS domains place Shopping ads. CSSs can be associated with several different types of Merchant Center accounts, including multi-client accounts (MCAs) and individual merchant accounts. Each Merchant Center account can only be associated with one CSS domain. For more information about different types of Merchant Center accounts, see [Account types in Comparison Shopping Service Center](//support.google.com/merchants/answer/9772965).\n\nCSS label types\n---------------\n\nCSSs use two types of labels:\n\n- *Manual labels* are created and assigned to Merchant Center accounts by CSS domains, and to CSS domains by CSS groups.\n- *Automatic labels* are automatically created and assigned to Merchant Center accounts by CSS Center. Automatic labels are available for different types of account metrics and can help you identify important accounts and significant account activity.\n\nFor more information about label types, including the available automatic\nlabels, see\n[Use account labels in Comparison Shopping Service Center](//support.google.com/merchants/answer/9773369).\n\nContent API functionality and endpoints for CSSs\n------------------------------------------------\n\nThe Content API offers the following endpoints for CSSs:\n\n- [`accounts.labels`](/shopping-content/reference/rest/v2.1/accounts.labels): Allows you to create, retrieve, and modify labels to apply to CSS domain and Merchant Center accounts. For an example, see [Creating a label](#create-label).\n- [`accounts.updatelabels`](/shopping-content/reference/rest/v2.1/accounts/updatelabels): Allows you to apply labels to a single Merchant Center account. For an example, see [Applying a label to a Merchant Center account](#apply-label).\n- [`accounts.list`](/shopping-content/reference/rest/v2.1/accounts/list): Allows you to retrieve all the Merchant Center accounts associated with a CSS domain, including the labels applied to each account. You can also filter by label `id` to retrieve a subset of associated accounts. For an example, see [Using labels to filter Merchant Center accounts](#filter).\n- [`accounts.get`](/shopping-content/reference/rest/v2.1/accounts/get): Allows you to retrieve the labels applied to a single Merchant Center account.\n- [`csses`](/shopping-content/reference/rest/v2.1/csses): Allows you to view and manage the associations between labels and CSS domains. For an example, see [Applying a label to a CSS domain](#domain-label).\n\nWhen calling `accounts` endpoints as a CSS domain, be aware of the following\nrequirements:\n\n- CSS domains must provide their `cssId` instead of a `merchantId`.\n- CSS domains must provide a query parameter of `view=CSS`.\n- CSS domains must provide their associated Merchant Center account id as the `accountId`.\n\n| **Note:** Only CSS domain and CSS group accounts can use labels. Merchant Center accounts themselves do not have access to the label functionality.\n\nExample: Create a label\n-----------------------\n\nYou can use the `accounts.labels.create` method to create a new label. Labels\ncan be applied to CSS domains and Merchant Center accounts. However, labels for\nthe different account types are separate and cannot be used interchangeably. To\ncreate a domain-level label, which can be applied to Merchant Center accounts\nassociated with the domain, use the CSS domain ID as the `accountId` when\ncreating the label. To create a group-level label, which can be applied to CSS\ndomains affiliated with the group, use the CSS group ID as the `accountId` when\ncreating the label.\n\nThe following example demonstrates how to create a **domain-level** key-accounts\nlabel, which can then be applied to Merchant Center accounts associated with the\ndomain. To create the label, make a `POST` request using the following URL and\nrequest body: \n\n https://shoppingcontent.googleapis.com/content/v2.1/accounts/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nt\"\u003eaccountId\u003c/span\u003e\u003c/var\u003e/labels\n\n {\n \"name\": \"key-accounts\",\n \"description\": \"All accounts with over a million products\"\n }\n\nExample: Apply a label to a Merchant Center account\n---------------------------------------------------\n\nYou can use the `accounts.updatelabels` method to assign labels to a Merchant\nCenter account associated with a CSS domain. The following example demonstrates\nhow to apply the **key-accounts** label created in the previous example to one\nof your most important Merchant Center accounts.\n| **Note:** You must use the `id` of the label, not the name, when applying a label to a Merchant Center account. The `id` is automatically assigned to the label and returned in the response when the label is created. You can also retrieve the label `id` by calling `accounts.labels.list`.\n\nTo apply the label, make a `POST` request using the following URL and request\nbody: \n\n https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nt\"\u003ecssId\u003c/span\u003e\u003c/var\u003e/accounts/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nt\"\u003esubaccountId\u003c/span\u003e\u003c/var\u003e/updatelabels/\n\n {\n \"labelIds\": ['123'] // 'key-accounts'\n }\n\nExample: Use labels to filter Merchant Center accounts\n------------------------------------------------------\n\nAfter creating and applying labels to the Merchant Center accounts associated\nwith a CSS domain, you can use the `accounts.list` method and pass the label\nquery parameter in your request to return only the accounts with that label. The\nfollowing example demonstrates how to filter the Merchant Center accounts\nassociated with a CSS domain, using the `id` (`123`) of the **key-accounts**\nlabel created in the [Creating a label](#create-label) example. To retrieve the\naccoungs, make a `GET` request using the following URL: \n\n https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nt\"\u003ecssId\u003c/span\u003e\u003c/var\u003e/accounts?view=CSS&label=123\n\nNo request body is needed.\n\nExample: Apply a label to a CSS domain\n--------------------------------------\n\nYou can also use the `csses.updatelabels` method to assign labels to a CSS\ndomain affiliated with a CSS group. The following example demonstrates how to\napply a **key-domains** group-level label created using the\n`accounts.labels.create` method to one of your most important CSS domain\naccounts. Keep in mind that labels for CSS domains and Merchant Center accounts\nare separate. Group-level labels must be created using a CSS group ID as its\n`accountId`.\n| **Note:** You must use the `id` of the label, not the name, when applying a label to a CSS domain. The `id` is automatically assigned to the label and returned in the response when the label is created. You can also retrieve the label `id` by calling `accounts.labels.list`.\n\nTo apply the label, make a `POST` request using the following URL and request\nbody: \n\n https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nt\"\u003ecssGroupId\u003c/span\u003e\u003c/var\u003e/csses/\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nt\"\u003ecssDomainId\u003c/span\u003e\u003c/var\u003e/updatelabels/\n\n {\n \"labelIds\": ['456'] // 'key-domains'\n }"]]
