비교 쇼핑 서비스 (CSS)는 CSS 프로그램이 제공되는 국가에서 판매자를 대신해 Google에 쇼핑 광고를 게재할 수 있습니다. Content API를 사용하면 CSS 도메인과 CSS 그룹이 라벨을 사용하여 연결된 계정을 정리할 수 있습니다. CSS 도메인은 도메인과 연결된 판매자 센터 계정을 나열하고, 라벨을 지정하고, 필터링할 수 있습니다. CSS 그룹은 그룹과 연결된 CSS 도메인에 라벨을 지정하고 이를 나열할 수 있습니다. 이러한 Content API 서비스는 Comparison Shopping Service Center에서 사용할 수 있는 일부 기능에 상응하는 프로그래매틱 기능을 제공합니다.
CSS 도메인은 판매자를 대신해 쇼핑 광고를 게재하는 CSS 자체의 계정입니다. 각 CSS 도메인은 하나의 CSS 그룹에만 속할 수 있습니다.
판매자 센터 계정은 CSS 도메인이 쇼핑 광고를 게재하는 판매자입니다. CSS는 멀티 클라이언트 계정 (MCA) 및 개별 판매자 계정을 비롯한 여러 유형의 판매자 센터 계정과 연결될 수 있습니다. 각 판매자 센터 계정은 하나의 CSS 도메인에만 연결할 수 있습니다. 다양한 유형의 Merchant Center 계정에 대한 자세한 내용은 Comparison Shopping Service Center의 계정 유형을 참고하세요.
CSS 라벨 유형
CSS는 두 가지 유형의 라벨을 사용합니다.
수동 라벨은 CSS 도메인이 판매자 센터 계정에, CSS 그룹이 CSS 도메인에 생성하고 할당합니다.
자동 라벨은 CSS 센터에서 자동으로 생성되어 판매자 센터 계정에 할당됩니다. 자동 라벨은 다양한 유형의 계정 측정항목에 사용할 수 있으며 중요한 계정 및 중요한 계정 활동을 식별하는 데 도움이 됩니다.
accounts.list: 각 계정에 적용된 라벨을 포함하여 CSS 도메인과 연결된 모든 판매자 센터 계정을 가져올 수 있습니다. 라벨 id로 필터링하여 연결된 계정의 하위 집합을 가져올 수도 있습니다. 예를 보려면 라벨을 사용하여 판매자 센터 계정 필터링을 참고하세요.
accounts.labels.create 메서드를 사용하여 새 라벨을 만들 수 있습니다. 라벨은 CSS 도메인 및 판매자 센터 계정에 적용할 수 있습니다. 하지만 계정 유형별 라벨은 별개이며 서로 바꿔서 사용할 수 없습니다. 도메인에 연결된 판매자 센터 계정에 적용할 수 있는 도메인 수준 라벨을 만들려면 라벨을 만들 때 CSS 도메인 ID를 accountId로 사용하세요. 그룹에 소속된 CSS 도메인에 적용할 수 있는 그룹 수준 라벨을 만들려면 라벨을 만들 때 CSS 그룹 ID를 accountId로 사용하세요.
다음 예에서는 도메인 수준 주요 계정 라벨을 만드는 방법을 보여줍니다. 이 라벨은 도메인과 연결된 Merchant Center 계정에 적용할 수 있습니다. 라벨을 만들려면 다음 URL과 요청 본문을 사용하여 POST 요청을 합니다.
CSS 도메인과 연결된 판매자 센터 계정에 라벨을 만들고 적용한 후 accounts.list 메서드를 사용하고 요청에 라벨 쿼리 매개변수를 전달하여 해당 라벨이 있는 계정만 반환할 수 있습니다. 다음 예에서는 라벨 만들기 예에서 만든 key-accounts 라벨의 id (123)를 사용하여 CSS 도메인과 연결된 판매자 센터 계정을 필터링하는 방법을 보여줍니다. 계정을 가져오려면 다음 URL을 사용하여 GET 요청을 수행합니다.
csses.updatelabels 메서드를 사용하여 CSS 그룹과 연결된 CSS 도메인에 라벨을 할당할 수도 있습니다. 다음 예시에서는 accounts.labels.create 메서드를 사용하여 만든 key-domains 그룹 수준 라벨을 가장 중요한 CSS 도메인 계정 중 하나에 적용하는 방법을 보여줍니다. CSS 도메인과 판매자 센터 계정의 라벨은 별개입니다. 그룹 수준 라벨은 CSS 그룹 ID를 accountId로 사용하여 만들어야 합니다.
[[["이해하기 쉬움","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(UTC)"],[[["\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 }"]]
