비교 쇼핑 서비스 (CSS)는 CSS 프로그램이 제공되는 국가의 판매자를 대신해 Google에 쇼핑 광고를 게재할 수 있습니다. Content API를 사용하면 CSS 도메인과 CSS 그룹에서 라벨을 사용하여 연결된 계정을 구성할 수 있습니다. CSS 도메인은 도메인과 연결된 판매자 센터 계정을 나열, 라벨 지정, 필터링할 수 있습니다. CSS 그룹은 그룹과 연결된 CSS 도메인을 라벨로 지정하고 나열할 수 있습니다. 이러한 Content API 서비스는 비교 쇼핑 서비스 센터에서 제공되는 일부 기능과 동등한 프로그래매틱 방식을 제공합니다.
CSS에 관한 자세한 내용은 비교 쇼핑 서비스를 참고하세요. CSS Center에서 라벨 작업에 대한 자세한 내용은 Comparison Shopping Service Center에서 계정 라벨 사용을 참고하세요.
CSS 계정 유형
CSS는 다음 세 가지 유형의 계정을 사용합니다.
- CSS 그룹은 하나 이상의 CSS 도메인을 포함할 수 있는 최상위 계정입니다.
- CSS 도메인은 판매자를 대신하여 쇼핑 광고를 게재하는 CSS 자체의 계정입니다. 각 CSS 도메인은 하나의 CSS 그룹에만 속할 수 있습니다.
- 판매자 센터 계정은 CSS 도메인에서 쇼핑 광고를 게재하는 판매자입니다. CSS는 멀티 클라이언트 계정 (MCA) 및 개별 판매자 계정을 포함하여 다양한 유형의 판매자 센터 계정과 연결할 수 있습니다. 각 판매자 센터 계정은 하나의 CSS 도메인에만 연결할 수 있습니다. 다양한 유형의 판매자 센터 계정에 관한 자세한 내용은 Comparison Shopping Service Center의 계정 유형을 참고하세요.
CSS 라벨 유형
CSS에서는 두 가지 유형의 라벨을 사용합니다.
- 수동 라벨은 CSS 도메인별로 판매자 센터 계정에 생성되고 CSS 그룹별로 CSS 도메인에 할당됩니다.
- 자동 라벨은 CSS Center에서 자동으로 생성되고 판매자 센터 계정에 할당됩니다. 자동 라벨은 다양한 유형의 계정 측정항목에 사용할 수 있으며 중요한 계정과 계정 활동을 식별하는 데 도움이 됩니다.
사용 가능한 자동 라벨을 포함한 라벨 유형에 대한 자세한 내용은 Comparison Shopping Service Center에서 계정 라벨 사용을 참고하세요.
CSS를 위한 Content API 기능 및 엔드포인트
Content API는 CSS에 다음과 같은 엔드포인트를 제공합니다.
accounts.labels: CSS 도메인 및 판매자 센터 계정에 적용할 라벨을 생성, 검색, 수정할 수 있습니다. 예시는 라벨 만들기를 참조하세요.accounts.updatelabels: 단일 판매자 센터 계정에 라벨을 적용할 수 있습니다. 예시는 판매자 센터 계정에 라벨 적용하기를 참조하세요.accounts.list: 각 계정에 적용된 라벨을 포함하여 CSS 도메인과 연결된 모든 판매자 센터 계정을 검색할 수 있습니다.id라벨로 필터링하여 연결된 계정의 하위 집합을 검색할 수도 있습니다. 예시는 라벨을 사용하여 판매자 센터 계정 필터링을 참조하세요.accounts.get: 단일 판매자 센터 계정에 적용된 라벨을 검색할 수 있습니다.csses: 라벨과 CSS 도메인 간의 연결을 보고 관리할 수 있습니다. 예시를 보려면 CSS 도메인에 라벨 적용을 참조하세요.
accounts 엔드포인트를 CSS 도메인으로 호출하는 경우 다음 요구사항에 유의하세요.
- CSS 도메인은
merchantId대신cssId를 제공해야 합니다. - CSS 도메인은
view=CSS의 쿼리 매개변수를 제공해야 합니다. - CSS 도메인은 연결된 판매자 센터 계정 ID를
accountId로 제공해야 합니다.
예: 라벨 만들기
accounts.labels.create 메서드를 사용하여 새 라벨을 만들 수 있습니다. 라벨은 CSS 도메인 및 판매자 센터 계정에 적용할 수 있습니다. 그러나 여러 계정 유형의 라벨은 별개이며 서로 바꿔서 사용할 수 없습니다. 도메인과 연결된 판매자 센터 계정에 적용할 수 있는 도메인 수준 라벨을 만들려면 라벨을 만들 때 CSS 도메인 ID를 accountId로 사용합니다. 그룹과 연결된 CSS 도메인에 적용할 수 있는 그룹 수준 라벨을 만들려면 라벨을 만들 때 CSS 그룹 ID를 accountId로 사용합니다.
다음 예시는 도메인과 연결된 판매자 센터 계정에 적용할 수 있는 도메인 수준 키 계정 라벨을 만드는 방법을 보여줍니다. 라벨을 만들려면 다음 URL과 요청 본문을 사용하여 POST 요청을 수행합니다.
https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels
{
"name": "key-accounts",
"description": "All accounts with over a million products"
}
예: 판매자 센터 계정에 라벨 적용하기
accounts.updatelabels 메서드를 사용하여 CSS 도메인과 연결된 판매자 센터 계정에 라벨을 할당할 수 있습니다. 다음 예에서는 이전 예에서 만든 키 계정 라벨을 가장 중요한 판매자 센터 계정 중 하나에 적용하는 방법을 보여줍니다.
라벨을 적용하려면 다음 URL과 요청 본문을 사용하여 POST 요청을 수행합니다.
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
"labelIds": [‘123’] // ‘key-accounts’
}
예: 라벨을 사용하여 판매자 센터 계정 필터링
라벨을 만들고 CSS 도메인과 연결된 판매자 센터 계정에 적용한 후 accounts.list 메서드를 사용하고 요청에 라벨 쿼리 매개변수를 전달하여 해당 라벨이 있는 계정만 반환할 수 있습니다. 다음 예시는 라벨 만들기 예시에서 만든 키 계정 라벨의 id (123)를 사용하여 CSS 도메인에 연결된 판매자 센터 계정을 필터링하는 방법을 보여줍니다. 계정을 검색하려면 다음 URL을 사용하여 GET 요청을 실행합니다.
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
요청 본문은 필요하지 않습니다.
예: CSS 도메인에 라벨 적용하기
csses.updatelabels 메서드를 사용하여 CSS 그룹과 연결된 CSS 도메인에 라벨을 할당할 수도 있습니다. 다음 예에서는 accounts.labels.create 메서드를 사용하여 만든 키-도메인 그룹 수준 라벨을 가장 중요한 CSS 도메인 계정 중 하나에 적용하는 방법을 보여줍니다. CSS 도메인과 판매자 센터 계정의 라벨은 별개라는 점에 유의하세요. 그룹 수준 라벨은 CSS 그룹 ID를 accountId로 사용하여 만들어야 합니다.
라벨을 적용하려면 다음 URL과 요청 본문을 사용하여 POST 요청을 수행합니다.
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}