Debes tener una cuenta de Merchant Center para usar la API de Merchant. Puedes usar la IU de Merchant Center para crearla.
Si necesitas administrar varias cuentas, puedes crear cuentas secundarias con Merchant API.
Puedes configurar tu cuenta en la IU de Merchant Center o a través de la API, como se describe más adelante.
Acepta las Condiciones del Servicio de Merchant Center
Todos los comercios deben aceptar las Condiciones del Servicio de Merchant Center. A continuación, te mostramos cómo aceptar las Condiciones del Servicio de tu propia cuenta de comerciante:
Llama a
accounts.termsOfServiceAgreementStates.retrieveForApplication
para obtener información sobre qué Condiciones del Servicio son obligatorias para tu cuenta.Esta es una solicitud de ejemplo:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates:retrieveForApplication
Esta es una respuesta de ejemplo de una llamada correcta:
{ "name": "accounts/{ACCOUNT_ID}/termsOfServiceAgreementStates/MERCHANT_CENTER-{COUNTRY}", "regionCode": {COUNTRY}, "termsOfServiceKind": "MERCHANT_CENTER", "accepted": { "termsOfService": "termsOfService/{VERSION}", "acceptedBy": "accounts/{ACCOUNT_ID}" } }
Llama a
termsOfService.accept
para aceptar las Condiciones del Servicio.Esta es una solicitud de ejemplo:
GET https://merchantapi.googleapis.com/accounts/v1beta/{name=termsOfService/{VERSION}}:accept
Si se ejecuta correctamente, el cuerpo de la respuesta estará vacío.
Te recomendamos que crees una IU en la que muestres las condiciones del servicio al comercio y le pidas que las acepte.
Busca los Términos del Servicio que el comercio debe aceptar con
termsOfService.retrieveLatest
con elregionCode
de la empresa.Esta es una solicitud de ejemplo:
GET https://merchantapi.googleapis.com/accounts/v1beta/termsOfService:retrieveLatest
Esta es una respuesta de ejemplo de una llamada correcta:
{ "name": "termsOfService/{VERSION}", "regionCode": "{COUNTRY}", "kind": "MERCHANT_CENTER", "fileUri": "{URI}" }
Muestra los Términos del Servicio de
fileUri
al comercio.Cuando el comercio acepte las Condiciones del Servicio en tu IU, llama a
termsOfService.accept
con elname
de las Condiciones del Servicio para aceptarlas.
Después de que el comercio acepte las Condiciones del Servicio, puedes usar la API de Merchant para configurar el resto de la información de su cuenta. Para obtener detalles sobre la información de la cuenta que puedes administrar con la API de Merchant Accounts, consulta el recurso Account
.
Reclame su sitio web
Puedes usar la API de Merchant Accounts para agregar y reclamar el Homepage
de tu empresa.
- Para agregar una página principal a tu cuenta, llama a
accounts.updateHomepage
con un recursoHomepage
que contenga la URL de tu página principal. - Para reclamar la propiedad de la página principal, llama a
accounts.homepage.claim
con elname
de tu recursoHompeage
.
No puedes usar la API de Merchant para verificar tu página principal. Para obtener más información, consulta Cómo verificar y reclamar el sitio web de tu tienda.
Actualiza los detalles de tu empresa
Puedes usar la API de Merchant Accounts para editar tu empresa PostalAddress
, CusomerService
y BusinessIdentity
.
Identidad de la empresa:
- Para ver la identidad de tu empresa, llama a
accounts.businessIdentity.getBusinessIdentity
. - Para editar la identidad de tu empresa, llama a
accounts.businessIdentity.updateBusinessIdentity
.
¿Qué sigue?
- Obtén información para crear y administrar cuentas secundarias.
- Para comprender cómo funcionan las relaciones entre las cuentas de comerciante, consulta Relaciones entre cuentas.