판매자 센터 계정 준비

계정에 무료 등록정보를 위한 정상적인 판매자 센터 계정과 승인된 제품이 있어야 합니다. 시작하려면 다음 고객센터 도움말을 참고하세요.

제품으로 판매자 센터를 설정한 후 API 통합을 빌드하기 전에 이 섹션의 요구사항을 완료해야 합니다.

1. 판매자 센터 설정

Google 판매자 센터 계정에서 다음 설정이 구성되어 있는지 확인합니다.

1.1. 반품 정책

판매자 센터에서 반품 정책을 정의해야 합니다. 이는 기록상의 판매자 요구사항이며 결제 화면에서 참조됩니다. 구성된 정책은 계정에 전역으로 적용되지만 return_policy_label 피드 속성을 사용하여 특정 반품 정책을 일부 제품으로 제한할 수 있습니다.

판매자 센터 계정이 고급 계정인 경우 각 하위 계정에서 반품 정책을 구성해야 합니다.

반품 비용, 반품 속도 (기간), 전체 정책 링크를 포함해야 합니다. 여기에서 반품 구성에 대해 자세히 알아보세요.

1.2. 고객 지원 정보

판매자 센터에서 고객 지원 정보를 설정해야 합니다. 주문 확인 페이지에서 '판매자에게 문의' 링크를 생성하는 데 사용됩니다. 여기에서 고객 지원 정보 설정에 대해 자세히 알아보세요.

2. 제품 데이터

제품 피드를 업데이트하여 자격 요건을 알리고 규정 준수 데이터를 제공해야 합니다. 이 정보는 상담사가 제품 자격을 확인하고, 정확한 총비용을 계산하고, 사용자에게 필수 법적 경고를 표시할 수 있으므로 Google을 통해 UCP에서 결제를 사용 설정하는 데 필요합니다.

2.1. 에이전트형 결제 경험 자격 요건

이렇게 하면 제품이 Google의 결제 환경에 포함됩니다.

단일 불리언을 포함하는 제품 속성 native_commerce를 사용하여 제공됩니다. false로 설정하거나 누락된 경우 제품의 결제가 승인되지 않습니다.

2.2. 제품 경고

규제 경고 요구사항이 있는 상품 (예: 캘리포니아 Proposition 65)를 준수해야 합니다. 제품 경고 요구사항을 비롯한 모든 관련 법규를 준수할 책임은 사용자에게 있습니다. 이러한 경고는 제공 시 결제 화면에 눈에 띄게 표시됩니다.

다음 두 하위 속성을 사용하여 consumer_notice 속성 그룹을 제공합니다.

  • consumer_notice_type: legal_disclaimer, safety_warning, prop_65 중 하나여야 합니다.
  • consumer_notice_message: 문자열 (최대 1,000자) HTML 태그 <b>, <br>, <i>가 허용됩니다.

2.3. 제품 식별자

제품 피드의 id는 결제 API에서 예상하는 제품 ID와 일치해야 합니다. 일치하는 경우 별도의 조치가 필요하지 않습니다. 그렇지 않으면 merchant_item_id 맞춤 속성을 사용하여 매핑합니다.

2.4. 제품에 속성을 추가하는 방법

다음 예에서는 제품을 판매자 센터에 제공하는 다양한 옵션을 설명합니다.

2.4.1. 피드

보조 데이터 소스를 만드는 것이 좋습니다 (안내 보기). 기본 피드에 이를 추가할 수 있습니다. 하지만 형식이 잘못되면 일반 제품 수집에 영향을 미칠 수 있으므로 주의하세요.

구문 관련 참고사항: 복잡한 문자열 (예: Prop 65 메시지)에 파일 형식을 깨는 문자가 포함되지 않도록 합니다 (예: CSV의 추가 쉼표). 단, 올바르게 이스케이프된 경우는 예외입니다.

텍스트 파일 형식:

ID native_commerce consumer_notice
11111 TRUE prop_65:This product can expose you...
22222 TRUE
33333 FALSE

XML 형식:

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. Content API

속성을 맞춤 속성으로 제공합니다. products.update에서는 customAttributes 업데이트를 지원하지 않으므로 전체 제품이 포함된 products.insert에 포함되어야 합니다.

예:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. Merchant API

속성을 맞춤 속성으로 제공합니다. 기존 accounts.productInputs.insert에 추가하거나 accounts.productInputs.patch를 사용하여 직접 업데이트할 수 있습니다.

insert의 예:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

update의 예:

유형 이름
경로 매개변수 productInput.name accounts/{account}/productInputs/en~US~11111
쿼리 매개변수 updateMask customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id
dataSource dataSources/{datasource}
{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. 제품 제한사항

다음 카테고리의 제품은 결제할 수 없습니다. 이러한 항목의 native_commerce가 비어 있거나 false로 설정되어 있는지 확인합니다.

금융 상품 및 정기 결제 모델

  • 정기 결제: 반복 결제 주기가 필요한 제품입니다.
  • 할부: 판매자가 의무적으로 지정한 결제 계획 또는 금융이 필요한 거래입니다.

맞춤 제품 및 주문 처리 옵션

  • 맞춤 상품: 맞춤 디자인 결정이 필요한 상품 (예: 각인, 모노그램)
  • 새 상품이 아닌 상품 또는 파이널 세일 상품: 리퍼 상품, 중고 상품, '파이널 세일'로 표시된 상품(반품 불가)
  • 선주문 상품: 출시일이 미래이고 이행이 지연된 제품입니다.
  • 번들 서비스: 보증, 설치 또는 설정과 같이 추가 계약이 필요한 항목입니다.
  • 특별 배송: 비표준 배송비 (예: 화물, 프리미엄 배송)가 필요한 상품
  • 선물: 수신자를 위해 인보이스 분할 물류 또는 숨겨진 가격이 필요한 거래
  • 매장 내 활성화: 소매업체 위치에서 물리적으로 활성화해야 하는 제품입니다.

정책 및 안전 제한사항

  • 연령 제한: 신분증 확인이 필요한 상품 (예: 주류, 담배)
  • 금지된 콘텐츠: 무기, 성인용 콘텐츠, 의료/제약, 위조품 또는 표준 Google 쇼핑 정책에 의해 차단된 기타 카테고리

디지털 상품 및 서비스

  • 서비스: 레슨, 온라인 수업, 여행 패키지 (특정 여행 레일을 사용하여 통합되지 않은 경우).
  • 대여: 영화 대여, 장비 대여 또는 임대
  • 가상 상품: 인게임 화폐, MMORPG 상품 또는 스킨
  • 소프트웨어 종속 항목: 사용자가 구매를 완료하기 전에 특정 소프트웨어를 설치해야 하는 상품입니다.