Zarządzanie ustawieniami płatności

Funkcja płatności przyspiesza proces zakupu dla klientów, którzy są gotowi do zakupu, ponieważ umożliwia im przejście bezpośrednio z informacji o produktach w Google na stronę koszyka lub stronę płatności w Twojej witrynie. Może to zwiększyć współczynniki konwersji i ułatwić proces zakupu.

Za pomocą interfejsu Merchant API możesz zarządzać ustawieniami tej funkcji za pomocą zasobu CheckoutSettings.

Z tego przewodnika dowiesz się, jak za pomocą interfejsu Merchant API tworzyć i zarządzać rejestracją w usłudze płatności w sposób programowy.

Więcej informacji znajdziesz w artykule Dodawanie linku do płatności za produkty.

Wymagania wstępne

Aby korzystać z zasobu CheckoutSettings i powiązanych z nim metod, wykonaj te czynności:

  • Musisz uzyskać zgodę na wyświetlanie reklam produktowych, bezpłatnych informacji lub obu tych opcji.
  • Krajem sprzedaży musi być Stany Zjednoczone.

Metody

Aby utworzyć, pobrać, zaktualizować lub usunąć ustawienia płatności, możesz użyć jednej z tych metod:

Tworzenie ustawień płatności

Aby utworzyć ustawienie płatności, użyj metody checkoutSettings.create. W treści żądania uwzględnij parametr uri_settings z wartością checkout_uri_template lub cart_uri_template oraz wybrany parametr eligible_destinations.

Oto przykładowa prośba:

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"
  ]
}

Zastąp {ACCOUNT_ID} unikalnym identyfikatorem konta Merchant Center.

Oto przykład odpowiedzi po pomyślnym wywołaniu:

{
  "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"
}

Pobieranie ustawień płatności

Aby pobrać ustawienia płatności, w tym szablon URL, wybrane miejsca docelowe, stan rejestracji i stan sprawdzania adresu URL, użyj metody checkoutSettings.get.

Oto przykładowa prośba:

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

Oto przykład odpowiedzi po pomyślnym wywołaniu:

{
  "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"
}

Aktualizowanie ustawień procesu płatności

Aby zaktualizować ustawienia płatności, użyj metody checkoutSettings.update. W treści żądania uwzględnij pola, które chcesz zmienić, i określ je w parametrze zapytania update_mask.

update_mask obsługuje te pola:

  • eligible_destinations
  • uri_settings

Oto przykładowa prośba o zaktualizowanie adresu URL i usunięcie miejsca docelowego reklam:

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"
  ]
}

Oto przykład odpowiedzi po pomyślnym wywołaniu:

{
  "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"
}

Usuń

Aby usunąć ustawienia płatności, użyj metody checkoutSettings.delete.

Spowoduje to usunięcie konfiguracji na poziomie konta, rezygnację z programu płatności i zaprzestanie wyświetlania linków do płatności w bezpłatnych informacjach i reklamach produktowych.

Oto przykładowa prośba:

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

W przypadku powodzenia wywołania zwracana jest pusta treść odpowiedzi.

Adresy URL płatności dla produktów możesz podać na 2 sposoby:

  • Na poziomie konta (interfejs podrzędny API lub Merchant Center): aby zdefiniować pojedynczy szablon URL, czyli checkout_uri_template lub cart_uri_template, możesz użyć interfejsu podrzędnego API lub ustawień Merchant Center. Ten szablon jest stosowany do wszystkich kwalifikujących się produktów. Zalecamy stosowanie spójnych adresów URL w przypadku wszystkich produktów. Na przykład: yourstore.com/checkout?id={id}.

  • Na poziomie produktu (w pliku danych): aby podać konkretny adres URL płatności dla poszczególnych produktów, użyj atrybutu checkout_link_template w pliku danych o produktach. Dzięki temu możesz tworzyć niestandardowe adresy URL dla poszczególnych produktów lub oferować płatności tylko dla podzbioru swojego asortymentu.

  • Jeśli ustawisz szablon URL na poziomie konta za pomocą tego podrzędnego interfejsu API, nie przesyłaj wartości atrybutu checkout_link_template w pliku danych o tych produktach.

  • Jeśli używasz atrybutu pliku danych checkout_link_template, nie ustawiaj szablonu URL na poziomie konta za pomocą podrzędnego interfejsu API lub ustawień Merchant Center. Jeśli zarządzasz adresami URL tylko za pomocą pliku danych, nadal możesz używać podrzędnego interfejsu API do wybierania wartości eligible_destinations bez podawania wartości uri_settings.

Szablon URL płatności

Szablon adresu URL strony płatności pozwala umieścić adres URL strony płatności w danych produktów, dzięki czemu kupujący online mogą z Twoich informacji przejść bezpośrednio na stronę płatności. Musi zawierać zmienną {ID} i odpowiadającą domenę.

Podczas konfigurowania linków do płatności za pomocą podrzędnego interfejsu API użyj pola uri_settings. W tym polu możesz użyć jednego z 2 szablonów:

  • checkout_uri_template: szablon adresu URL, który po wypełnieniu miejsca zastępczego przekierowuje użytkownika na stronę płatności z określonym produktem gotowym do zakupu.
  • cart_uri_template: szablon adresu URL, który kieruje użytkownika na stronę koszyka z dodanym do niego konkretnym produktem.

Przykładowe szablony

  • Strona płatności: https://www.your-store.com/checkout?item_id={id}
  • Koszyk: https://shop.your-store.com/add_to_cart?product_sku={id}

Upewnij się, że spełniasz te wymagania:

  • Szablon adresu URL musi wskazywać prawidłową stronę w Twojej witrynie, która pasuje do Twojej zarejestrowanej domeny, działa za pomocą metody HTTP GET i nie wymaga logowania się klienta.
  • Domena z dostarczonego szablonu płatności musi być zgodna z domeną produktu.

Więcej informacji