결제 설정 관리

결제 기능을 사용하면 구매할 준비가 된 고객이 Google 제품 등록정보에서 웹사이트의 장바구니 또는 결제 페이지로 바로 이동할 수 있으므로 구매 속도가 빨라져 전환율이 개선되고 쇼핑 환경이 원활해집니다.

Merchant API를 사용하면 CheckoutSettings 리소스를 사용하여 이 기능의 설정을 관리할 수 있습니다.

이 가이드에서는 Merchant API를 사용하여 결제 기능의 등록을 프로그래매틱 방식으로 생성하고 관리하는 방법을 설명합니다.

자세한 내용은 제품에 결제 링크 추가를 참고하세요.

기본 요건

CheckoutSettings 리소스 및 관련 메서드를 사용하려면 다음을 실행해야 합니다.

  • 쇼핑 광고, 무료 등록정보 또는 둘 다에 대해 승인을 받고 참여 중이어야 합니다.
  • 판매 국가가 미국이어야 합니다.

메서드

결제 설정을 생성, 검색, 업데이트, 삭제하려면 다음 메서드를 사용하면 됩니다.

결제 설정 만들기

결제 설정을 만들려면 checkoutSettings.create 메서드를 사용합니다. 요청 본문에 checkout_uri_template 또는 cart_uri_template와 함께 uri_settings 및 선택한 eligible_destinations를 포함합니다.

다음은 샘플 요청입니다.

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

{ACCOUNT_ID}를 판매자 센터 계정의 고유 식별자로 바꿉니다.

다음은 호출에 성공했을 때의 샘플 응답입니다.

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

결제 설정 가져오기

URL 템플릿, 선택한 대상, 등록 상태, URL 검토 상태를 비롯한 결제 설정을 검색하려면 checkoutSettings.get 메서드를 사용하세요.

다음은 샘플 요청입니다.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

다음은 호출에 성공했을 때의 샘플 응답입니다.

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

결제 설정 업데이트하기

결제 설정을 업데이트하려면 checkoutSettings.update 메서드를 사용합니다. 요청 본문에 변경하려는 필드를 포함하고 update_mask 쿼리 매개변수에 해당 필드를 지정합니다.

update_mask는 다음 필드를 지원합니다.

  • eligible_destinations
  • uri_settings

다음은 URL을 업데이트하고 광고 대상을 삭제하는 샘플 요청입니다.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

다음은 호출에 성공했을 때의 샘플 응답입니다.

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

삭제

결제 설정을 삭제하려면 checkoutSettings.delete 메서드를 사용합니다.

이렇게 하면 계정 수준 구성이 삭제되고 결제 프로그램에서 등록이 해제되며 무료 등록정보 및 쇼핑 광고의 제품에 결제 링크가 표시되지 않습니다.

다음은 샘플 요청입니다.

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

호출에 성공하면 빈 응답 본문이 반환됩니다.

제품의 결제 URL을 제공하는 방법에는 두 가지가 있습니다.

  • 계정 수준(하위 API 또는 판매자 센터): 단일 URL 템플릿(checkout_uri_template 또는 cart_uri_template)을 정의하려면 하위 API 또는 판매자 센터 설정을 사용하면 됩니다. 이 템플릿은 요건을 충족하는 모든 제품에 적용됩니다. 제품 전반에서 일관된 URL을 사용하는 것이 좋습니다. 예를 들면 다음과 같습니다. yourstore.com/checkout?id={id}

  • 제품 수준 (피드): 개별 제품에 특정 결제 URL을 제공하려면 제품 피드에서 checkout_link_template 속성을 사용하세요. 이렇게 하면 제품별로 URL을 맞춤설정하거나 인벤토리의 하위 집합에 대해서만 결제를 제공할 수 있습니다.

  • 이 하위 API를 사용하여 계정 수준 URL 템플릿을 설정하는 경우 해당 제품의 피드에 checkout_link_template 속성 값을 제출하지 않아야 합니다.

  • checkout_link_template 피드 속성을 사용하는 경우 하위 API 또는 판매자 센터 설정을 사용하여 계정 수준 URL 템플릿을 설정하지 마세요. 피드를 통해서만 URL을 관리하는 경우에도 하위 API를 사용하여 uri_settings를 제공하지 않고 eligible_destinations를 선택할 수 있습니다.

결제 URL 템플릿

결제 URL 템플릿을 사용하면 제품 데이터에 결제 URL을 포함하여 온라인 쇼핑객이 등록정보에서 결제 페이지로 바로 이동할 수 있습니다. {ID} 매개변수 자리표시자를 포함하고 일치하는 도메인이 있어야 합니다.

하위 API를 사용하여 결제 링크를 설정할 때는 uri_settings 필드를 사용하세요. 이 필드에는 다음 두 가지 템플릿 중 하나를 사용할 수 있습니다.

  • checkout_uri_template: 자리표시자가 채워지면 사용자를 구매할 준비가 된 특정 상품이 있는 결제 페이지로 안내하는 URL 템플릿입니다.
  • cart_uri_template: 장바구니에 특정 상품이 추가된 장바구니 페이지로 사용자를 안내하는 URL 템플릿입니다.

예시 템플릿

  • 결제: https://www.your-store.com/checkout?item_id={id}
  • 장바구니: https://shop.your-store.com/add_to_cart?product_sku={id}

다음 요구사항을 충족해야 합니다.

  • URL 템플릿은 등록된 도메인과 일치하고, HTTP GET 메서드를 사용하여 작동하며, 고객이 로그인할 필요가 없는 사이트의 유효한 페이지를 가리켜야 합니다.
  • 제공된 결제 템플릿의 도메인이 제품 도메인과 일치해야 합니다.

자세히 알아보기